Tutorial: Konfigurieren von Bonusly für die automatische Benutzerbereitstellung

  • Artikel

In diesem Tutorial werden die Schritte erläutert, die in Bonusly und Microsoft Entra ID ausgeführt werden müssen, um Microsoft Entra ID für die automatische Bereitstellung und die Aufhebung der Bereitstellung von Benutzer*innen und/oder Gruppen in Bonusly zu konfigurieren.

Hinweis

In diesem Tutorial wird ein Connector beschrieben, der auf dem Bereitstellungsdienst für Benutzer*innen für Microsoft Entra-Benutzer*innen 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.

Voraussetzungen

Das in diesem Tutorial beschriebene Szenario setzt voraus, dass Sie bereits über die folgenden Elemente verfügen:

  • Ein Microsoft Entra-Mandant
  • Einen Bonusly-Mandanten
  • Ein Benutzerkonto in Bonusly mit Administratorberechtigungen

Hinweis

Die Microsoft Entra-Bereitstellungsintegration basiert auf der Bonusly-REST-API, die für Bonusly-Entwickler verfügbar ist.

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

Führen Sie zum Hinzufügen von Bonusly aus dem Microsoft Entra-Anwendungskatalog die folgenden Schritte aus:

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

  2. Navigieren Sie zu Identität>Anwendungen>Unternehmensanwendungen>Neue Anwendung.

  3. Geben Sie im Suchfeld Bonusly ein, wählen Sie im Ergebnisbereich Bonusly aus, und klicken Sie dann auf die Schaltfläche Hinzufügen, um die Anwendung hinzuzufügen.

    Bonusly in der Ergebnisliste

Zuweisen von Benutzern zu Bonusly

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 Bonusly benötigen. Anschließend können Sie diese Benutzer und/oder Gruppen Bonusly wie folgt zuweisen:

Wichtige Tipps zum Zuweisen von Benutzern zu Bonusly

  • Es wird empfohlen, Bonusly einzelne Microsoft Entra-Benutzer*innen zuzuweisen, um die Konfiguration der automatischen Bereitstellung von Benutzer*innen zu testen. Später können weitere Benutzer und/oder Gruppen zugewiesen werden.

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

Konfigurieren der automatischen Benutzerbereitstellung in Bonusly

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

Tipp

