Konfigurieren von OpenText Directory Services für die automatische Benutzerbereitstellung mit Microsoft Entra-ID

In diesem Artikel werden die Schritte beschrieben, die Sie sowohl in OpenText Directory Services als auch in microsoft Entra ID ausführen müssen, um die automatische Benutzerbereitstellung zu konfigurieren. Bei der Konfiguration stellt Microsoft Entra mithilfe des Microsoft Entra-Bereitstellungsdiensts automatisch Benutzer*innen und Gruppen für OpenText Directory Service bereit und hebt die Bereitstellung wieder auf. Wichtige Informationen darüber, was dieser Dienst tut, wie er funktioniert, und Antworten auf häufig gestellte Fragen finden Sie unter Automatisierte Benutzerbereitstellung und -deaktivierung für SaaS-Anwendungen mit Microsoft Entra ID.

Unterstützte Funktionen

• Erstellen von Benutzern in OpenText Directory Services
• Entfernen von Benutzern in OpenText Directory Services, wenn sie keinen Zugriff mehr benötigen
• Synchronisieren von Benutzerattributen zwischen Microsoft Entra ID und OpenText Directory Services
• Bereitstellen von Gruppen und Gruppenmitgliedschaften in OpenText Directory Services
• Einmaliges Anmelden bei OpenText Directory Services (empfohlen)

Voraussetzungen

In diesem Artikel wird davon ausgegangen, dass Sie bereits über die folgenden Voraussetzungen verfügen:

• Ein Microsoft Entra-Benutzerkonto mit einem aktiven Abonnement. Wenn Sie noch kein Konto besitzen, können Sie kostenlos ein Konto erstellen.
• Eine der folgenden Rollen:
  • Anwendungsadministrator
  • Cloudanwendungsadministrator
  • Anwendungsbesitzer.

• Eine OTDS-Installation, auf die über Microsoft Entra ID zugegriffen werden kann.

Schritt 1: Planen Sie Ihren Bereitstellungsprozess

1. Erfahren Sie , wie der Bereitstellungsdienst funktioniert.
2. Identifizieren Sie, wer im Umfang der Bereitstellung enthalten ist.
3. Bestimmen Sie, welche Daten zwischen Microsoft Entra ID und OpenText Directory Services zugeordnet werden sollen.

Schritt 2: Konfigurieren von OpenText Directory Services zur Unterstützung der Bereitstellung mit Microsoft Entra ID

Hinweis

Die nachstehenden Schritte gelten für eine OpenText Directory Services-Installation. Sie gelten nicht für OpenText CoreShare- oder OpenText OT2-Mandanten.

1. Erstellen Sie einen dedizierten vertraulichen OAuth-Client.

2. Legen Sie eine lange Lebensdauer des Zugriffstokens fest.

   

3. geben Sie keine Umleitungs-URLs an. Sie sind nicht erforderlich.

4. OTDS generiert und zeigt den geheimen Clientschlüssel an. Speichern Sie die Client-ID und den geheimen Clientschlüssel an einem sicheren Speicherort.

   

5. Erstellen Sie eine Partition für die zu synchronisierenden Microsoft Entra ID-Benutzer und -Gruppen.

   

6. Gewähren Sie dem OAuth-Client, den Sie auf der Partition erstellt haben, die Sie für die Synchronisation der Microsoft Entra-Benutzer und -Gruppen verwenden, Administrationsrechte.

   • Partition -> Aktionen -> Administratoren bearbeiten

   

7. Ein geheimes Token muss abgerufen und in Microsoft Entra ID konfiguriert werden. Dazu kann eine beliebige HTTP-Clientanwendung verwendet werden. Im Folgenden finden Sie die Schritte zum Abrufen des Tokens mithilfe der in OTDS enthaltenen Swagger-API-Anwendung.

   • Wechseln Sie in einem Webbrowser zu „{OTDS-URL}/otdsws/oauth2“.
   • Wechseln Sie zu /token, und wählen Sie oben rechts das Sperrsymbol aus. Geben Sie die OAuth-Client-ID und den zuvor abgerufenen geheimen Schlüssel als Benutzernamen bzw. als Kennwort ein. Wählen Sie "Autorisieren" aus.

   

8. Wählen Sie client_credentials für die grant_type aus, und wählen Sie "Ausführen" aus.

   

9. Das Zugriffstoken in der Antwort sollte im Feld "Geheimes Token " in der Microsoft Entra-ID verwendet werden.

   

Schritt 3: Hinzufügen von OpenText Directory Services aus dem Microsoft Entra-Anwendungskatalog

