re:ADM kan tjene sig selv hjem på et år. Bestil inden den 18. december og få 20 % rabat www.identum.no/re-adm

Sådan konfigureres Entra ID til integration

Denne vejledning beskriver, hvordan man forbereder Microsoft Entra ID til integration med eAdm eller eFeide. Processen indebærer, at man opretter en applikationsregistrering og derefter tildeler de nødvendige tilladelser.

Du kan roligt springe afsnittet om avanceret konfiguration over, medmindre Identum udtrykkeligt beder dig om andet.


Del 1: Opret en Entra ID-applikationsregistrering

  1. Log ind på Azure-portalen med en administratorkonto.

  2. Gå til Entra ID.

  3. Vælg »App-registreringer « i menuen til venstre, og klik derefter på »+ Ny registrering«.

  4. På siden »Registrer en applikation« skal du konfigurere følgende indstillinger:

    • Navn: Indtast et beskrivende navn til applikationen. For eksempel: Identum eFeide-eAdm User and Group Management.

    • Understøttede kontotyper: Vælg kun konti i denne organisationsmappe (enkeltlejer).

    • Omdirigerings-URI: Lad dette felt være tomt.

  5. Klik på »Registrer« for at oprette ansøgningen.

  6. Når applikationen er oprettet, skal du kopiere applikations-ID ’et (klient-ID’et) og katalog-ID’et (tenant-ID’et) fra applikationens side »Oversigt«. Gem disse værdier til senere brug.


Advarsel: Brug ikke en skråstreg (/) i applikationsnavnet, da dette kan medføre problemer i Entra ID.


Del 2: Tildel API-tilladelser

Dernæst skal du give applikationen de nødvendige API-tilladelser til at administrere brugere og grupper.

  1. I din nye applikationsregistrering skal du gå til »API-tilladelser« i menuen til venstre.

  2. Klik på + Tilføj en tilladelse.

  3. Vælg Microsoft Graph.

  4. Vælg »App-tilladelser«.

  5. Tilføj følgende tilladelser:

    • Directory.Read.All

    • Directory.ReadWrite.All

    • Group.Create

    • Group.Read.All

    • Group.ReadWrite.All

    • GroupMember.ReadWrite.All

    • User.Read.All

    • User.ReadWrite.All

    • User.EnableDisableAccount.All

  6. Tilføj desuden følgende tilladelser, hvis de er relevante for dine specifikke behov:

    • AuditLog.Read.All: Påkrævet, hvis du vil synkronisere lastLogonTimeStamp tilknytte til eAdm eller synkronisere MFA-registreringsstatus.

    • UserAuthenticationMethod.ReadWrite.All: Kræves, hvis eAdm skal administrere brugernes MFA-metoder.

    • Reports.Read.All: Kræves, hvis eAdm skal synkronisere postkassens størrelse med eAdm.

    • LicenseAssignment.Read.All: Påkrævet, hvis eAdm skal synkronisere tildelte licensnavne/ID'er til eAdm.

  7. Når du har tilføjet tilladelserne, skal du klikke på »Tilføj tilladelser«.

  8. På skærmbilledet med API-tilladelser skal du klikke på »Giv administratorrettigheder til [navnet på din tenant] « og bekræfte, når du bliver bedt om det.


Bemærk: De rettigheder, der er angivet med fed skrift, er obligatoriske for grundlæggende integration. De øvrige er nødvendige i forbindelse med specifikke, almindelige scenarier.


Del 3: Opret en klientnøgle

En klientnøgle er en adgangskode, som applikationen bruger til at autentificere sig selv.

  1. Gå til »Certifikater og hemmeligheder« i menuen til venstre.

  2. Klik på + Ny klientnøgle.

  3. Indtast en beskrivelse af hemmeligheden, og indstil udløbsperioden til 24 måneder.

  4. Klik på »Tilføj«.

  5. Kopier straks værdien af den nye klientnøgle fra feltet »Værdi «.


