Microsoft Azure konfiguration for Miralix Calendar Import (Dansk)

Forord

Denne vejledning er for teknikere som skal installere Miralix Calendar Import. Teknikeren bør have uddannelse som IT Supporter, eller have tilsvarende kvalifikationer. Derudover have relevant kendskab til Microsoft Azure, Microsoft Office 365 og Microsoft Active Directory.

Miralix Calendar Import indsamler kalender aftaler fra Microsoft Office 365, så Miralix klienter kan vise kalender aftaler på interne kontaktpersoner.

GDPR- Persondataforordningen

General Data Protection Regulation (GDPR), eller persondataforordningen som det typisk kaldes i Danmark, gør at kunder der får installeret Miralix software, skal tage stilling til omfanget og varighed af datalagring. Alle Miralix kunder tilbydes en databehandler aftale, idet Miralix som udgangspunkt ikke har forpligtelser vedrørende denne datalagring.

Forudsætninger for Miralix Calendar Import

For at Miralix Calendar Import Service kan fungere er der nogle forudsætninger som skal være på plads.

Microsoft Entra ID App Registration

Der skal være oprettet en App registration til Miralix Calendar Import:

Denne App registration skal havde følgende API permissions:

  • Application – Calendars.Read

  • Delegated – User.Read

  • Application – User.Read.All

Dette er nødvendigt for at Miralix Calendar Import kan lave udtræk fra Microsoft Office 365.

Oprettelse af App Registration i Microsoft Entra ID

(Se evt. guiden Register a new application using the Azure portal » https://docs.microsoft.com/en-us/graph/auth-register-app-v2 ).

  1. Log ind på Azure Portal (https://portal.azure.com/ ) med en administrator bruger.

Se figur 1.

att_12_for_28147760.png

Figur 1


  1. Klik på "Microsoft Entra ID". Det er muligt at se og kopiere Tenant ID fra boksen ”Tenant information” under Overview. Se figur 2.

Husk at vælge korrekt tenant (Hvor Miralix Calendar Import skal have adgang). Der kan vælges en anden tenant ved at klikke på ”Switch tenant” og derefter vælge den korrekte konto.

att_8_for_28147760.png

Figur 2


  1. Klik på "App registrations", se figur 3. Hvis "Microsoft Entra ID" ikke vises, klikkes der på ”More services”.

att_9_for_28147760.png

Figur 3


  1. For at Miralix Calendar kan hente kalender opdateringer, skal der registers en ny applikation. Klik på "New registration", indtast et navn og vælg supporterede konto typer som kan bruges.

I eksemplet i figur 4 er følgende valgt:

Name: "Miralix Graph Calendar Import"
Supported account types: " Accounts in this organizational directory only (Miralix only - Single tenant)”

att_7_for_28147760.png

Figur 4


  1. Klik på “register”.

  1. Det er nu muligt at se og kopiere Client ID fra ”Application (client) ID” under Overview, Se figur 5.

att_11_for_28147760.png

Figur 5

Tildeling af rettigheder til Miralix Calendar Import

Der skal tildeles rettigheder til Miralix Calendar Import, for at der kan laves udtræk fra Microsoft Office 365.

De rettigheder der skal gives er:

  • Application – Calendars.Read

  • Delegated – User.Read

  • Application – User.Read.All


  1. Åben den App Registration der er oprettet til Miralix Graph Calendar Import

  2. Klik på ”API permissions”.

  3. Klik på ”Add a permission” og vælg "Microsoft Graph", se figur 6.

att_10_for_28147760.png

Figur 6


  1. Vælg "Delegated permissions" og søg efter User.Read rettigheden og markér den. Se figur 7.

att_3_for_28147760.png

Figur 7


  1. Vælg ”Application permissons” og søg efter User.Read.All og Calendars.Read rettighederne og markér dem. Se figur 8 og 9.

att_4_for_28147760.png

Figur 8

att_5_for_28147760.png

Figur 9

  1. Klik på ”Add permissions”.

Obs! Rettighederne User.Read.All og Calendars.Read kræver "Grant admin consent for ...", for at Miralix Calendar Import kan bruge dem korrekt.

  1. Klik på ""Grant admin consent for ..." og klik ”Yes” for at give admin consent til alle rettigheder, Se figur 10.

att_1_for_28147760.png

Figur 10

  1. Herefter vil der stå "Granted for …" ud for hver permission, Se figur 11.

att_6_for_28147760.png

Figur 11

Oprettelse af Secret

Der skal oprettes en Client Secret for denne app permission, for at Miralix Calendar Import kan logge ind.

  1. Åben den App Registration der er oprettet til Miralix Graph Calendar Import

  2. Klik på ” Certificates & secrets”.

  3. Under Client secrets, klik på ”New client secret”

  4. Indtast en beskrivelse og vælg en udløbsdato, Se figur 12.

image-20230615-130505.png

Figur 12

  1. Klik på “Add”

  1. Husk at kopiere value og evt. gemme den et sikkert sted, da denne Client Secret kun vil blive vist denne ene gang.

Obs! Mistes denne Client Secret, så er det muligt at oprette en ny og opdatere Client Secret for Calendar Sync Source i Wrench.

Installation af Miralix Calendar Import

Der er nu oprettet de nødvendige forudsætninger for at Miralix Calendar Import, kan installeres. Kontakt venligst Miralix for at få udført installationen.