Sie können auch das SAML-basierte einmalige Anmelden für Bonusly aktivieren. Befolgen Sie dazu die Anweisungen im SSO-Tutorial zu Bonusly. 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 Bonusly in Microsoft Entra ID:

  1. Melden Sie sich beim Microsoft Entra Admin Center mindestens mit der Rolle Cloudanwendungsadministrator an.

  2. Navigieren Sie zu Identität>Anwendungen> Unternehmensanwendungen>Bonusly.

    Blatt „Unternehmensanwendungen“

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

    Bonusly-Link in der Anwendungsliste

  4. Wählen Sie die Registerkarte Bereitstellung.

    Screenshot: Bonusly – Registerkarte „Bereitstellung“. Unter „Verwalten“ ist „Bereitstellung“ hervorgehoben.

  5. Legen Sie den Bereitstellungsmodus auf Automatisch fest.

    Screenshot: Listenfeld „Bereitstellungsmodus“, „Automatisch“ ist ausgewählt und hervorgehoben.

  6. Geben Sie im Abschnitt Administratoranmeldeinformationen wie in Schritt 6 beschrieben das geheime Token Ihres Bonusly-Kontos ein.

    Screenshot des Abschnitts „Administratoranmeldeinformationen“. Das Feld „Geheimes Token“ ist leer, aber hervorgehoben.

  7. Das geheime Token für Ihr Bonusly-Konto befindet sich in Admin > Unternehmen > Integrationen. Klicken Sie im Abschnitt Wenn Sie codieren möchten, auf API > Neues API-Zugriffstoken erstellen, um ein neues geheimes Token zu erstellen.

    Screenshot des Bonusly-Menüs. Unter „Admin“ (Administrator) ist „Company“ (Unternehmen) hervorgehoben. Unter „Company“ (Unternehmen) ist „Integrations“ (Integrationen) hervorgehoben.

    Screenshot: Abschnitt „If you want to code“ (Wenn Sie programmieren möchten) der Bonusly-Website, in dem „API“ hervorgehoben ist

    Screenshot der Bonusly-Website. Die Registerkarte „Dienste“ ist geöffnet. Unter „Your API access tokens“ (Ihre API-Zugriffstoken) ist „Create new API access token“ (Neues API-Zugriffstoken erstellen) hervorgehoben.

  8. Geben Sie auf dem folgenden Bildschirm einen Namen für das Zugriffstoken in das bereitgestellte Textfeld ein, und klicken Sie dann auf Create Api Key (API-Schlüssel erstellen). Das neue Zugriffstoken wird für einige Sekunden in einem Popupfenster angezeigt.

    Screenshot: Seite „New access token“ (Neues Zugriffstoken) der Bonusly-Website. Ein Feld ohne Beschriftung enthält die Zeichenfolge „My Token“, und die Schaltfläche „Create Api key“ (API-Schlüssel erstellen) ist hervorgehoben.

    Screenshot der Bonusly-Website. Die Benachrichtigung „New access token created“ (Neues Zugriffstoken erstellt) gefolgt von einem nicht lesbaren Token wird angezeigt.

  9. Klicken Sie nach dem Auffüllen der in Schritt 5 gezeigten Felder auf Verbindung testen, um sicherzustellen, dass Microsoft Entra ID eine Verbindung mit Bonusly herstellen kann. Falls der Verbindungsaufbau fehlschlägt, stellen Sie sicher, dass Ihr Bonusly-Konto über Administratorberechtigungen verfügt, und versuchen Sie es noch einmal.

    Screenshot: Abschnitt „Admin Credentials“ (Administratoranmeldeinformationen) mit hervorgehobener Schaltfläche „Test connection“ (Verbindung testen)

  10. Geben Sie im Feld Benachrichtigungs-E-Mail die E-Mail-Adresse einer Person oder einer Gruppe ein, die Benachrichtigungen zu Bereitstellungsfehlern erhalten soll, und aktivieren Sie das Kontrollkästchen Bei Fehler E-Mail-Benachrichtigung senden.

    Screenshot: Leeres Feld „Benachrichtigungs-E-Mail“. Die Option „Bei Fehler E-Mail-Benachrichtigung senden“ wird angezeigt.

  11. Klicken Sie auf Speichern.

  12. Wählen Sie im Abschnitt Zuordnungen die Option Synchronize Microsoft Entra-Benutzer mit Bonusly synchronisieren aus.

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

    Screenshot der Seite „Attributzuordnungen“. In einer Tabelle sind die Microsoft Entra-Attribute, die entsprechenden Bonusly-Attributen und der entsprechende Status aufgeführt.

  14. Wenn Sie Bereichsfilter konfigurieren möchten, lesen Sie die Anweisungen unter Attributbasierte Anwendungsbereitstellung mit Bereichsfiltern.

  15. Um den Microsoft Entra-Bereitstellungsdienst für Bonusly zu aktivieren, ändern Sie den Bereitstellungsstatus im Abschnitt Einstellungen zu Ein.

    Screenshot der Seite „Einstellungen“. Der Umschalter „Bereitstellungsstatus“ ist auf „Aus“ festgelegt.

  16. Legen Sie die Benutzer und/oder Gruppen fest, die in Bonusly bereitgestellt werden sollen. Wählen Sie dazu im Abschnitt Einstellungen unter Bereich die gewünschten Werte aus.

    Screenshot: Listenfeld „Bereich“. Im Feld ist „Nur zugewiesene Benutzer und Gruppen synchronisieren“ ausgewählt.

  17. Wenn Sie fertig sind, klicken Sie auf Speichern.

    Screenshot: Speichern der Bereitstellungskonfiguration.

Dadurch wird die Erstsynchronisierung aller Benutzer und/oder Gruppen gestartet, die im Abschnitt Einstellungen unter Bereich definiert sind. Die Erstsynchronisierung dauert länger als nachfolgende Synchronisierungen, die ungefähr alle 40 Minuten erfolgen, solange der Microsoft Entra-Bereitstellungsdienst ausgeführt wird. Im Abschnitt Synchronisierungsdetails können Sie den Fortschritt überwachen und Links zu Berichten zur Bereitstellungsaktivität aufrufen. Darin sind alle Aktionen aufgeführt, die vom Microsoft Entra-Bereitstellungsdienst in Bonusly ausgeführt werden.

Weitere Informationen zum Lesen der Microsoft Entra-Bereitstellungsprotokolle finden Sie unter Meldung zur automatischen Bereitstellung von Konten für Benutzer*innen.

Zusätzliche Ressourcen

Nächste Schritte