Den här guiden beskriver hur man förbereder Microsoft Entra ID för integration med eAdm eller eFeide. Processen innebär att man skapar en applikationsregistrering och sedan tilldelar nödvändiga behörigheter.
Du kan lugnt ignorera avsnittet om avancerad konfiguration om du inte fått särskilda instruktioner från Identum.
Del 1: Skapa en registrering för Entra ID-applikationen
-
Logga in på Azure-portalen med ett administratörskonto.
-
Gå till Entra ID.
-
Välj Appregistrations i menyn till vänster och klicka sedan på + New registration.
-
På sidan "Register an application" (Registrera en ansökan) gör du följande inställningar:
-
Namn: Ange ett beskrivande namn för applikationen. Till exempel:
Identum eFeide-eAdm User and Group Management. -
Kontotyper som stöds: Välj Accounts in this organizational directory only (Single tenant).
-
Omdirigera URI: Lämna detta fält tomt.
-
-
Klicka på Register för att skapa ansökan.
-
När applikationen har skapats kopierar du Application (client) ID och Directory (tenant) ID från applikationens "Overview"-sida. Spara dessa värden för senare användning.
Varning: Använd inte snedstreck (/) i applikationsnamnet, eftersom detta kan orsaka problem i Entra ID.
Del 2: Tilldela API-behörigheter
Därefter måste du ge programmet de API-behörigheter som krävs för att hantera användare och grupper.
-
I din nya programregistrering navigerar du till API-behörigheter i menyn till vänster.
-
Klicka på + Lägg till en behörighet.
-
Välj Microsoft Graph.
-
Välj Programbehörigheter.
-
Lägg till följande behörigheter:
-
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
-
-
Lägg också till följande behörigheter om de är relevanta för dina specifika behov:
-
AuditLog.Read.All: Krävs om du vill synkroniseralastLogonTimeStamptilldela eAdm, eller synkronisera statusen för MFA-registreringen. -
UserAuthenticationMethod.ReadWrite.All: Krävs om eAdm ska hantera MFA-metoder för användare. -
Reports.Read.All: Krävs om eAdm ska synkronisera postlådans storlek till eAdm. -
LicenseAssignment.Read.All: Krävs om eAdm ska synkronisera tilldelade licensnamn/ID:n till eAdm.
-
-
När du har lagt till behörigheterna klickar du på Lägg till behörigheter.
-
På skärmen API-behörigheter klickar du på Grant admin consent for [Your Tenant Name] och bekräftar när du uppmanas till det.
Observera: De behörigheter som anges i fetstil är obligatoriska för grundläggande integration. De övriga krävs för specifika, vanliga scenarier.
Del 3: Skapa en klienthemlighet
En klienthemlighet är ett lösenord som programmet använder för att autentisera sig.
-
Navigera till Certifikat & hemligheter i menyn till vänster.
-
Klicka på + Ny klienthemlighet.
-
Ange en beskrivning för hemligheten och ställ in utgångsperioden till 24 månader.
-
Klicka på Lägg till.
-
Kopiera omedelbart värdet för den nya klienthemligheten från fältet Value.
Varning för detta: Klientens hemliga värde visas endast i sin helhet omedelbart efter skapandet. Om du inte kopierar det nu måste du skapa ett nytt. Förvara detta värde på ett säkert sätt.
Obs: Om Privileged Identity Management (PIM) är aktivt i din miljö kanske du inte kan ange ett fast utgångsdatum.
Del 4: Tilldela en administratörsroll
För att utföra känsliga åtgärder som att ändra lösenord eller uppdatera användares telefonnummer behöver programmet en administrativ roll.
-
I Azure-portalen går du till Entra ID.
-
Välj Roller och administratörer.
-
Leta upp och välj rollen User Administrator.
-
Klicka på Lägg till uppdrag.
-
Sök efter och välj det program som du skapade tidigare (t.ex,
Identum eFeide-eAdm User and Group Management). -
På nästa skärm ställer du in Tilldelningstyp till Aktiv och anger en motivering, t.ex. "Krävs för att eFeide ska kunna hantera användarlösenord".
-
Klicka på Assign för att slutföra rolltilldelningen.
Obs: Om du använder rolltilldelningsbara grupper för alla användare som hanteras av eFeide eller eAdm, kräver programmet rollen Privileged Authentication Administrator istället. Vänligen se: 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: Skicka information till Identum
När konfigurationen är klar måste du skicka följande information till Identum för att slutföra installationen:
-
Tenantens namn (t.ex.,
yourcompany.onmicrosoft.com) -
Directory (Tenant) ID
-
Applikation (klient) ID
-
Klienthemlighet
Varning för detta: Av säkerhetsskäl bör du skicka klienthemligheten separat från övrig information (t.ex. via SMS eller annan säker kanal).
Avancerad konfiguration
Varning för detta: Utför inte följande steg om du inte uttryckligen har blivit instruerad att göra det av Identum eller om du inte är en expertanvändare.
Tilldela behörigheter i Exchange Online
Dessa behörigheter krävs endast om eAdm eller eFeide ska hantera Exchange Online-funktioner direkt, t.ex. distributionsgrupper eller e-postaktiverade säkerhetsgrupper.
-
I din programregistrering går du till API-behörigheter och klickar på + Lägg till en behörighet.
-
Byt till fliken API:er som min organisation använder.
-
Sök efter "Office" och välj Office 365 Exchange Online.
-
Välj Programbehörigheter.
-
Välj den
Exchange.ManageAsAppbehörighet och klicka på Lägg till behörigheter. -
Ge administratörsgodkännande för den nya behörigheten.
-
Tilldela applikationen rollen ”Exchange-mottagaradministratör” via panelen ”Roller och administratörer” i Entra ID. Detta gör det möjligt för applikationen att hantera Exchange-objekt.
Mail-aktiverade säkerhetsgrupper:
För att hantera säkerhetsgrupper med e-postfunktion krävs en ytterligare roll (”Security Group Creation and Membership” i Exchange Online). Det kan vara lite krångligt att konfigurera detta... Men nedan beskriver vi hur man lägger till den enskilda rollen (du kan använda anpassade rollgrupper om du föredrar det). Se https://learn.microsoft.com/en-us/exchange/permissions-exo/application-rbac för bakgrundsinformation och ytterligare instruktioner:
1. Skapa Service Principal i Exchange Online
Börja med att ta reda på din applikations objekt-ID från Entra ID och använd det för att registrera tjänsteenheten i Exchange Online. Detta behöver endast göras en gång per applikation.
# 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. Tilldela den enskilda rollen till applikationen
Nu kan du använda New-ManagementRoleAssignment cmdlet med kommandot -App för att tilldela rollen direkt till den serviceprincipal som du just har skapat.
# 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"
Ditt program har nu de specifika Exchange Online-behörigheterna för att hantera e-postaktiverade säkerhetsgrupper.
Certifikatbaserad autentisering
Detta steg är endast nödvändigt om Identum behöver köra anpassade skript mot din Exchange Online- eller Entra ID-miljö. Detta används vanligtvis för avancerade integrationer och kommer att samordnas direkt med dig.
-
Ett självsignerat certifikat kommer att genereras. Du kommer att få instruktioner om hur detta görs.
-
I applikationsregistreringen navigerar du till Certifikat & hemligheter.
-
Välj fliken Certifikat och klicka på Ladda upp certifikat.
-
Ladda upp filen med den offentliga nyckeln (
.cer,.pem, eller.crt) som tillhandahålls dig.
Bilaga: Genomgång av nödvändiga behörigheter
I följande tabell beskrivs behörigheterna för Microsoft Graph API och anledningen till att de krävs.
|
Tillstånd |
Vad det används till |
När det krävs |
|---|---|---|
|
|
Läs användarprofiler som används för att jämföra Entra ID-konton med eADM-poster och identifiera befintliga konton. |
Alltid. Varje Entra ID-synkronisering kräver detta, även i en konfiguration som endast omfattar användare. |
|
|
Skapa, uppdatera och ta bort användarkonton. |
Alltid, såvida inte synkroniseringssteget är skrivskyddat (endast import, ingen tilldelning). |
|
|
Läs om grupper och gruppegenskaper. |
Krävs alltid, i alla scenarier – även vid en import som endast omfattar användare utan grupphantering. Synkroniseringsmotorn läser in hela grupplistan vid varje körning av tekniska skäl, oavsett om grupper faktiskt importeras eller exporteras. |
|
|
Skapa, uppdatera och ta bort grupper; används även för att aktivera Microsoft Teams för en grupp. |
Krävs om gruppkonfigurering eller Teams-on-group är aktiverat. Krävs inte vid en konfiguration som endast omfattar användare — men |
|
|
Lägg till/ta bort gruppmedlemmar utan fullständig skrivbehörighet för gruppen. |
Ett valfritt alternativ till |
|
|
Aktivera/inaktivera ett användarkonto (t.ex. vid ledighet/återkomst eller uppsägning). |
Krävs endast om återaktivering/avaktivering av kontot ingår i kundens livscykel. Behövs inte vid vanlig skapande/uppdatering. |
|
|
Utökade läs- och skrivrättigheter för användare och grupper; omfattar även återställning av en tidigare raderad användare. |
Valfritt. Behövs endast om återställning av tillfälligt raderade konton ingår i tillämpningsområdet, och endast som ett alternativ till |
|
|
Läs inloggningsaktivitet (senaste inloggning) och status för MFA-registrering. |
Krävs endast om synkronisering av senaste inloggning eller MFA-status är konfigurerad. |
|
|
Hantera en användares autentiseringsmetoder (t.ex. registrera ett telefonnummer för MFA, utfärda ett tillfälligt åtkomstkort). |
Krävs endast om eADM hanterar MFA-metoder eller utfärdar tillfälliga åtkomstkort. Ger omfattande kontroll över en användares inloggningssäkerhet – granska noggrant innan du beviljar behörigheten. |
|
|
Läs rapporter om postlådans storlek och användning. |
Krävs endast om synkronisering av postlådans storlek har konfigurerats. |
|
|
Läs in information om tilldelad licens/SKU. |
Krävs endast om synkronisering av licensnamn eller licens-ID har konfigurerats. |
|
|
Hantera distributionslistor och e-postaktiverade säkerhetsgrupper. |
Krävs endast om eADM hanterar e-postgrupper på Exchange-sidan. Kräver en separat rolltilldelning i Exchange Online – se Avancerad konfiguration. |
Konfigurationen av Microsoft Teams sker via en egenskap i en grupp (Teams aktiveras i en grupp som eADM redan har skapat), inte som en fristående Teams-resurs. Group.ReadWrite.All det räcker med det – ingen separat behörighet för Teams (Team.Create, Team.ReadBasic.All, TeamTemplates.ReadAll) krävs.
Rekommenderade behörighetspaket efter användningsfall
|
Användningsfall |
Behörigheter som ska beviljas |
|---|---|
|
Importera endast befintliga användare (inga funktioner för att skapa, uppdatera eller ta bort) |
|
|
Användare med behörighet, inga grupper, ingen återaktivering |
|
|
Hela användarens livscykel (skapa, uppdatera, inaktivera/återaktivera) |
Lägg till |
|
+ Gruppkonfiguration (inkl. Teams-on-group) |
Lägg till |
|
+ Rapportering av senaste inloggning eller MFA-status |
Lägg till |
|
+ Hantering av MFA-metoder |
Lägg till |
|
+ Rapportering av postlådans storlek |
Lägg till |
|
+ Rapportering av licenser |
Lägg till |
|
+ Säkerhetsgrupper och distributionslistor med e-postfunktion |
Lägg till |
Group.Read.All krävs alltid i alla ovanstående användningsfall – inklusive fallet med skrivskyddad import – eftersom synkroniseringsmotorn av tekniska skäl läser in hela grupplistan vid varje körning, oavsett om det gäller grupptilldelning eller import. En integration som strikt endast omfattar användare, utan någon tillgång till grupper, är för närvarande inte möjlig.