Integrering av EntraID/AzureAD Enterprise-applikasjoner via Microsoft Graph API (SSO/O365/SCIM/Kalender-integrering)

Microsoft Graph API

Denne artikkelen beskriver hvordan du konfigurerer GoBright for å integrere med Microsoft Graph API.

Forskjellen mellom full grafisk API-integrasjon og tidligere integrasjon

Med den fulle Microsoft Graph API-integrasjonen , GoBright krever ikke lenger brede postbokstillatelser. I stedet kreves bare kalendertillatelser når full representasjon er aktivert.

Denne tilnærmingen er sikrere og mer effektiv fordi den reduserer unødvendig tilgang. Du kan også velge å begrense tillatelser slik at GoBright har bare tilgang til spesifikke ressurskalendere (se trinn 4 i oppsettveiledningen).

Kort sagt, den nye integrasjonen effektiviserer tillatelser, forbedrer sikkerheten og gir administratorer større kontroll over hvilke kalendere GoBright kan klare.

Har du allerede en integrasjon? Les migreringsartikkelen: Bytte til Microsoft Graph API-integrasjon

Hvis brukerne og/eller ressursene begge er tilgjengelige i EntraID / AzureAD, anbefales det på det sterkeste å inkludere GoBright som en bedriftsapplikasjon. Det er noen grunner til å gjøre dette:

Hvorfor du bør vurdere å legge til GoBright i EntraID / Azure AD

  • Applikasjonen kan brukes til å sette opp rombestillingsintegrasjonen

  • Applikasjonen kan brukes til å synkronisere brukere fra EntraID / Azure AD når SCIM User Provisioning er konfigurert

  • Administrere brukere som kan logge på GoBright plattform med Microsoft Single Sign-On

  • Ingen ekstra konfigurasjon eller skripting er nødvendig

Bruk av denne bedriftsapplikasjonen vil enkelt sette opp en tilkobling, inkludert SSO, samtidig som du fortsatt har kontroll over hvem som har lov til å bruke applikasjonen.

Trinn 1 Office365-integrasjon for SSO

Opprette Office 365-applikasjonsintegrasjonen

Når du er logget på GoBright portal med den opprinnelige administratorkontoen, kan du trykke på de fire firkantene øverst til høyre og velge administrasjonssenteret.

Du må gå til integrasjoner, trykk på den blå knappen Legg til øverst til høyre.

Her blir du presentert med et par alternativer som du kan velge avhengig av det eksterne systemet du trenger å integrere med GoBright .

I ditt tilfelle nå er det eksterne systemet Office 365.

Etter at du har merket av i denne avmerkingsboksen, vises en popup-melding som ber om at endringene lagres før integreringen med Microsoft Graph API finner sted.

Du kan nå koble O365-leietakeren ved å klikke på den grønne «Koble til (leietaker)»-knappen, som vil gi oss en melding om å logge på med en Microsoft-konto.

For dette må du bruke en global administrasjonskonto for Azure/Entra ID.

Applikasjonsmodus 2.png

Når du er pålogget, utløses en annen melding som vil be om tillatelser.

Tillatelsene er for GoBright SSO-applikasjon som lar brukere autentisere og logge på med sine O365-kontoer.

Når den er akseptert, opprettes Enterprise Application, og du vil bli brakt tilbake til GoBright portal med Leietaker-status Linked.

Når du blir brakt tilbake til O365-integrasjonen i GoBright Du kan se at SSO-leietakerlenken er lenket, men den vil også vise annen integrasjonsstatus for Office 365 (kalender) som ikke er lenket.

Trinn 2 Integrasjon av rombestilling

Det neste trinnet er kun aktuelt hvis du har rombestilling og ønsker å integrere rommene med Office 365. Ellers kan du hoppe over trinn 2, trinn 3, trinn 4 og trinn 5, og gå til trinn 6 for brukersynkronisering.

2.1. Integrering av kalenderkoblingsapplikasjonen