Advarsel: Værdien for klienthemmeligheden vises kun i sin helhed umiddelbart efter oprettelsen. Hvis du ikke kopierer den nu, bliver du nødt til at oprette en ny. Opbevar denne værdi sikkert.

Bemærk: Hvis Privileged Identity Management (PIM) er aktiveret i dit miljø, kan du muligvis ikke angive en fast udløbsdato.


Del 4: Tildel en administratorrolle

For at kunne udføre følsomme handlinger, såsom at ændre adgangskoder eller opdatere brugernes telefonnumre, skal applikationen have en administratorrolle.

  1. Gå til Entra ID i Azure-portalen.

  2. Vælg »Roller og administratorer«.

  3. Find og vælg rollen »Brugeradministrator «.

  4. Klik på »Tilføj opgaver«.

  5. Søg efter og vælg det program, du oprettede tidligere (f.eks. Identum eFeide-eAdm User and Group Management).

  6. På den næste skærm skal du indstille »Opgavetype« til »Aktiv« og angive en begrundelse, f.eks. »Nødvendigt for, at eFeide kan administrere brugeradgangskoder.«

  7. Klik på »Tildel« for at afslutte roletildelingen.


Bemærk: Hvis du bruger grupper, hvor der kan tildeles roller, til brugere, der administreres af eFeide eller eAdm, kræver applikationen i stedet rollen »Privileged Authentication Administrator «. Se venligst: https://learn.microsoft.com/en-us/entra/identity/role-based-access-control/privileged-roles-permissions?tabs=admin-center#who-can-perform-sensitive-actions


Del 5: Send oplysninger til Identum

Når konfigurationen er færdig, skal du sende følgende oplysninger til Identum for at afslutte opsætningen:

  • Lejerens navn (f.eks. yourcompany.onmicrosoft.com)

  • Katalog-ID (lejer)

  • Applikations-ID (klient-ID)

  • Klienthemmelighed


Advarsel: Af sikkerhedsmæssige årsager skal du sende klientnøglen separat fra de øvrige oplysninger (f.eks. via SMS eller en anden sikker kanal).



Avanceret konfiguration


Advarsel: Udfør ikke nedenstående trin, medmindre du udtrykkeligt er blevet bedt om det af Identum, eller du er en erfaren bruger.


Tildel tilladelser i Exchange Online

Disse tilladelser er kun nødvendige, hvis eAdm eller eFeide skal administrere Exchange Online-funktioner direkte, f.eks. distributionsgrupper eller sikkerhedsgrupper med e-mail-adgang.

  1. Gå til »API-tilladelser « i din app-registrering, og klik på »+ Tilføj en tilladelse«.

  2. Skift til fanen »API'er, som min organisation bruger «.

  3. Søg efter »Office«, og vælg Office 365 Exchange Online.

  4. Vælg »App-tilladelser«.

  5. Vælg den Exchange.ManageAsApp tilladelse og klik Tilføj tilladelser.

  6. Giv administratoren tilladelse til den nye rettighed.

  7. Tildel applikationen rollen »Exchange-modtageradministrator« via panelet »Roller og administratorer« i Entra ID. Dette giver applikationen mulighed for at administrere Exchange-objekter.


Sikkerhedsgrupper med e-mail-adgang:

Håndtering af sikkerhedsgrupper med e-mail-adgang kræver en ekstra rolle („Oprettelse af sikkerhedsgrupper og medlemskab“ i Exchange Online). Det kan være lidt besværligt at konfigurere… Men nedenfor beskriver vi, hvordan man tilføjer den enkelte rolle (du kan bruge brugerdefinerede rollegrupper, hvis du foretrækker det). Se https://learn.microsoft.com/en-us/exchange/permissions-exo/application-rbac for baggrundsinformation og yderligere vejledning:

1. Opret serviceprincipalen i Exchange Online

Find først din applikations objekt-ID i Entra ID, og brug den til at registrere tjenesteenheden i Exchange Online. Dette behøver kun at gøres én gang pr. applikation.

