Microsoft Azure konfiguration for Miralix Teams CC Presence (Dansk)

Forord

Denne vejledning er for teknikere som skal installere Miralix Teams CC Presence.

Teknikeren bør have uddannelse som IT Supporter, eller have tilsvarende kvalifikationer. Derudover have relevant kendskab til Microsoft Teams, Microsoft SQL Server, Microsoft Entra ID, Microsoft Office 365

Miralix Teams Presence understøtter multiple Teams miljøer.

Miralix Teams Presence indsamler status visning fra Microsoft Teams, så Miralix klienter kan vise Microsoft Teams status på interne kontaktpersoner. Miralix Teams Presence servicens indstillinger, konfigureres med Miralix Wrench under fanen ”Microsoft Teams Presence”, se evt. brugervejledningen for Miralix Wrench.

Miralix Teams Presence kan sætte ”In a Call” ind på Miralix brugeres Teams status, når enten brugerens mobil- eller arbejdstelefon er optaget. se evt. brugervejledningen for Miralix Wrench.

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 at Miralix som udgangspunkt ikke har forpligtelser vedrørende denne datalagring.

Forudsætninger for Miralix Teams Presence

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

Microsoft Office 365 / Microsoft Azure

Oprettelse af App registrering via Azure portal

Obs! Dette kræver administratorrettigheder.

Oprettelse af Azure App adgang

Log ind på Azure Portal »  Se figur 1

Figur 1

App Registration til Miralix Teams Presence i Azure portal

1. Log ind på Azure Portal » med administrator konto (Se guiden Register a new application using the Azure portal »). Se Figur 2. Husk at vælge korrekt tenant (Hvor Miralix Teams Presence skal have adgang), hvis administrator kontoen har adgang til flere Microsoft Entra ID tenants. Dette gøres ved at vælge den korrekte konto øverst til højre.

Figur 2

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

Figur 3

1. For at Miralix Teams Presence kan logge ind og hente Microsoft Teams status, 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 Teams Presence"

Supported account types- "Single tenant only - MRXLAB”

Figur 4

1. Klik på “register”

Tildeling af rettigheder til Miralix Teams Presence (App registration)

Der skal tildeles rettigheder til Miralix Teams Presence, for at der kan hentes Microsoft Teams status ud. De rettigheder der skal gives er:

• Presence.Read.All - Read presence information of all users in your organization

• User.ReadBasic.All- Read all users' basic profiles

1. Klik på ”API permissions”.

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

Figur 5

1. Vælg "Application permissions" og søg efter de rettigheder som der er brug for og markér dem: se figur 6.

• Presence.Read.All

• User.ReadBasic.All

Figur 6

Grant admin consent

Obs! rettighederne kræver "Grant admin consent for ...", før rettighederne bliver tildelt.

Se figur 7.

1. klik på ”Grant admin consent for …”

2. klik herefter på ”yes”

Figur 7

Herefter skrives der "Successfully granted admin consent for the requested permissions". Se figur 8.

Figur 8

Hent client og tenant ID

Client og tenant ID skal bruges til konfigurationen af Miralix Teams Presence i Miralix Wrench. Derfor er det en god ide at gemme disse i et dokument, indtil installationen er gennemført.

1. Klik på ”Overview”

2. Kopier ”Application (client) ID” og ”Directory (tenant) ID” og sæt dem ind i et dokument. Se figur 9.

Figur 9

Sæt ”In a Call” Teams status baseret på mobil og arbejdstelefon optaget status

Hvis der modtages mobil eller arbejdstelefon status på Miralix brugere, kan der sættes en ”In a Call” status på Miralix brugerens Microsoft Teams konto, når Miralix brugerens mobil eller arbejdstelefon er optaget. For at kunne bruge denne funktion skal der tilføjes/ændres en API tilladelse på appregistreringen.

Det kan aktiveres for kun mobil status, kun arbejdsttelefon status eller begge. Se evt. brugervejledningen for Miralix Wrench.

Konfigurering af App registrerings tilladelser i azure

Der skal tildeles yderligere rettigheder til Miralix Teams Presence, for at der kan sættes status for Teams brugere. Den rettighed der skal gives er:

Der kan fjernes Presence.Read.All, da Presence.ReadWrite.All også indeholder de samme rettigheder og mere til.

• Presence.ReadWrite.All - Read and write presence information for all users

1. Klik på ”API permissions”.

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

3. Vælg "Application permissions" og søg efter de rettigheder som der er brug for og markér dem, se også figur 10.

• Presence.ReadWrite.All

Figur 10

Grant admin consent

Obs! rettigheden ” Presence.ReadWrite.All” kræver "Grant admin consent for ...", før rettigheden bliver tildelt. Se figur 11.

1. klik på ”Grant admin consent for …”

2. klik herefter på ”yes”

Figur 11

Konfigurering af App registrerings klient secrets i azure

For at Miralix Teams presence kan læse og/eller sætte status på Teams brugere skal der oprettes en ”Client secret” til appregistreringen i Azure.

1. Klik på ”Certificates & secrets” under App registreringen til Miralix Teams presence.

2. Klik på ”+ New client secret” under Client secrets (0)

3. Angiv en beskrivelse og vælg hvornår denne secret skal udløbe. Og tryk på ”Add” Se figur 12.

   

Figur 12

Gem Secret værdien, dette skal bruges til konfigurering i Miralix Wrench Se figur 13.

Figur 13

Fortsæt installation af Miralix Teams presence i Miralix Wrench.

Installation af Miralix Teams presence

Der er nu oprettet de nødvendige forudsætninger for at Miralix Teams Presence kan installeres.

Kontakt venligst Miralix for at få udført installationen.