Hvis du bruker rombestillingsfunksjonen i GoBright , må du koble kalenderintegrasjonen, da dette vil gi deg muligheten til å integrere romkalenderne med GoBright og for å kunne opprette Teams-møtelenker automatisk når du bestiller et rom gjennom GoBright Portal.

Vennligst dobbeltsjekk og sørg for at rompostboksene du prøver å integrere ikke er skjult i den globale adresselisten på Exchange. Dette kan forårsake valideringsfeil, at objekt-ID-ene ikke er tilgjengelige i det eksterne systemet

Når du trykker på lenken, utløses en melding som vil be om tillatelser for å opprette GoBright Program for kalenderapplikasjonsmodus.

VIKTIG MERKNAD: Standardmetoden er full integrasjon. Hvis du vil bruke begrenset integrasjon og begrense dette til bestemte kalendere eller bare ressurskalendere, kan du bruke «begrensningspolicyen» som beskrevet i trinn 4 nedenfor.

Når den er godkjent, en ny GoBright Kalendergraf-bedriftsapplikasjonen vil bli opprettet og GoBright kan kommunisere med romkalenderne.

2.2. Connect til Office 365 med PowerShell (hvis du trenger å opprette rompostkassene i O365)

Å koble til Office 365 med PowerShell er den enkleste måten å utføre flere konfigurasjonskommandoer på.

For å koble til Office 365 med MFA-støtte, tilbyr Microsoft EXO V3-modulen , publisert gjennom PowerShell-galleriet, som kan installeres med følgende trinn:

  1. Start PowerShell som administrator

    De GoBright Plattformen håndhever kommunikasjon ved hjelp av TLS 1.2. Avhengig av systemet du bruker, skjer kanskje ikke dette automatisk. Se koden nedenfor og implementer dette i alle PowerShell-skript som kommuniserer med GoBright .

    Legg også til $ErrorActionPreference for å sikre at den stopper skriptet hver gang det oppstår en feil. Ikke glem å legge til linjene nedenfor i hvert av skriptene dine.

    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 $ErrorActionPreference = "Stop"

  2. Installer PowerShell-galleriet PowerShell-modulen:
    • Utfør følgende kommandoer i PowerShell (kjører som administrator)
    • Installer NuGet PackageProvider:

      Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
    • Konfigurer PowerShellGallery som en pålitelig kilde:

      Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
    • Installer PowerShellGet-modulen:

      Import-Module -Name PowerShellGet
  3. Installer EXO V3 (ExchangeOnlineManagement)-modulen:

    Install-Module -Name ExchangeOnlineManagement -Force

    Kommandoen ' -Force ' sørger for at den nyeste versjonen av modulen er installert selv når en tidligere installasjon eksisterer.

  4. Lukk PowerShell-økten
  5. Start en ny PowerShell-økt

Nå kan vi bruke den installerte EXO V3-modulen til å koble til Office 365:

  1. Start PowerShell som administrator (sørg for at dette er en ny PowerShell-økt)
  2. Begynn å koble til ved å logge på, bruk en konto med de nødvendige tillatelsene for å administrere Office 365-miljøet ditt:

    Connect-ExchangeOnline -UserPrincipalName [email protected] -ShowProgress $true
  3. Når du er logget inn, er vi klare til å fortsette med den videre konfigurasjonen!

2.3. Lag romkalendere i Office 365 (hvis du trenger å opprette rompostkassene i O365)

Med trinnene nedenfor kan du opprette rom i Office 365-miljøet ditt. Dette vil publisere rommene i Office 365, og gi en kalender for hvert rom.

Hvis du allerede har romkalendere i ditt Office 365-miljø, fortsett med neste trinn, men sørg for at du har e-postadressene til rommene, for du vil trenge dem senere.

Utfør følgende kommandoer via PowerShell-økten.

Utfør følgende kommando, endre MicrosoftOnlineServicesID til rommets e-postadresse du ønsker, og oppgi riktig navn , displaynavn og passord for dette rommet:

