Konfigurieren von Clarizen One für die automatische Benutzerbereitstellung mit Microsoft Entra ID

In diesem Artikel werden die Schritte beschrieben, die Sie sowohl in Clarizen One als auch in Microsoft Entra ID ausführen müssen, um die automatische Benutzerbereitstellung zu konfigurieren. Wenn konfiguriert, stellt Microsoft Entra ID Benutzer und Gruppen mithilfe des Microsoft Entra-Bereitstellungsdiensts automatisch an und entfernt sie auch von Clarizen One. Informationen dazu, was dieser Dienst bietet, wie er funktioniert und häufig gestellte Fragen finden Sie unter Automatisieren der Benutzerbereitstellung und -entfernung für SaaS-Anwendungen mit Microsoft Entra ID.

Unterstützte Funktionen

  • Erstellen von Benutzern in Clarizen One
  • Entfernen Sie Benutzer in Clarizen One, wenn sie nicht mehr access benötigen.
  • Benutzerattribute zwischen Microsoft Entra ID und Clarizen One synchronisieren.
  • Bereitstellen von Gruppen und Gruppenmitgliedschaften in Clarizen One
  • Single Sign-On (SSO) bei Clarizen One wird empfohlen.

Voraussetzungen

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

Schritt 1: Planen der Bereitstellung

  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 Clarizen One abgeglichen werden sollen.

Schritt 2: Konfigurieren von Clarizen One zur Unterstützung der Bereitstellung mit Microsoft Entra ID

  1. Wählen Sie entsprechend Ihrer Clarizen One-Umgebung und dem Rechenzentrum eine der vier folgenden Mandanten-URLs aus:

    • Rechenzentrum „US Production“: https://servicesapp2.clarizen.com/scim/v2
    • Rechenzentrum „EU Production“: https://serviceseu1.clarizen.com/scim/v2
    • Rechenzentrum „US Sandbox“: https://servicesapp.clarizentb.com/scim/v2
    • Rechenzentrum „EU Sandbox“: https://serviceseu.clarizentb.com/scim/v2
  2. Generieren Sie einen API-Schlüssel. Dieser Wert wird im Feld "Geheimes Token " auf der Registerkarte "Bereitstellung " Ihrer Clarizen One-Anwendung eingegeben.

Fügen Sie Clarizen One aus dem Microsoft Entra-Anwendungskatalog hinzu, um mit dem Verwalten der Bereitstellung in Clarizen One zu beginnen. Wenn Sie Clarizen One zuvor für einmaliges Anmelden (SSO) eingerichtet haben, können Sie dieselbe Anwendung verwenden. Wenn Sie die Integration anfänglich testen, erstellen Sie eine separate App. Weitere Informationen zum Hinzufügen einer Anwendung aus dem Katalog finden Sie unter Hinzufügen einer Anwendung zu Ihrem Microsoft Entra-Mandanten.

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, wer basierend auf der Zuweisung für Ihre App bereitgestellt wird, können Sie die Schritte verwenden, um Benutzer und Gruppen zu einer Anwendung zuzuweisen. Wenn Sie festlegen möchten, für wen die Bereitstellungen ausschließlich basierend auf den Attributen des Benutzers oder der Gruppe erfolgen, können Sie einen Bereichsfilter verwenden.

  • Fangen Sie klein an. 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. Ist der Bereich auf alle Benutzer und Gruppen festgelegt, können Sie einen attributbasierten Bereichsfilter 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 Clarizen One

In diesem Abschnitt führt Sie durch die Schritte zum Konfigurieren des Microsoft Entra-Bereitstellungsdienstes, um Benutzer oder Gruppen in TestApp basierend auf den Benutzer- oder Gruppenzuweisungen in Microsoft Entra ID zu erstellen, zu aktualisieren und zu deaktivieren.