PowerShell
# Make sure you are connected to both services
# Connect-MgGraph -Scopes "Application.Read.All"
# Connect-ExchangeOnline

# --- Enter your Application (Client) ID here ---
$appId = "00000000-0000-0000-0000-000000000000"

# Find the application's details in Entra ID
$sp = Get-MgServicePrincipal -Filter "appId eq '$appId'"

# Create the service principal object within Exchange Online
# The -ErrorAction flag prevents an error if it already exists
New-ServicePrincipal -AppId $sp.AppId -ObjectId $sp.Id -DisplayName $sp.DisplayName -ErrorAction SilentlyContinue
2. Tildel applikationen den enkelte rolle


Brug nu New-ManagementRoleAssignment cmdlet med -App parameter til at tildele rollen direkte til den tjenesteenhed, du netop har oprettet.

PowerShell
# Assign the role directly to the application
# Provide a unique name for the role assignment
New-ManagementRoleAssignment -App $appId -Role "Security Group Creation and Membership" -Name "App_SG_Creation_Membership_Direct_Assignment"

Din applikation har nu de specifikke Exchange Online-tilladelser, der kræves for at administrere e-mail-aktiverede sikkerhedsgrupper.


Certifikatbaseret autentificering

Dette trin er kun nødvendigt, hvis Identum skal køre brugerdefinerede scripts i dit Exchange Online- eller Entra ID-miljø. Dette anvendes typisk til avancerede integrationer og vil blive koordineret direkte med dig.

  1. Der vil blive genereret et selvunderskrevet certifikat. Du vil få vejledning i, hvordan dette gøres.

  2. I applikationsregistreringen skal du gå til »Certifikater og hemmeligheder«.

  3. Vælg fanen »Certifikater «, og klik på »Upload certifikat«.

  4. Upload filen med den offentlige nøgle (.cer, .pem, eller .crt) som du har modtaget.



Bilag: Oversigt over nødvendige tilladelser

I nedenstående tabel findes en oversigt over tilladelserne til Microsoft Graph API samt begrundelsen for, at de er nødvendige.

Tilladelse

Hvad det bruges til

Når det er nødvendigt

User.Read.All

Læs brugerprofiler, der anvendes til at sammenholde Entra ID-konti med eADM-poster og identificere eksisterende konti.

Altid. Hver eneste Entra ID-synkronisering kræver dette, selv i en opsætning, der kun omfatter brugere.

User.ReadWrite.All

Opret, rediger og slet brugerkonti.

Altid, medmindre synkroniseringstrinnet er skrivebeskyttet (kun import, ingen provisionering).

Group.Read.All

Læs om grupper og gruppeegenskaber.

Kræves altid, uanset situation — herunder import af kun brugere uden oprettelse af grupper. Synkroniseringsmodulet læser den fulde gruppeliste ved hver kørsel som et teknisk krav, uafhængigt af om grupper rent faktisk importeres eller eksporteres.

Group.ReadWrite.All

Opret, rediger og slet grupper; bruges også til at aktivere Microsoft Teams for en gruppe.

Påkrævet, hvis gruppeoprettelse eller »Teams-on-group« er aktiveret. Ikke påkrævet ved en opsætning, der kun omfatter brugere — men Group.Read.All Ovenstående er under alle omstændigheder påkrævet.

GroupMember.ReadWrite.All

Tilføj/fjern gruppemedlemmer uden fuld skriveadgang til gruppen.

Valgfrit alternativ til Group.ReadWrite.All hvis eADM kun skal administrere medlemskab, ikke gruppeegenskaber eller ejerskab.

User.EnableDisableAccount.All

Aktivér/deaktiver en brugerkonto (f.eks. ved orlov/tilbagevenden eller afskedigelse).

Kræves kun, hvis genaktivering/deaktivering af kontoen indgår i kundens livscyklusforløb. Er ikke nødvendigt ved almindelig oprettelse/opdatering.

Directory.ReadWrite.All