New-Mailbox -EnableRoomMailboxAccount $true -Room -MicrosoftOnlineServicesID [email protected] -Name Room1 -DisplayName 'Room 1' -RoomMailboxPassword (ConvertTo-SecureString -String YourPasswordHere -AsPlainText -Force)

Om nødvendig kan du angi Organisasjonsenhet via parameteren -Organisasjonsenhet . Eksempelkommandoen ovenfor forutsetter standard organisasjonsenhet.

Utfør denne kommandoen for hvert rom du vil opprette.

2.4. Konfigurer brukerens standardtilgang til rompostboksene

Nå skal brukernes tilgang til rommets postkasse konfigureres.

Utfør følgende kommandoer via PowerShell-økten.

Med følgende kommando setter du standardtilgangen for hver rompostkasse til "skrivebeskyttet, med begrensede detaljer", dette er vanligvis best, slik at brukere ikke kan endre direkte i rommets postkasse. Endre verdien av Identity til e-postadressen til rommet.

Set-MailboxFolderPermission -Identity [email protected]:Calendar -User Default -AccessRights LimitedDetails

Merk: mappenavnet 'Kalender' er avhengig av kulturinnstillingene i rommets postkasse, så 'Kalender' kan også være en oversatt verdi som 'Agenda'. Kommandoen vil mislykkes med en feilmelding hvis du bruker feil mappenavn.

Utfør følgende kommando for å 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 oppførselen til rompostboksene

Standardoppførselen til en rompostboks endrer emnet for avtalen og fjerner det private flagget hvis det er angitt. Via følgende kommando konfigureres rompostkassen til automatisk å behandle (godta/avslå) møteforespørsler og holde møtedataene på plass.

Utfør følgende kommando via PowerShell-økten.

Konfigurer oppførselen til rommets postkasse, endre identitetsparameteren til e-postadressen til e-postadressen til rommet:

Set-CalendarProcessing -Identity [email protected] -AutomateProcessing AutoAccept -DeleteSubject $False -DeleteComments $False -AddOrganizerToSubject $False -RemovePrivateProperty $False

Utfør denne kommandoen for hver rompostkasse.

Ved behov kan du endre denne beste fremgangsmåten for å få en annen oppførsel. Følgende parametere er de viktigste:

  • AutomateProcessing: AutoAccept vil gjøre rommets postkasse til å behandle møter automatisk (godta/avslå). Det er også mulig å gjøre dette manuelt, via verdien 'Ingen' ( mer info ), men dette betyr også at du må behandle kanselleringer manuelt.
  • DeleteSubject: Ved å beholde det opprinnelige emnet, kan vi vise emnet i portalen, appen og skjermene. Dette er mulig via verdien $False. Hvis du bruker verdien $True, vil emnet bli slettet av rommets postkasse.
  • DeleteComments: Når DeleteComments er satt til $True, vil ikke innholdet i kommentaren i kalenderelementet bli sendt til GoBright portal og app. Hvis satt til $False, vil alt innholdet i kommentaren din bli sendt til GoBright portal og app. Husk at bare de første 500 tegnene vises på grunn av en begrensning fra Microsoft.
  • AddOrganizerToSubject: Rompostkassen kan legge til navnet på arrangøren til emnet, men dette kan bli forvirrende. Ved å bruke verdien $False er dette deaktivert.
  • RemovePrivateProperty: Rompostkassen fjerner den private eiendommen fra det innkommende møtet. Ved å bruke verdien $False vil møtet beholde sitt private flagg.

For mer informasjon om postboksinnstillinger, les denne Microsoft-artikkelen .

Trinn 3 Integrasjon av skrivebord og parkeringsplasser

Skrivebords- eller parkeringsintegrasjonen med M365 lar brukere bestille skrivebord eller parkeringsplasser direkte gjennom M365 GoBright Outlook-tillegg eller Teams-plugin. Denne integrasjonen forenkler arbeidsområdeadministrasjonen, og gir ansatte en enkel måte å reservere ressurser på og unngå planleggingskonflikter.

