Självstudie: Konfigurera OpenText Directory Services för automatisk användaretablering
I den här självstudien beskrivs de steg du behöver utföra i både OpenText Directory Services och Microsoft Entra ID för att konfigurera automatisk användaretablering. När microsoft entra-ID konfigureras etablerar och avetablerar användare och grupper automatiskt till OpenText Directory Services med hjälp av Microsoft Entra-etableringstjänsten. Viktig information om vad den här tjänsten gör, hur den fungerar och vanliga frågor finns i Automatisera användaretablering och avetablering till SaaS-program med Microsoft Entra-ID.
Funktioner som stöds
- Skapa användare i OpenText Directory Services
- Ta bort användare i OpenText Directory Services när de inte behöver åtkomst längre
- Behåll användarattribut synkroniserade mellan Microsoft Entra ID och OpenText Directory Services
- Etablera grupper och gruppmedlemskap i OpenText Directory Services
- Enkel inloggning till OpenText Directory Services (rekommenderas)
Förutsättningar
Scenariot som beskrivs i den här självstudien förutsätter att du redan har följande förutsättningar:
- En Microsoft Entra-klientorganisation
- En av följande roller: Programadministratör, Molnprogramadministratör eller Programägare.
- En OTDS-installation som är tillgänglig via Microsoft Entra-ID.
Steg 1: Planera etableringsdistributionen
- Lär dig mer om hur etableringstjänsten fungerar.
- Ta reda på vem som finns i etableringsomfånget.
- Ta reda på vilka data som ska mappas mellan Microsoft Entra ID och OpenText Directory Services.
Steg 2: Konfigurera OpenText Directory Services för att stödja etablering med Microsoft Entra-ID
Kommentar
Stegen nedan gäller för en Installation av OpenText Directory Services. De gäller inte för OpenText CoreShare- eller OpenText OT2-klienter.
Skapa en dedikerad konfidentiell OAuth-klient.
Ange en lång livslängd för åtkomsttoken.
Ange inga omdirigerings-URL:er. De krävs inte.
OTDS genererar och visar klienthemligheten. Spara klient-ID och klienthemlighet på en säker plats.
Skapa en partition för användare och grupper som ska synkroniseras från Microsoft Entra-ID.
Bevilja administrativa rättigheter till den OAuth-klient som du skapade på den partition som du ska använda för Microsoft Entra-användare och -grupper som synkroniseras.
- Partition –> Åtgärder –> Redigera administratörer
En hemlig token måste hämtas och konfigureras i Microsoft Entra-ID. Alla HTTP-klientprogram kan användas för detta. Nedan visas steg för att hämta med hjälp av Swagger API-programmet som ingår i OTDS.
- I en webbläsare går du till {OTDS URL}/otdsws/oauth2
- Gå till /token och klicka på låsikonen längst upp till höger. Ange OAuth-klient-ID och hemlighet som hämtades tidigare som användarnamn respektive lösenord. Klicka på Auktorisera.
Välj client_credentials för grant_type och klicka på Kör.
Åtkomsttoken i svaret ska användas i fältet Hemlig token i Microsoft Entra-ID.
Steg 3: Lägg till OpenText Directory Services från Microsoft Entra-programgalleriet
Lägg till OpenText Directory Services från Microsoft Entra-programgalleriet för att börja hantera etablering till OpenText Directory Services. Om du tidigare har konfigurerat OpenText Directory Services för enkel inloggning kan du använda samma program. Vi rekommenderar dock att du skapar en separat app när du testar integreringen i början. Lär dig mer om att lägga till ett program från galleriet här.
Steg 4: Definiera vem som ska finnas i omfånget för etablering
Med Microsoft Entra-etableringstjänsten kan du omfångsbegränsa vem som ska etableras baserat på tilldelning till programmet och eller baserat på attribut för användaren/gruppen. Om du väljer att omfånget som ska etableras till din app ska baseras på tilldelning, kan du använda följande steg för att tilldela användare och grupper till programmet. Om du väljer att omfånget endast ska etableras baserat på attribut för användaren eller gruppen, kan du använda ett omfångsfilter enligt beskrivningen här.
Starta i liten skala. Testa med en liten uppsättning användare och grupper innan du distribuerar till alla. När etableringsomfånget har angetts till tilldelade användare och grupper, kan du kontrollera detta genom att tilldela en eller två användare eller grupper till appen. När omfånget är inställt på alla användare och grupper, kan du ange ett attributbaserat omfångsfilter.
Om du behöver ytterligare roller kan du uppdatera programmanifestet för att lägga till nya roller.
Steg 5: Konfigurera automatisk användaretablering till OpenText Directory Services
Det här avsnittet vägleder dig genom stegen för att konfigurera Microsoft Entra-etableringstjänsten för att skapa, uppdatera och inaktivera användare och/eller grupper i TestApp baserat på användar- och/eller grupptilldelningar i Microsoft Entra-ID.
Så här konfigurerar du automatisk användaretablering för OpenText Directory Services i Microsoft Entra-ID:
Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.
Bläddra till Identity>Applications Enterprise-program>
I programlistan väljer du OpenText Directory Services.
Välj fliken Etablering.
Ange Etableringsläge som Automatiskt.
Under avsnittet Administratörsautentiseringsuppgifter anger du url:en för OpenText Directory Services-klientorganisationen
- Icke-specifik klient-URL: {OTDS URL}/scim/{partitionName}
- Specifik klient-URL: {OTDS URL}/otdstenant/{tenantID}/scim/{partitionName}
Ange den hemliga token som hämtats från steg 2. Klicka på Testa Anslut ion för att se till att Microsoft Entra ID kan ansluta till OpenText Directory Services. Om anslutningen misslyckas kontrollerar du att ditt OpenText Directory Services-konto har administratörsbehörighet och försöker igen.
I fältet E-postavisering anger du e-postadressen till den person eller grupp som ska ta emot meddelanden om etableringsfel. Markera sedan kryssrutan Skicka ett e-postmeddelande när ett fel uppstår.
Välj Spara.
Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-användare till OpenText Directory Services.
Granska de användarattribut som synkroniseras från Microsoft Entra-ID till OpenText Directory Services i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha användarkontona i OpenText Directory Services för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet måste du se till att OpenText Directory Services-API:et stöder filtrering av användare baserat på det attributet. Välj knappen Spara för att checka in eventuella ändringar.
Attribut Typ userName String aktiv Booleskt displayName String rubrik String emails[type eq "work"].value String preferredLanguage String name.givenName String name.familyName String name.formatted String addresses[type eq "work"].formatted String addresses[type eq "work"].streetAddress String addresses[type eq "work"].locality String addresses[type eq "work"].region String addresses[type eq "work"].postalCode String addresses[type eq "work"].country String phoneNumbers[type eq "work"].value String phoneNumbers[type eq "mobile"].value String phoneNumbers[type eq "fax"].value String externalId String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager Referens Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-grupper till OpenText Directory Services.
Granska de gruppattribut som synkroniseras från Microsoft Entra-ID till OpenText Directory Services i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha grupperna i OpenText Directory Services för uppdateringsåtgärder. Välj knappen Spara för att checka in eventuella ändringar.
Attribut Typ displayName String externalId String medlemmar Referens Information om hur du konfigurerar omfångsfilter finns i följande instruktioner i självstudien för omfångsfilter.
Om du vill aktivera Microsoft Entra-etableringstjänsten för OpenText Directory Services ändrar du etableringsstatusen till På i avsnittet Inställningar.
Definiera de användare och/eller grupper som du vill etablera till OpenText Directory Services genom att välja önskade värden i Omfång i avsnittet Inställningar.
När du är redo att etablera klickar du på Spara.
Åtgärden startar den initiala synkroniseringscykeln för alla användare och grupper som har definierats i Omfång i avsnittet Inställningar. Den inledande cykeln tar längre tid att utföra än efterföljande cykler, som inträffar ungefär var 40:e minut så länge Microsoft Entra-etableringstjänsten körs.
Steg 6: Övervaka distributionen
När du har konfigurerat etableringen använder du följande resurser till att övervaka distributionen:
- Använd etableringsloggarna för att se vilka användare som har etablerats och vilka som har misslyckats
- Kontrollera förloppsindikatorn för att se status för etableringscykeln och hur nära den är att slutföras
- Om etableringskonfigurationen verkar innehålla fel, kommer programmet att placeras i karantän. Läs mer om karantänstatus här.
Ytterligare resurser
- Hantera användarkontoetablering för Enterprise-appar
- Vad är programåtkomst och enkel inloggning med Microsoft Entra-ID?