Konfigurieren der automatischen Benutzerbereitstellung für Clarizen One in Microsoft Entra ID

  1. Melden Sie sich beim Microsoft Entra Admin Center als mindestens ein Cloud-Anwendungsadministrator an.

  2. Navigieren Sie zu Entra ID>Enterprise-Apps.

    Screenshot des Bereichs

  3. Wählen Sie in der Anwendungsliste Clarizen One aus.

    Screenshot, der den Clarizen One-Link in der Liste

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

    Screenshot: Registerkarte „Bereitstellung“

  5. Setze + Neue Konfiguration.

    Screenshot: Registerkarte „Bereitstellung“, Bereitstellungsmodus „Automatisch“

  6. Geben Sie im Feld "Mandanten-URL " Ihre Clarizen One-Mandanten-URL und das geheime Token ein. Wählen Sie Test-Verbindung aus, um sicherzustellen, dass Microsoft Entra ID eine Verbindung mit Clarizen One herstellen kann. Wenn die Verbindung fehlschlägt, stellen Sie sicher, dass Ihr Clarizen One-Konto über die erforderlichen Administratorberechtigungen verfügt, und versuchen Sie es erneut.

    Screenshot der Bereitstellungstestverbindung.

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

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

  9. Wählen Sie den Bleistift 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.

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

  11. Überprüfen Sie die Benutzerattribute, die aus Microsoft Entra ID mit Clarizen One synchronisiert werden, im Abschnitt Attribute-Mapping. Die Attribute, die als Matching-Eigenschaften ausgewählt wurden, werden verwendet, um Benutzerkonten in Clarizen One bei Aktualisierungsvorgängen zum Abgleichen zu nutzen. Wenn Sie das übereinstimmende Zielattribute ändern, müssen Sie sicherstellen, dass die Clarizen One-API das Filtern von Benutzern basierend auf diesem Attribut unterstützt. Wählen Sie die Schaltfläche Speichern, um alle Änderungen zu übernehmen.

    Attribut Typ
    Nutzername Schnur
    Anzeigename Schnur
    active Boolescher Wert
    title Schnur
    E-Mails[Typ eq "Arbeit"].Wert Schnur
    emails[type eq "Zuhause"].value Schnur
    It seems that no actual translation improvement is necessary here, as the technical term "emails[type eq "other"].value" is likely to remain the same across different locales for consistency and accuracy purposes. Schnur
    bevorzugteSprache Schnur
    name.givenName Schnur
    name.familyName Schnur
    name.formatted Schnur
    name.honorificPrefix Schnur
    name.honorificSuffix Schnur
    Adressen[type eq "other"].formatted Schnur
    adressen[typ eq "arbeitsadresse"].formatiert Schnur
    addresses[type eq "arbeit"].land Schnur
    addresses[type eq "arbeit"].region Schnur
    addresses[type == "work"].locality Schnur
    addressen[typ eq "arbeit"].postleitzahl Schnur
    addresses[typ eq "work"].strassenAdresse Schnur
    phoneNumbers[type eq "Arbeit"].value Schnur
    phoneNumbers[typ ist gleich "mobil"].wert Schnur
    Phone Numbers [Typ entspricht "fax"]. Wert Schnur
    Telefonnummern[typ eq "home"].wert Schnur
    phoneNumbers[type eq "andere"].value Schnur
    phoneNumbers[type eq "pager"].value Schnur
    externalId Schnur
    Spitzname Schnur
    locale Schnur
    roles[primary eq "True".type] Schnur
    roles[primary eq "Wahr".value] Schnur
    Zeitzone Schnur
    Benutzertyp Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager Verweis
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division Schnur
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division Schnur
  12. Wählen Sie die Gruppen undaus.

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

    Attribut Typ
    Anzeigename Schnur
    externalId Schnur
    members Verweis
  14. Informationen zum Konfigurieren von Bereichsfiltern finden Sie in den folgenden Anweisungen im Bereichsfilterartikel.

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

  16. 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 zu sehen und zu erfahren, wie nahe 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 zum Quarantänestatus finden Sie im Artikel über den Anwendungsbereitstellungs-Quarantänestatus.

Tipps zur Problembehandlung

Wenn Sie der Clarizen One-Katalog-App einen Benutzer zuweisen, wählen Sie nur die Rolle "Benutzer " aus. Die folgenden Rollen sind ungültig:

  • Administrator (Admin)
  • Benutzer – Berichterstattung per E-Mail
  • Externer Benutzer
  • Benutzer – Finanzdaten
  • Benutzer – Social Media
  • Superuser
  • Benutzer – Zeit & Ausgaben

Zusätzliche Ressourcen