EntraID/AzureAD Enterprise-applikationsintegration via Microsoft Graph API (SSO/O365/SCIM/kalenderintegration) (BETA)
Microsoft Graph API
Denne artikel beskriver, hvordan du konfigurerer GoBright integration med Microsoft Graph API.
Denne mulighed er stadig i Early Access. Du kan få adgang ved at anmode om adgang via en anmodning om at få denne mulighed aktiveret.
Hvad er forskellen mellem fuld Graph API-integration og tidligere integration:
- Fuld udnyttelse af Microsoft Graph API
- Hvis fuld identitetskopi er aktiveret, er det ikke længere nødvendigt med fulde mailboksrettigheder! Det er kun nødvendigt med fulde kalenderrettigheder.
Det er stadig muligt at begrænse de fulde tilladelser, så GoBright får tilladelse til ressourcekalenderne (se trin 4 i denne artikel).
Har du allerede en integration, skal du læse artiklen om migration: Skift til Microsoft Graph API-integration
Hvis både brugerne og/eller ressourcerne er tilgængelige i EntraID / AzureAD, anbefales det stærkt at inkludere GoBright en virksomhedsapplikation. Der er flere grunde til at gøre dette:
Hvorfor du bør overveje at tilføje GoBright EntraID / Azure AD
-
Applikationen kan bruges til at opsætte integrationen af værelsesbooking
-
Applikationen kan bruges til at synkronisere brugere fra EntraID/Azure AD, når SCIM User Provisioning er sat op.
-
Håndtering af brugere, der kan logge ind på GoBright med Microsoft Single Sign-On
-
Der kræves ingen yderligere konfiguration eller scripting
Ved at bruge denne virksomhedsapplikation kan du nemt oprette en forbindelse, herunder SSO, samtidig med at du får kontrol over, hvem der har lov til at bruge applikationen.
Trin 1 Office365-integration til SSO
Oprettelse af Office 365-applikationsintegration
Når du er logget ind på GoBright med den oprindelige administratorkonto, kan du trykke på de fire firkanter i øverste højre hjørne og vælge Admin Center.
Du skal gå til Integrationer og trykke på den blå knap Tilføj øverst til højre.
Her præsenteres du for et par muligheder, som du kan vælge afhængigt af det eksterne system, du har brug for at integrere med GoBright.
I dit tilfælde er det eksterne system Office 365.
Denne indstilling er stadig i betaversion, så Microsoft Graph API skal først aktiveres for dit GoBright i backend, ellers vil denne indstilling ikke være synlig.
Det kan du gøre ved at sende os en anmodning om at få denne mulighed aktiveret.
Når du har markeret dette afkrydsningsfelt, vises en pop op-meddelelse, hvor du bliver bedt om at gemme ændringerne, før Microsoft Graph API-integrationen finder sted.
Du kan nu forbinde O365-tenant ved at klikke på den grønne knap "Forbind (tenant)", hvilket vil give os en prompt til at logge ind med en Microsoft-konto.
Til dette skal du bruge en global administratorkonto for Azure/Entra ID.
Når du er logget ind, udløses en anden prompt, der anmoder om tilladelser.
Tilladelserne er til GoBright SSO-applikationen, som giver brugerne mulighed for at godkende og logge ind ved hjælp af deres O365-konti.
Når den er accepteret, oprettes Enterprise-applikationen, og du kommer tilbage til GoBright med lejerstatussen Linked.
Når du vender tilbage til O365-integrationen i GoBright , kan GoBright se, at SSO-tenantlinket er linket, men der vises også en anden integration, "Status Office 365 (kalender)", som ikke er linket.
Trin 2 Integration af værelsesbooking
Det næste trin er kun relevant, hvis du har Room Booking og ønsker at integrere Rooms med Office 365. Ellers skal du springe trin 2, trin 3, trin 4 og trin 5 over og gå til trin 6 for brugersynkronisering.
2.1. Integration af kalenderlink-applikation
Hvis du bruger funktionen Rumreservation i GoBright, skal du forbinde kalenderintegrationen, da dette giver dig mulighed for at integrere rumkalenderne med GoBright automatisk oprette Teams-mødeforbindelser, når du reserverer et rum via GoBright .
Dobbelttjek og sørg for, at de rumpostkasser, du forsøger at integrere, ikke er skjult i den globale adresseliste på Exchange. Dette kan forårsage valideringsfejl, at objekt-ID'erne ikke er tilgængelige i det eksterne system.
Når du trykker på linket, udløses en prompt, der anmoder om tilladelser til at oprette GoBright Calendar Application Mode-applikationen.
VIGTIG BEMÆRKNING: Den normale fremgangsmåde er at anvende fuld integration. Hvis du ønsker at anvende begrænset integration og begrænse denne til bestemte kalendere eller kun ressourcekalendere, skal du anvende 'begrænsningspolitikken' som beskrevet i trin 4 nedenfor.
Når den accepteres, oprettes en ny GoBright Graph Enterprise-applikation, og GoBright kommunikere med rumkalenderne.
2.2. Opret Connect til Office 365 med PowerShell (hvis du har brug for at oprette rumpostkasserne i O365)
At oprette forbindelse til Office 365 med PowerShell er den nemmeste måde at udføre flere konfigurationskommandoer på.
For at oprette forbindelse til Office 365 med MFA-understøttelse leverer Microsoft EXO V3-modulet, der udgives via PowerShell-galleriet, og som kan installeres med følgende trin:
-
Start PowerShell som administrator
GoBright håndhæver kommunikation ved hjælp af TLS 1.2. Afhængigt af det system, du bruger, sker dette muligvis ikke automatisk. Se koden nedenfor, og implementer denne i alle PowerShell-scripts, der kommunikerer med GoBright.
Tilføj også $ErrorActionPreference for at sikre, at det stopper scriptet, når der opstår en fejl. Glem ikke at tilføje nedenstående linjer i hvert af dine scripts.
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 $ErrorActionPreference = "Stop" - Installer PowerShell-galleriets PowerShell-modul:
- Udfør følgende kommandoer i PowerShell (kør som administrator)
-
Installer NuGet PackageProvider:
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force -
Konfigurer PowerShellGallery som en pålidelig kilde:
Set-PSRepository -Name PSGallery -InstallationPolicy Trusted -
Installer PowerShellGet-modulet:
Import-Module -Name PowerShellGet
-
Installer EXO V3-modulet (ExchangeOnlineManagement):
Install-Module -Name ExchangeOnlineManagement -ForceKommandoen '-Force' sørger for, at den nyeste version af modulet bliver installeret, selv om der findes en tidligere installation.
- Luk PowerShell-sessionen
- Start en ny PowerShell-session
Nu kan vi bruge det installerede EXO V3-modul til at oprette forbindelse til Office 365:
- Start PowerShell som administrator (sørg for, at det er en ny PowerShell-session)
-
Begynd at oprette forbindelse ved at logge ind, og brug en konto med de nødvendige tilladelser til at administrere dit Office 365-miljø:
Connect-ExchangeOnline -UserPrincipalName [email protected] -ShowProgress $true - Når du er logget ind, er vi klar til at fortsætte med den videre konfiguration!
2.3. Opret rumkalenderne i Office 365 (hvis du har brug for at oprette rumpostkasserne i O365)
Med nedenstående trin kan du oprette rum i dit Office 365-miljø. Dette vil udgive rummene i Office 365 og give en kalender til hvert rum.
Hvis du allerede har rumkalendere i dit Office 365-miljø, kan du gå videre til næste trin, men sørg for at have rummenes e-mailadresser, for dem skal du bruge senere.
Udfør følgende kommandoer via PowerShell-sessionen.
Udfør følgende kommando, skift MicrosoftOnlineServicesID til den ønskede e-mailadresse for rummet, og angiv et korrekt navn, visningsnavn og adgangskode for dette rum:
New-Mailbox -EnableRoomMailboxAccount $true -Room -MicrosoftOnlineServicesID [email protected] -Name Room1 -DisplayName 'Room 1' -RoomMailboxPassword (ConvertTo-SecureString -String YourPasswordHere -AsPlainText -Force)
Hvis det er nødvendigt, kan du indstille den organisatoriske enhed via parameteren -OrganizationalUnit. Kommandoeksemplet ovenfor antager standardorganisationsenheden.
Udfør denne kommando for hvert rum, du gerne vil oprette.
2.4. Konfigurer brugerens standardadgang til rumpostkasserne
Nu skal brugernes adgang til rumpostkasserne konfigureres.
Udfør følgende kommandoer via PowerShell-sessionen.
Med følgende kommando sætter du standardadgangen for hver rumpostkasse til 'read only, with limited details', det er normalt bedst, så brugerne ikke kan ændre direkte i rumpostkassen. Ændr værdien af Identity til rummets e-mailadresse.
Set-MailboxFolderPermission -Identity [email protected]:Calendar -User Default -AccessRights LimitedDetails
Bemærk: Mappenavnet 'Calendar' afhænger af kulturindstillingerne for rummets postkasse, så 'Calendar' kan også være en oversat værdi som 'Agenda'. Kommandoen fejler med en fejlmeddelelse, hvis du bruger det forkerte mappenavn.
Udfør følgende kommando for at få mappenavnet (f.eks. når kommandoen ovenfor mislykkes):
Get-MailboxFolderStatistics -Identity [email protected] | Where-Object {$_.FolderType -eq "Calendar"} | Select Name,FolderType,Identity
2.5. Konfigurer rumpostkassernes opførsel
Standardadfærden for en rumpostkasse ændrer emnet for aftalen og fjerner det private flag, hvis det er sat. Med følgende kommando konfigureres rumpostkassen til automatisk at behandle (acceptere/afvise) mødeanmodninger og bevare mødedataene.
Udfør følgende kommando via PowerShell-sessionen.
Konfigurer opførslen for rummets postkasse, og skift Identitetsparameteren til e-mailadressen til rummets e-mailadresse:
Set-CalendarProcessing -Identity [email protected] -AutomateProcessing AutoAccept -DeleteSubject $False -DeleteComments $False -AddOrganizerToSubject $False -RemovePrivateProperty $False
Udfør denne kommando for hver rumpostkasse.
Når det er nødvendigt, kan du ændre denne best-practice for at få en anden adfærd. Følgende parametre er de vigtigste:
- Automatiser behandling: AutoAccept vil få rumpostkassen til at behandle møder automatisk (acceptere/afvise). Det er også muligt at gøre dette manuelt via værdien 'None'(mere info), men det betyder også, at du skal behandle aflysninger manuelt.
- Slet emne: Ved at beholde det oprindelige emne kan vi vise emnet i portalen, appen og på skærme. Dette er muligt via værdien $False. Hvis du bruger værdien $True, vil emnet blive slettet af rummets postkasse.
- SletKommentarer: Når DeleteComments er sat til $True, vil indholdet af kommentaren i dit kalenderelement ikke blive skubbet til GoBright og -appen. Hvis den er sat til $False, vil alt indhold i din kommentar blive sendt til GoBright og -appen. Husk, at kun de første 500 tegn vil blive vist på grund af en begrænsning fra Microsoft.
- Tilføj arrangør til emne: Værelsespostkassen kan tilføje navnet på arrangøren til emnet, men det kan blive forvirrende. Ved at bruge værdien $False deaktiveres dette.
- FjernPrivatEgenskab: Rumpostkassen fjerner den private egenskab fra det indgående møde. Ved at bruge værdien $False beholder mødet sit private flag.
Læs denne Microsoft-artikel for at få flere oplysninger om postkasseindstillinger.
Trin 3 Integration af skrivebord og parkeringspladser
Skrivebords- eller parkeringsintegrationen med M365 giver brugerne mulighed for at booke skriveborde eller parkeringspladser direkte via M365 GoBright Outlook Add-In eller Teams Plugin. Denne integration forenkler administrationen af arbejdsområder og giver medarbejderne en nem måde at reservere ressourcer på og undgå konflikter i planlægningen.
Ved at bruge værktøjer som Outlook og Teams forbedrer denne mulighed den samlede kontoroplevelse.
Hvis du vil vide mere om, hvordan du integrerer skriveborde eller parkeringspladser, kan du læse artiklen om integration af skriveborde og parkeringspladser.
Trin 4 Begræns tilladelser og begrænsninger for kalenderintegration (valgfrit)
Den normale fremgangsmåde er at anvende fuld integration fra trin 2.1. Hvis du ønsker at anvende begrænset integration, skal du anvende "begrænsningspolitikken" som beskrevet i trin 4.1.
Denne begrænsningspolitik giver GoBright -applikationen kun adgang til medlemmerne på den konfigurerede adgangsfortegnelse under dette trin. Dette blokerer for eksempel adgangen til de andre kalendere i din organisation.
For eksempel kan GoBright via Enterprise-applikationen "GoBright integration" kun have adgang til bestemte brugerkalendere og/eller kun din ressourcekalender på en bestemt placering i din Office365-tenant.
4.1. Valgfri kalenderintegrationstilladelser og -begrænsninger
Som standard kan den oprettede 'Calendar Integration Enterprise Application' udføre fuld integration, hvilket maksimerer værdien for brugeren.
Hvis du vil begrænse integrationen til specifikke kalendere (rum), kan det gøres med en Application Access Policy.
Bemærk: Dette gælder kun, når reservationen foretages fra GoBright . Hvis du reserverer et rum fra Outlook ved hjælp af Outlook-tilføjelsesprogrammet, er der ingen begrænsninger, og brugeren vil være arrangøren.
Politik for begrænsning af applikationsadgang
Adgangspolitikken for applikationsbegrænsninger påvirker også, hvordan værelsesbookinger oprettes via GoBright :
- Når ubegrænset / fuld integration - brugeren er arrangør af mødet.
- When Restricted / Restricted Integration - Room er arrangør af mødet.
Når politikken Restricted anvendes på rummene, vil den person, der oprettede mødet, ikke være arrangør og kan ikke se ændringer til mødet direkte i sin indbakke, i stedet vil alle ændringer gå til rummets indbakke, da rummet vil være arrangør af mødet, og personen vil kun være en deltager.
For at oprette politikken skal vi oprette en gruppe, der indeholder alle de rum, vi vil begrænse applikationen til, og derefter anvende politikken på den gruppe.
Til dette bruger vi PowerShell som et universelt sprog, og det er hurtigere og enklere end at forklare det via Exchange Online Admin Panel.
Skridt, der skal følges for at anvende politikken:
Start med at oprette forbindelse til Exchange Online PowerShell:
- Start PowerShell som administrator
-
Connect-ExchangeOnline -ShowProgress $true -UserPrincipalName [email protected]
Først skal du angive de e-mailadresser, der skal bruges i begrænsningen eller udelukkelsen.
Dette skal være en 'mail-aktiveret sikkerhedsgruppe' i Exchange, som vi opretter i de næste trin.
trin:
-
Opret først den 'mail-aktiverede sikkerhedsgruppe':
New-DistributionGroup -Type Security -Name "GoBright Accesslist" -PrimarySmtpAddress [email protected] -
Tilføj derefter medlemmer på følgende måde:
Add-DistributionGroupMember -Identity [email protected] -Member [email protected] -
Og du kan tjekke listen over medlemmer som følger:
Get-DistributionGroupMember -Identity [email protected] - Mere dokumentation her: https://learn.microsoft.com/enus/exchange/recipients/mail-enabled-security-groups?view=exchserver-2019
- Du kan også oprette og administrere den fra Exchange Admin Center
Nu kan du forbinde den 'mail-aktiverede sikkerhedsgruppe' til at fungere som en begrænsning:
-
New-ApplicationAccessPolicy -AppId 32fed4dc-afbe-4e0b-a2cc-2afc2a62d450 -PolicyScopeGroupId [email protected] -AccessRight RestrictAccess -Description "Restrict the GoBright platform access to members of [email protected]." -
Nu kan du teste adgangen til en bestemt kalender med denne kommando:
Test-ApplicationAccessPolicy -Identity [email protected] -AppId 32fed4dc-afbe-4e0b-a2cc-2afc2a62d450
Vigtige bemærkninger:
- Testkommandoen vil virke direkte, men de reelle adgangsbegrænsninger kan tage op til 90 minutter, men nogle gange 24-48 timer, før de bliver aktive.
- ApplicationAccessPolicy slettes ikke automatisk, hvis du sletter
Enterprise Application.
At slette en ApplicationAccessPolicy fungerer på denne måde:
-
Vis en liste over ApplicationAccessPolicies for GoBright:
Get-ApplicationAccessPolicy | Where { $_.AppId -eq "32fed4dc-afbe-4e0b-a2cc-2afc2a62d450" } | Format-List - Kopier 'Identity' (en meget lang streng) for den ApplicationAccessPolicy, du vil slette
-
Udfør det derefter:
Remove-ApplicationAccessPolicy -Identity "xxxxxxxxxxxxxxxxx"
Trin 5 Tilføj og konfigurer rum i GoBright
5.1 Konfigurer rum
Følg trinnene i denne artikel for at fortsætte.
Trin 6 Brugersynkronisering
I øjeblikket har vi to metoder til brugersynkronisering, og forskellen mellem de to metoder er:
-
SCIM implementeres som en virksomhedsapplikation og kræver kun lidt konfiguration for at blive sat op og vil automatisk forsyne brugere hvert 40. minut. SCIM vil være hovedværktøjet til brugersynkronisering.
-
PowerShell Scheduled Sync Script skal opsættes og derefter planlægges til at køre regelmæssigt på en server med Task Scheduler eller med Azure Automation Runbook. Med PowerShell-scriptet kan du også synkronisere attributter for NFCId og PIN-kode, hvis du har konfigureret dem i dit Azure AD. PowerShell Sync vil også fortsat være en understøttet metode.
6.1. Brugersynkronisering med EntraID / Azure AD SCIM-brugerprovisionering
SCIM er et kraftfuldt værktøj, der kan forsyne tildelte brugere til GoBright med en dedikeret rolle samt administrere, deaktivere og slette dem.
Artiklen om, hvordan man konfigurerer SCIM, kan findes her.
6.2. Bruger-synkronisering med EntraID / Azure AD ved hjælp af PowerShell-planlagt script
Azure AD/Active Directory-synkroniseringen er i stand til automatisk at oprette, opdatere og deaktivere brugere fra Azure AD eller Active Directory.
Artiklen om, hvordan man konfigurerer brugersynkronisering med PowerShell Scheduled Script, kan findes her.
Trin 7 GoBright Add-In/Plug-In Outlook/Teams
Outlook Add-In og Teams and Outlook GoBright Plug-In kan findes og implementeres fra Microsoft Application Gallery, som er tilgængelig i sektionen Integrated Apps i Microsoft 365 Admin Center. For detaljerede trin, se venligst denne artikel