Konfigurieren von Peakon für die automatische Benutzerbereitstellung mit Microsoft Entra-ID

Ziel dieses Artikels ist es, die Schritte zu veranschaulichen, die in Peakon und Microsoft Entra-ID ausgeführt werden sollen, um die Microsoft Entra-ID so zu konfigurieren, dass Benutzer und/oder Gruppen automatisch für Peakon bereitgestellt und entfernt werden.

Hinweis

In diesem Artikel wird ein Connector beschrieben, der auf dem Microsoft Entra-Benutzerbereitstellungsdienst basiert. Wichtige Details zum Zweck und zur Funktionsweise dieses Diensts sowie häufig gestellte Fragen finden Sie unter Automatisieren der Bereitstellung und Bereitstellungsaufhebung von Benutzer*innen für SaaS-Anwendungen mit Microsoft Entra ID.

Dieser Connector befindet sich derzeit in der Vorschauversion. Weitere Informationen zu Vorschauversionen finden Sie unter Universelle Lizenzbedingungen für Onlinedienste.

Voraussetzungen

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

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.

Schritt 1: Zuweisen von Benutzern zu Peakon

Microsoft Entra ID ermittelt anhand von Zuweisungen, welche Benutzer*innen Zugriff auf ausgewählte Apps erhalten sollen. Im Kontext der automatischen Bereitstellung von Benutzer*innen werden nur die Benutzer*innen und/oder Gruppen synchronisiert, die einer Anwendung in Microsoft Entra ID zugewiesen wurden.

Vor dem Konfigurieren und Aktivieren der automatischen Bereitstellung von Benutzer*innen müssen Sie entscheiden, welche Benutzer*innen und/oder Gruppen in Microsoft Entra ID Zugriff auf Peakon benötigen. Anschließend können Sie diese Benutzer bzw. Gruppen Peakon wie folgt zuweisen:

Schritt 2: Wichtige Tipps zum Zuweisen von Benutzern zu Peakon

  • Es wird empfohlen, dass einem einzelnen Microsoft Entra-Benutzer Peakon zugewiesen wird, um die konfiguration der automatischen Benutzerbereitstellung zu testen. Später können weitere Benutzer und/oder Gruppen zugewiesen werden.

  • Beim Zuweisen eines Benutzers zu Peakon müssen Sie im Dialogfeld für die Zuweisung eine gültige anwendungsspezifische Rolle auswählen (sofern verfügbar). Benutzer mit der Rolle Standardzugriff werden von der Bereitstellung ausgeschlossen.

Schritt 3: Peakon für die Bereitstellung einrichten

  1. Melden Sie sich bei Ihrer Peakon-Verwaltungskonsole an. Wählen Sie "Konfiguration" aus.

    Peakon-Verwaltungskonsole

  2. Wählen Sie Integrationen aus.

    Screenshot der Konfigurationsoptionen mit aufgerufener Option „Integrationen“

  3. Aktivieren Sie Mitarbeiterbereitstellung.

    Screenshot des Abschnitts „Mitarbeiterbereitstellung“ mit aufgerufener Option „Aktivieren“

  4. Kopieren Sie die Werte für SCIM 2.0-URL und OAuth-Bearertoken. Diese Werte werden im Feld "Mandanten-URL " und " Geheimes Token " auf der Registerkarte "Bereitstellung" Ihrer Peakon-Anwendung eingegeben.

    Peakon: Token erstellen

Um Peakon für die automatische Benutzerbereitstellung mit Microsoft Entra ID zu konfigurieren, müssen Sie Peakon aus dem Microsoft Entra-Anwendungskatalog zu Ihrer Liste der verwalteten SaaS-Anwendungen hinzufügen.

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens als Cloudanwendungsadministrator an.
  2. Navigieren Sie zu Entra ID>Enterprise-Apps>Neue Anwendung.
  3. Geben Sie im Abschnitt Aus Katalog hinzufügen den Suchbegriff Peakon in das Suchfeld ein, und wählen Sie dann Peakon aus.
  4. Wählen Sie im Ergebnisbereich Peakon aus, und fügen Sie dann die App hinzu. Warten Sie einige Sekunden, während die App Ihrem Mandanten hinzugefügt wird. Peakon in der Ergebnisliste

Schritt 5: Konfigurieren der automatischen Benutzerbereitstellung auf Peakon

In diesem Abschnitt werden die Schritte zum Konfigurieren des Microsoft Entra-Bereitstellungsdiensts zum Erstellen, Aktualisieren und Deaktivieren von Benutzern*innen bzw. Gruppen in Peakon auf der Grundlage von Benutzer- oder Gruppenzuweisungen in Microsoft Entra ID erläutert.

Tipp

Sie können auch SAML-basiertes Single Sign-On für Peakon aktivieren, und befolgen Sie die Anweisungen im Artikel "Peakon Single Sign-On". Einmaliges Anmelden kann unabhängig von der automatischen Benutzerbereitstellung konfiguriert werden, obwohl diese beiden Features einander ergänzen.

So konfigurieren Sie die automatische Benutzerbereitstellung für Peakon in Microsoft Entra ID

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

  2. Navigieren Sie zu Entra ID>Enterprise-Apps

    Blatt „Unternehmensanwendungen“

  3. Wählen Sie in der Anwendungsliste den Eintrag Peakon aus.

    Peakon-Link in der Anwendungsliste

  4. Wählen Sie die Registerkarte Bereitstellung.

    Screenshot der Optionen zum Verwalten mit aufgerufener Bereitstellungsoption

  5. Wählen Sie + Neue Konfiguration aus.

    Screenshot der Registerkarte „Automatische Bereitstellung“.

  6. Geben Sie im Feld "Mandanten-URL " Ihre Peakon-Mandanten-URL und das geheime Token ein. Wählen Sie "Verbindung testen" aus, um sicherzustellen, dass die Microsoft Entra-ID eine Verbindung mit Peakon herstellen kann. Wenn die Verbindung fehlschlägt, stellen Sie sicher, dass Ihr Peakon-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 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. Um die Änderungen zu speichern, wählen Sie Übernehmen aus.

    Screenshot der Bereitstellungseigenschaften.

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

  11. Überprüfen Sie im Abschnitt Attributzuordnungen die Benutzerattribute, die von Microsoft Entra ID mit Peakon synchronisiert werden. Die als übereinstimmende Eigenschaften ausgewählten Attribute werden für den Abgleich der Benutzerkonten in Peakon für Updatevorgänge verwendet. Wählen Sie die Schaltfläche Speichern, um alle Änderungen zu übernehmen.

    Peakon-Benutzerattribute

  12. Informationen zum Konfigurieren von Bereichsfiltern finden Sie in den Anweisungen im Artikel "Bereichsfilter".

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

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

Connector-Einschränkungen

  • Alle benutzerdefinierten Benutzerattribute in Peakon müssen aus der benutzerdefinierten SCIM-Benutzererweiterung urn:ietf:params:scim:schemas:extension:peakon:2.0:User von Peakon erweitert werden.

Zusätzliche Ressourcen