Microsoft Azure Runbook

Allmän info om att använda Microsoft Azure

Designen på Office365-Scoutnet-synk är att modulen är tänkt att köras ifrån en runbook i Microsoft Azure. Modulen har stöd för ManagedIdentity vilket är en förutsättning för att kunna automatisera i Microsoft Azure.

För att använda Microsoft Azure måste en Subscription finnas. Microsoft Azure Sponsorship Subscription ingår när man får Microsoft Office 365 non-profit.

Azure gratiskonto kan troligtvis också användas, då det ingår 500 minuter Azure Automation.

Generella inställningar

I non-profit-portalen aktiverar du scoutkårens Microsoft Azure Sponsorship Subscription och logga in på Azure online med en användare som är "domänadmin".

För att köra en runbook så behövs en Azure Automation Resource group med ett Azure Automation Account i som innehåller ett Runtime Environment med de moduler som behövs. ManagedIdentity måste även konfigureras i Azure Automation Account.

För att skapa de här resurserna så använd setupAzure.ps1 på din dator. Skriptet skapar resurserna som behövs men inte själva runbooken.

Köra setupAzure.ps1

Förutsättningar

1. Skapa konto i Microsoft Azure.

   1. Var noga med att använda en Domain admin så att du kan dela ut rättigheter till andra användare i domänen senare.
   2. Koppla en subscription till domänens Microsoft Azure.
   3. Gå in på Microsoft Azure Sponsorship Subscription och följ instruktionerna.

2. I Scoutnet hämta API nycklarna för api/group/customlists samt api/group/memberlist som på sidan Webbkoppling. Skriptet kommer fråga efter de när det körs.

3. Installera PowerShell 7.6

4. Installera modulerna Az.Accounts, Az.Resources, Az.Automation och Microsoft.Graph.

   Install-Module -Name Az.Accounts, Az.Resources, Az.Automation `
       -Repository PSGallery -Scope CurrentUser
   Install-Module -Name Microsoft.Graph -Repository PSGallery -Scope CurrentUser

När det här är klart kan skriptet köras.

När det loggar in mot Azure ska du välja en användare som är "domänadmin".

Azure Automation Resource group, Azure Automation Account och placering kan anges som parametrar. Om de utelämnas används Scoutnet-sync för konto och resursgrupp samt swedencentral som placering.

Exempel utan parametrar

.\setupAzure.ps1

Exempel med parametrar

.\setupAzure.ps1 `
    -accountName 'Scoutnet-sync' `
    -rgName 'Scoutnet-sync' `
    -location 'swedencentral'

Tekniska förtydliganden

Skriptet använder Azure Automation REST API via Invoke-AzRestMethod för att skapa Runtime Environment och installera dess paket. Graph-modulerna, ExchangeOnlineManagement och Office365-Scoutnet-synk läggs i miljön. Standardpaketen anges uttryckligen till Az 15.1.0 och Azure CLI 2.77.0.

Skapa och köra en runbook i Microsoft Azure

1. I Azure automation skapa runbooken MaillistSynk för synkroniseringen. Typen ska vara PowerShell och Runtime Environment PowerShell-7.6-Office365-Scoutnet-synk.

2. Kopiera koden från exemplet:

   MaillistSynk.ps1

3. Ändra inställningarna så att de matchar scoutkårens Scoutnetprofil och Office 365. T.ex vilka listor som ska uppdateras. Se manualen för information.

4. Prova att köra MaillistSynk.

5. När MaillistSynk fungerar publicera runbooken.

6. Azure automation under Shared Resources, skapa en schedule för att regelbundet köra MaillistSynk.

   1. Rekommendationen är att köra nattetid (kl 3 eller 4), då det kan ta en stund att köra MaillistSynk.