Udvidede læse- og skrivrettigheder for brugere og grupper; omfatter også gendannelse af en tidligere slettet bruger.

Valgfrit. Kræves kun, hvis gendannelse af midlertidigt slettede konti er omfattet, og kun som et alternativ til User.ReadWrite.All til netop den handling.

AuditLog.Read.All

Vis oplysninger om logonaktivitet (sidste logon) og status for MFA-registrering.

Kræves kun, hvis synkronisering af sidste logon eller MFA-status er konfigureret.

UserAuthenticationMethod.ReadWrite.All

Administrer en brugers godkendelsesmetoder (f.eks. registrere et telefonnummer til MFA, udstede et midlertidigt adgangskort).

Kræves kun, hvis eADM administrerer MFA-metoder eller udsteder midlertidige adgangskort. Giver omfattende kontrol over en brugers loginsikkerhed — gennemgå omhyggeligt, inden du tildeler rettigheden.

Reports.Read.All

Læs rapporter om postkassens størrelse og brug.

Kræves kun, hvis synkronisering af postkassestørrelse er konfigureret.

LicenseAssignment.Read.All (eller Directory.Read.All / Directory.ReadWrite.All)

Læs de tildelte licens-/SKU-oplysninger.

Kræves kun, hvis synkronisering af licensnavn eller licens-ID er konfigureret.

Exchange.ManageAsApp (Exchange Online, ikke Graph)

Administrer distributionslister og sikkerhedsgrupper med e-mail-adgang.

Kræves kun, hvis eADM administrerer e-mailgrupper på Exchange-siden. Kræver en separat rolletildeling i Exchange Online — se Avanceret konfiguration.

Opsætning af Microsoft Teams foregår via en egenskab på en gruppe (Teams aktiveres på en gruppe, som eADM allerede har oprettet), ikke som en selvstændig Team-ressource. Group.ReadWrite.All det er alt, hvad der skal til — ingen separat Teams-tilladelse (Team.Create, Team.ReadBasic.All, TeamTemplates.ReadAll) er nødvendigt.

Anvendelsestilfælde

Tilladelser, der skal gives

Importer kun eksisterende brugere (ingen oprettelse/opdatering/sletning)

User.Read.All og Group.Read.All. Group.Read.All er påkrævet selv i dette tilfælde, hvor der kun læses — synkroniseringsmotoren læser gruppelisten ved hver kørsel, uanset anvendelsesområde.

Brugere med bestemte rettigheder, ingen grupper, ingen genaktivering

User.Read.All, User.ReadWrite.All, Group.Read.All (kræves altid, selv uden gruppesynkronisering)

Hele brugerens livscyklus (oprettelse, opdatering, deaktivering/reaktivering)

Tilføj User.EnableDisableAccount.All

+ Oprettelse af grupper (inkl. Teams-on-group)

Tilføj Group.ReadWrite.All (eller GroupMember.ReadWrite.All (kun for medlemmer)

+ Rapportering af sidste logon eller MFA-status

Tilføj AuditLog.Read.All

+ Styring af MFA-metoder

Tilføj UserAuthenticationMethod.ReadWrite.All (følsomt — skal gennemgås med sikkerhedsteamet)

+ Rapportering af postkassestørrelse

Tilføj Reports.Read.All

+ Rapportering af licenser

Tilføj LicenseAssignment.Read.All

+ Sikkerhedsgrupper og distributionslister med e-mail-funktion

Tilføj Exchange.ManageAsApp + Exchange Online-rolle (se Avanceret konfiguration)

Group.Read.All er altid påkrævet i alle ovenstående anvendelsestilfælde — herunder importen i skrivebeskyttet tilstand — fordi synkroniseringsmotoren af tekniske årsager læser den fulde gruppeliste ved hver kørsel, uanset om der er tale om gruppeoprettelse eller import. En integration, der udelukkende omfatter brugere uden adgang til grupper, er i dag ikke mulig.

Senest opdateret: