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 ).
-
Log ind på Azure Portal (https://portal.azure.com/ ) med en administrator bruger.
Se figur 1.
Figur 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.
Figur 2
-
Klik på "App registrations", se figur 3. Hvis "Microsoft Entra ID" ikke vises, klikkes der på ”More services”.
Figur 3
-
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)”
Figur 4
-
Klik på “register”.
-
Det er nu muligt at se og kopiere Client ID fra ”Application (client) ID” under Overview, Se figur 5.
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
-
Åben den App Registration der er oprettet til Miralix Graph Calendar Import
-
Klik på ”API permissions”.
-
Klik på ”Add a permission” og vælg "Microsoft Graph", se figur 6.
Figur 6
-
Vælg "Delegated permissions" og søg efter User.Read rettigheden og markér den. Se figur 7.
Figur 7
-
Vælg ”Application permissons” og søg efter User.Read.All og Calendars.Read rettighederne og markér dem. Se figur 8 og 9.
Figur 8
Figur 9
-
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.
-
Klik på ""Grant admin consent for ..." og klik ”Yes” for at give admin consent til alle rettigheder, Se figur 10.
Figur 10
-
Herefter vil der stå "Granted for …" ud for hver permission, Se figur 11.
Figur 11
Oprettelse af Secret
Der skal oprettes en Client Secret for denne app permission, for at Miralix Calendar Import kan logge ind.
-
Åben den App Registration der er oprettet til Miralix Graph Calendar Import
-
Klik på ” Certificates & secrets”.
-
Under Client secrets, klik på ”New client secret”
-
Indtast en beskrivelse og vælg en udløbsdato, Se figur 12.
Figur 12
-
Klik på “Add”
-
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.