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 ID mithilfe des Microsoft Entra-Bereitstellungsdienstes automatisch Benutzer*innen und Gruppen für OpenText Directory Services 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)

Hinweis

Diese Integration kann auch über die Microsoft Entra US Government-Cloud-Umgebung verwendet werden. Sie finden diese Anwendung im Microsoft Entra-Anwendungskatalog für die US Government-Cloud. Sie können sie auf die gleiche Weise wie in der öffentlichen Cloud konfigurieren.

Voraussetzungen

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

  • 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. Geben Sie keine Umleitungs-URLs an. Sie sind nicht erforderlich.

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

    Geheimer Clientschlüssel

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

    Partitionsseite

  5. 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

    Administratorseite

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.

    Unternehmensanwendungen-Dashboard

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

    Der Link

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

    Registerkarte

  5. Wählen Sie + Neue Konfiguration aus.

    Screenshot: Registerkarte „Bereitstellung“, Bereitstellungsmodus „Automatisch“

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

    • Nicht spezifische Mandanten-URL: {OTDS URL}/scim/{partitionName}
    • Spezifische Mandanten-URL: {OTDS URL}/otdstenant/{tenantID}/scim/{partitionName}
  7. Wählen Sie die OAuth2-Clientanmeldeinformationen als Authentifizierungsmethode aus.

    1. Geben Sie die Client-ID und den geheimen Clientschlüssel ein, der aus Schritt 2 abgerufen wurde.

    2. Wählen Sie "Verbindung testen" aus, um sicherzustellen, dass die Microsoft Entra-ID eine Verbindung mit OpenText Directory Services herstellen kann.

    3. 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.

      Screenshot des Tokens.

  8. Wählen Sie "Erstellen" aus, um Ihre Konfiguration zu erstellen.

  9. Wählen Sie auf der Seite "Übersicht" die Option "Eigenschaften" aus.

  10. Wählen Sie das Symbol "Bearbeiten" aus, um die Eigenschaften zu bearbeiten. Aktivieren Sie Benachrichtigungs-E-Mails, und stellen Sie eine E-Mail bereit, um Quarantäne-E-Mails zu empfangen. Aktivieren Sie die Verhinderung versehentlicher Löschungen. Wählen Sie Übernehmen aus, um die Änderungen zu speichern.

    Screenshot der Bereitstellungseigenschaften.

  11. Wählen Sie im linken Bereich die Attributzuordnung aus, und wählen Sie Benutzer aus.

  12. Ü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
  1. Wählen Sie "Gruppen" aus.

  2. Ü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
  3. Informationen zum Konfigurieren von Bereichsfiltern finden Sie in den folgenden Anweisungen im Bereichsfilterartikel.

  4. Verwenden Sie die On-Demand-Bereitstellung , um die Synchronisierung mit einer kleinen Anzahl von Benutzern zu überprüfen, bevor Sie die Bereitstellung in Ihrer Organisation umfassender durchführen.

  5. Wenn Sie bereit für die Bereitstellung sind, wählen Sie auf der Seite "Übersicht" die Option "Bereitstellung starten" aus.

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