Ved å bruke verktøy som Outlook og Teams, forbedrer denne muligheten den generelle kontoropplevelsen.

For mer informasjon om hvordan du integrerer skrivebord eller parkeringsplasser, les artikkelen om integrering av skrivebord og parkeringsplasser .

Trinn 4 Begrens kalenderintegreringstillatelser, begrensninger (valgfritt)

Standardmetoden er å bruke full integrasjon fra trinn 2.1. Hvis du vil bruke begrenset integrasjon, må du bruke «begrensningspolicyen» som beskrevet i trinn 4.1.

Denne restriksjonspolitikken gir GoBright Bedriftsapplikasjonen har bare muligheten til å ha tilgang til medlemmene i den konfigurerte tilgangslisten i løpet av dette trinnet. Dette blokkerer for eksempel tilgang til de andre kalenderne i organisasjonen din.

For eksempel, GoBright plattformen via « GoBright «Kalenderintegrasjon» Bedriftsapplikasjonen har kanskje bare tilgang til bestemte brukerkalendere og/eller bare ressurskalenderen din på en bestemt plassering av Office 365-leietakeren din.

4.1. Valgfrie tillatelser for kalenderintegrering, begrensninger

Som standard kan den opprettede «Kalenderintegrasjonsbedriftsapplikasjonen» utføre full integrasjon, noe som maksimerer verdien for brukeren.

Hvis du ønsker å begrense integrasjonen til spesifikke (rom) kalendere, kan dette gjøres med en Application Access Policy.

Merk: Dette gjelder kun når bestillingen gjøres fra GoBright portal. Hvis du bestiller et rom fra Outlook ved hjelp av Outlook-tillegget, vil det ikke være noen begrensning, og brukeren vil være arrangøren.

Retningslinjer for begrensning av programtilgang

Retningslinjene for tilgangsbegrensninger for applikasjoner påvirker også hvordan rombestillinger opprettes gjennom GoBright Portal:

  • Når Ubegrenset / Full Integration – Brukeren er arrangøren av møtet.
  • When Restricted / Restricted Integration – Room er arrangøren av møtet.

Når begrenset policy brukes på rommene, vil ikke personen som opprettet møtet være arrangøren og kan ikke se endringer i møtet direkte i innboksen sin, i stedet vil alle endringene gå til innboksen til rommet, siden rommet vil være arrangøren av møtet og personen vil bare være en deltaker.

For å opprette policyen, må vi opprette en gruppe som vil inneholde alle rommene vi ønsker å begrense programmet til, og deretter bruke policyen på den gruppen.

Til dette bruker vi PowerShell som et universelt språk, og det er raskere og enklere enn å forklare det gjennom Exchange Online Admin Panel.

Trinn som skal følges for å bruke retningslinjene:

Start med å koble til Exchange Online PowerShell:

  1. Start PowerShell som admin
  2. Connect-ExchangeOnline -ShowProgress $true -UserPrincipalName [email protected]

Først må du liste opp e-postadressene som skal brukes i grensen eller ekskluderingen.
Dette må være en "e-postaktivert sikkerhetsgruppe" i Exchange, som vi oppretter en i neste
trinn:

  1. Opprett først den "e-postaktiverte sikkerhetsgruppen":

    New-DistributionGroup -Type Security -Name "GoBright Accesslist" -PrimarySmtpAddress [email protected]
  2. Legg deretter til medlemmer, som følger:

    Add-DistributionGroupMember -Identity [email protected] -Member [email protected]
  3. Og du kan sjekke medlemslisten som følger:

    Get-DistributionGroupMember -Identity [email protected]
  4. Mer dokumentasjon her: https://learn.microsoft.com/enus/exchange/recipients/mail-enabled-security-groups?view=exchserver-2019
  5. Du kan også opprette og administrere den fra Exchange Admin Center