Fügen Sie OpenText Directory Services aus dem Microsoft Entra-Anwendungskatalog hinzu, um mit dem Verwalten der Bereitstellung für OpenText Directory Services zu beginnen. Wenn Sie OpenText Directory Services zuvor für einmaliges Anmelden (Single Sign-On, SSO) eingerichtet haben, können Sie dieselbe Anwendung verwenden. Es wird jedoch empfohlen, beim anfänglichen Testen der Integration eine separate App zu erstellen. Weitere Informationen zum Hinzufügen einer Anwendung aus dem Katalog finden Sie hier.

Schritt 4: Definieren, wer in die Bereitstellung einbezogen werden soll

Mit dem Microsoft Entra-Bereitstellungsdienst können Sie festlegen, wer basierend auf der Zuweisung zur Anwendung oder basierend auf Attributen des Benutzers oder der Gruppe bereitgestellt wird. Wenn Sie festlegen möchten, wer basierend auf der Zuweisung für Ihre App bereitgestellt wird, können Sie die Schritte zum Zuweisen von Benutzern und Gruppen zur Anwendung verwenden. Wenn Sie festlegen möchten, wer basierend allein auf den Attributen des Benutzers oder der Gruppe bereitgestellt wird, können Sie einen Bereichsfilter verwenden.

• Beginnen Sie klein. Testen Sie mit einer kleinen Anzahl von Benutzern und Gruppen, bevor Sie es auf alle anwenden. Wenn der Bereich für die Bereitstellung auf zugewiesene Benutzer und Gruppen festgelegt ist, können Sie dies steuern, indem Sie der App einen oder zwei Benutzer oder Gruppen zuweisen. Wenn der Bereich auf alle Benutzer und Gruppen festgelegt ist, können Sie einen attributbasierten Bereichsdefinitionsfilter angeben.

• Wenn Sie zusätzliche Rollen benötigen, können Sie das Anwendungsmanifest aktualisieren, um neue Rollen hinzuzufügen.

Schritt 5: Konfigurieren der automatischen Benutzerbereitstellung für OpenText Directory Services

Dieser Abschnitt führt Sie durch die Schritte zum Konfigurieren des Microsoft Entra-Bereitstellungsdiensts zum Erstellen, Aktualisieren und Deaktivieren von Benutzern und/oder Gruppen in TestApp basierend auf Benutzer- und/oder Gruppenzuweisungen in Microsoft Entra ID.

So konfigurieren Sie die automatische Benutzerbereitstellung für OpenText Directory Services in Microsoft Entra ID:

1. Melden Sie sich mindestens als Cloudanwendungsadministrator beim Microsoft Entra Admin Center an.

2. Navigieren Sie zu Entra ID>Enterprise-Apps

   

3. Wählen Sie in der Anwendungsliste "OpenText Directory Services" aus.

   

4. Wählen Sie die Registerkarte "Bereitstellung" aus .

   

5. Legen Sie den Bereitstellungsmodus auf "Automatisch" fest.

   

6. Geben Sie im Abschnitt "Administratoranmeldeinformationen " Ihre OpenText Directory Services-Mandanten-URL ein.

   • Allgemeine Mandanten-URL: {OTDS-URL}/scim/{Partitionsname}
   • Spezifische Mandanten-URL: {OTDS-URL}/otdstenant/{Mandanten-ID}/scim/{Partitionsname}

7. Geben Sie das geheime Token ein, das Sie in Schritt 2 abgerufen haben. Wählen Sie "Verbindung testen" aus, um sicherzustellen, dass die Microsoft Entra-ID eine Verbindung mit OpenText Directory Services herstellen kann. Wenn die Verbindung nicht hergestellt werden kann, vergewissern Sie sich, dass Ihr OpenText Directory Services-Konto über Administratorberechtigungen verfügt, und versuchen Sie es noch mal.

   

8. Geben Sie im Feld " Benachrichtigungs-E-Mail " die E-Mail-Adresse einer Person oder Gruppe ein, die die Bereitstellungsfehlerbenachrichtigungen erhalten soll, und aktivieren Sie das Kontrollkästchen " E-Mail-Benachrichtigung senden", wenn ein Fehler auftritt .

   

9. Wählen Sie "Speichern" aus.

10. Wählen Sie im Abschnitt "Zuordnungen " die Option "Microsoft Entra-Benutzer mit OpenText Directory Services synchronisieren" aus.

