Tutorial: Konfigurieren von Reward Gateway für die automatische Benutzerbereitstellung

In diesem Tutorial werden die Schritte erläutert, die in Reward Gateway 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 Reward Gateway 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.

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

Voraussetzungen

Das diesem Tutorial zu Grunde liegende Szenario setzt voraus, dass Sie bereits über die folgenden Voraussetzungen verfügen:

  • Ein Microsoft Entra-Mandant.
  • Einen Reward Gateway-Mandanten
  • Ein Benutzerkonto in Reward Gateway mit Administratorrechten

Zuweisen von Benutzern zu Reward Gateway

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 Benutzerbereitstellung müssen Sie entscheiden, welche Benutzer*innen und/oder Gruppen in Microsoft Entra ID Zugriff auf Reward Gateway benötigen. Anschließend können Sie diese Benutzer und/oder Gruppen Reward Gateway zuweisen, indem Sie die Anleitung unter Zuweisen eines Benutzers oder einer Gruppe zu einer Unternehmens-App in Azure Active Directory befolgen.

Wichtige Tipps zum Zuweisen von Benutzern zu Reward Gateway

  • Es wird empfohlen, Reward Gateway eine*n einzelne*n Microsoft Entra-Benutzer*in zuzuweisen, um die Konfiguration der automatischen Benutzerbereitstellung zu testen. Später können weitere Benutzer und/oder Gruppen zugewiesen werden.

  • Beim Zuweisen eines Benutzers zu Reward Gateway 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.

Einrichten von Reward Gateway für die Bereitstellung

Bevor Sie Reward Gateway für die automatische Benutzerbereitstellung mit Microsoft Entra ID konfigurieren, müssen Sie in Reward Gateway die SCIM-Bereitstellung aktivieren.

  1. Melden Sie sich bei Ihrer Reward Gateway-Verwaltungskonsole an. Klicken Sie auf Integrations.

    Screenshot der Reward Gateway-Verwaltungskonsole mit hervorgehobener Option „Integrations“ (Integrationen).

  2. Wählen Sie My Integrations (Meine Integrationen) aus.

    Screenshot der beiden Integrationsoptionen mit hervorgehobener Option „My Integrations“ (Meine Integrationen).

  3. Kopieren Sie die Werte für SCIM URL (v2) (SCIM-URL (v2)) und OAuth Bearer Token (OAuth-Bearertoken). Diese Werte werden auf der Registerkarte „Provisioning“ Ihrer Reward Gateway-Anwendung in die Felder „Tenant URL“ und „Secret Token“ eingegeben.

    Screenshot des Bereichs „My Integrations“ (Meine Integrationen) mit hervorgehobenem Textfeld „OAuth Bearer Token“ (OAuth-Bearertoken).

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

Führen Sie zum Hinzufügen von Reward Gateway 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 Abschnitt Aus Katalog hinzufügen den Suchbegriff Reward Gateway ein, und wählen Sie Reward Gateway im Suchfeld aus.
  4. Wählen Sie im Ergebnisbereich den Eintrag Reward Gateway aus, und fügen Sie dann die App hinzu. Warten Sie einige Sekunden, während die App Ihrem Mandanten hinzugefügt wird. Reward Gateway in der Ergebnisliste

Konfigurieren der automatischen Benutzerbereitstellung für Reward Gateway

In diesem Abschnitt werden die Schritte zum Konfigurieren des Microsoft Entra-Bereitstellungsdiensts zum Erstellen, Aktualisieren und Deaktivieren von Benutzern bzw. Gruppen in Reward Gateway 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 Reward Gateway aktivieren. Befolgen Sie hierzu die Anweisungen unter Tutorial: Azure Active Directory-Integration mit Reward Gateway. 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 Reward Gateway in Microsoft Entra ID:

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

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

    Blatt „Unternehmensanwendungen“

  3. Wählen Sie in der Anwendungsliste Reward Gatewayaus.

    Link „Reward Gateway“ in der Anwendungsliste

  4. Wählen Sie die Registerkarte Bereitstellung.

    Screenshot der Optionen zum Verwalten mit aufgerufener Bereitstellungsoption

  5. Legen Sie den Bereitstellungsmodus auf Automatisch fest.

    Screenshot der Dropdownliste „Bereitstellungsmodus“ mit aufgerufener Option „Automatisch“

  6. Geben Sie im Abschnitt Administratoranmeldeinformationen die zuvor abgerufenen Werte für SCIM URL (v2) (SCIM-URL (v2)) und OAuth Bearer Token (OAuth-Bearertoken) in die Felder Mandanten-URL und Geheimes Token ein. Klicken Sie auf Verbindung testen, um sicherzustellen, dass Microsoft Entra ID eine Verbindung mit Reward Gateway herstellen kann. Wenn die Verbindung nicht möglich ist, stellen Sie sicher, dass Ihr Reward Gateway-Konto über Administratorberechtigungen verfügt, und wiederholen Sie den Vorgang.

    Mandanten-URL + Token

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

    Benachrichtigungs-E-Mail

  8. Klicken Sie auf Speichern.

  9. Wählen Sie im Abschnitt Zuordnungen die Option Synchronize Microsoft Entra-Benutzer mit Reward Gateway synchronisieren aus.

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

    Screenshot des Abschnitts „Attributzuordnungen“ mit sechs Zuordnungen.

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

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

    Aktivierter Bereitstellungsstatus

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

    Bereitstellungsbereich

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

    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 zum Bereitstellungsaktivitätsbericht aufrufen, in dem alle Aktionen aufgeführt sind, die vom Microsoft Entra-Bereitstellungsdienst in Reward Gateway ausgeführt werden.

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

Connector-Einschränkungen

Die Gruppenbereitstellung wird von Reward Gateway derzeit nicht unterstützt.

Zusätzliche Ressourcen

Nächste Schritte

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