Applikasjonsmodus 7.png

Nå kan du koble den «e-postaktiverte sikkerhetsgruppen» til å fungere som en begrensning:

  1. New-ApplicationAccessPolicy -AppId 32fed4dc-afbe-4e0b-a2cc-2afc2a62d450 -PolicyScopeGroupId [email protected] -AccessRight RestrictAccess -Description "Restrict the GoBright platform access to members of [email protected]."
  2. Nå kan du teste tilgangen til en spesifikk kalender med denne kommandoen:

    Test-ApplicationAccessPolicy -Identity [email protected] -AppId 32fed4dc-afbe-4e0b-a2cc-2afc2a62d450

Viktige merknader:

  • Testkommandoen vil fungere direkte, men de reelle tilgangsbegrensningene kan ta opptil 90 minutter, men noen ganger 24-48 timer. å bli aktiv.
  • ApplicationAccessPolicy slettes ikke automatisk hvis du sletter Enterprise-applikasjonen.

Å slette en ApplicationAccessPolicy fungerer slik:

  1. List opp ApplicationAccessPolicies for GoBright :

    Get-ApplicationAccessPolicy | Where { $_.AppId -eq "32fed4dc-afbe-4e0b-a2cc-2afc2a62d450" } | Format-List
  2. Kopier 'Identity' (en veldig lang streng) til ApplicationAccessPolicy du vil slette
  3. Utfør deretter:

    Remove-ApplicationAccessPolicy -Identity "xxxxxxxxxxxxxxxxx"

Trinn 5 Legg til og konfigurer rom i GoBright

5.1 Konfigurer rom

Følg trinnene i denne artikkelen for å fortsette.

Trinn 6 Brukersynkronisering

For øyeblikket har vi to metoder for brukersynkronisering, forskjellen mellom de to metodene er:

  • SCIM blir distribuert som en Enterprise Application og krever lite konfigurasjon for å konfigureres og vil klargjøre brukere automatisk hvert 40. minutt. SCIM vil være hovedverktøyet for brukersynkronisering.

  • PowerShell Scheduled Sync-skriptet må konfigureres og deretter planlegges til å kjøre periodisk på en server med Task Scheduler eller med Azure Automation Runbook. Med PowerShell-skriptet kan du også synkronisere attributter for NFCId og PIN-kode hvis du har dem konfigurert i Azure AD. PowerShell Sync vil også forbli som støttet metode.

6.1. Brukersynkronisering med EntraID / Azure AD SCIM-brukerklargjøring

SCIM er et kraftig verktøy som kan klargjøre tildelte brukere til GoBright med en dedikert rolle, samt administrere, deaktivere og slette dem.

Artikkelen om hvordan du konfigurerer SCIM finner du her .

6.2. Brukersynkronisering med EntraID / Azure AD ved hjelp av PowerShell-planlagt skript

Azure AD / Active Directory-synkroniseringen er i stand til automatisk å opprette, oppdatere og deaktivere brukere fra Azure AD eller Active Directory.

Artikkelen om hvordan du konfigurerer brukersynkronisering med PowerShell Scheduled Script finner du her .

Trinn 7 GoBright Add-In/Plug-In Outlook/Teams

Outlook-tillegget og Teams og Outlook GoBright Plug-in kan bli funnet og distribuert fra Microsoft Application Gallery, som er tilgjengelig under Integrated Apps-delen i Microsoft 365 Admin Center. For detaljerte trinn, se denne artikkelen

Applikasjonsmodus 99.png

Denne artikkelen kommer fra hjelpesenteret til GoBright .

Se originalartikkelen
GoBright vil være til stede på The Workplace Event i Birmingham; fra 28. til 30. april 2026 - stand 3A/w12

Bli med Chris Wiegeraad på Workplace Leaders' Summit 29. april kl. 11:20.

Registrer deg nå! TWE 2026
Chris The Workplace-arrangementet Workplace Leaders Summit