11. Überprüfen Sie die Benutzerattribute, die von Microsoft Entra ID mit OpenText Directory Services synchronisiert werden, im Abschnitt "Attributzuordnung ". Die Attribute, die als Übereinstimmende Eigenschaften ausgewählt wurden, werden verwendet, um die Benutzerkonten in den OpenText Directory Services für Aktualisierungsvorgänge abzugleichen. Wenn Sie das übereinstimmende Zielattribute ändern möchten, müssen Sie sicherstellen, dass die OpenText Directory Services-API das Filtern von Benutzern basierend auf diesem Attribut unterstützt. Wählen Sie die Schaltfläche " Speichern " aus, um änderungen zu übernehmen.

    Merkmal	Typ
    Nutzername	Schnur
    aktiv	Boolescher Typ (Boolean)
    Anzeigename	Schnur
    Titel	Schnur
    E-Mails[Typ eq "Arbeit"].Wert	Schnur
    bevorzugteSprache	Schnur
    Name.Vorname	Schnur
    Name.Familienname	Schnur
    name.formatiert	Schnur
    addresses[type eq "Arbeit"].formatted	Schnur
    addresses[typ eq "work"].strassenAdresse	Schnur
    addresses[type == "work"].locality	Schnur
    addresses[type eq "arbeit"].region	Schnur
    addressen[typ eq "arbeit"].postleitzahl	Schnur
    addresses[type eq "arbeit"].land	Schnur
    phoneNumbers[type eq "Arbeit"].value	Schnur
    phoneNumbers[typ ist gleich "mobil"].wert	Schnur
    Phone Numbers [Typ entspricht "fax"]. Wert	Schnur
    externalId	Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:Mitarbeiternummer	Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:Abteilung	Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Benutzer:Manager	Referenz

12. Wählen Sie im Abschnitt "Zuordnungen " die Option "Microsoft Entra-Gruppen mit OpenText Directory Services synchronisieren" aus.

13. Überprüfen Sie die Gruppenattribute, die von Microsoft Entra ID mit OpenText Directory Services synchronisiert werden, im Abschnitt "Attributzuordnung ". Die als Matching-Eigenschaften ausgewählten Attribute werden verwendet, um die Gruppen in OpenText Directory Services für Aktualisierungsvorgänge abzugleichen. Wählen Sie die Schaltfläche " Speichern " aus, um änderungen zu übernehmen.

    Merkmal	Typ
    Anzeigename	Schnur
    externalId	Schnur
    Mitglieder	Referenz

14. Informationen zum Konfigurieren von Bereichsfiltern finden Sie in den folgenden Anweisungen im Bereichsfilterartikel.

15. Um den Microsoft Entra-Bereitstellungsdienst für OpenText Directory-Dienste zu aktivieren, ändern Sie den Bereitstellungsstatus im Abschnitt "Einstellungen" in "Ein".

    

16. Definieren Sie die Benutzer und/oder Gruppen, die Sie für OpenText Directory Services bereitstellen möchten, indem Sie die gewünschten Werte im Bereich im Abschnitt "Einstellungen" auswählen.

    

17. Wenn Sie zur Bereitstellung bereit sind, wählen Sie Speichern aus.

    

Dieser Vorgang startet den anfänglichen Synchronisierungszyklus aller Benutzer und Gruppen, die im Bereich im Abschnitt Einstellungen definiert sind. Der anfängliche Zyklus dauert länger als nachfolgende Zyklen, die ungefähr alle 40 Minuten auftreten, solange der Microsoft Entra-Bereitstellungsdienst ausgeführt wird.

Schritt 6: Überwachen der Bereitstellung

Nachdem Sie die Bereitstellung konfiguriert haben, verwenden Sie die folgenden Ressourcen, um Ihre Bereitstellung zu überwachen:

1. Verwenden Sie die Bereitstellungsprotokolle , um zu ermitteln, welche Benutzer erfolgreich oder erfolglos bereitgestellt werden.
2. Überprüfen Sie den Fortschrittsbalken, um den Status des Bereitstellungszyklus anzuzeigen und herauszufinden, wie nah er an der Fertigstellung ist.
3. Wenn sich die Bereitstellungskonfiguration in einem fehlerhaften Zustand zu befinden scheint, wird die Anwendung unter Quarantäne gestellt. Weitere Informationen zu Quarantänezuständen finden Sie im Artikel zum Anwendungsbereitstellungs-Quarantänestatus.

Weitere Ressourcen

• Verwalten der Bereitstellung von Benutzerkonten für Enterprise-Apps
• Was ist Anwendungszugriff und einmaliges Anmelden mit der Microsoft Entra-ID?

Verwandte Inhalte

• Erfahren Sie, wie Sie Protokolle überprüfen und Berichte zu Bereitstellungsaktivitäten abrufen.