Freigeben über


Tutorial: Konfigurieren von StarLeaf für die automatische Benutzerbereitstellung

In diesem Tutorial werden die Schritte erläutert, die in SpaceIQ 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 SpaceIQ 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 Vorschauversion. 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 StarLeaf-Mandanten.
  • Ein Benutzerkonto in StarLeaf mit Administratorberechtigungen.

Zuweisen von Benutzern zu StarLeaf

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 oder Gruppen in Microsoft Entra ID Zugriff auf Foodee benötigen. Anschließend können Sie die Benutzer und Gruppen StarLeaf anhand dieser Anweisungen zuweisen.

Wichtige Tipps zum Zuweisen von Benutzern zu StarLeaf

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

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

Einrichten von StarLeaf für die Bereitstellung

Bevor Sie StarLeaf für die automatische Benutzerbereitstellung mit Azure AD konfigurieren, müssen Sie in StarLeaf die SCIM-Bereitstellung konfigurieren:

  1. Melden Sie sich bei Ihrer StarLeaf-Verwaltungskonsole an. Navigieren Sie zu Integrations>Add integration (Integrationen > Integration hinzufügen).

    Screenshot of the StarLeaf Admin Console with the Integrations and Add integration options called out.

  2. Wählen Sie den Typ aus, der Microsoft Entra ID sein soll. Geben Sie einen geeigneten Namen in das Feld Name ein. Klicken Sie auf Anwenden.

    Screenshot of the Add integration dialog box with the Type and Name text boxes called out.

  3. Daraufhin werden die Werte für SCIM base URL (SCIM-Basis-URL) und Access token (Zugriffstoken) angezeigt. Diese Werte werden auf der Registerkarte Bereitstellung Ihrer StarLeaf-Anwendung jeweils in die Felder Mandanten-URL und Geheimnistoken eingegeben.

    Screenshot of the Edit integration dialog box with the Type, Name, and SCIM base URL text boxes called out.

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

Führen Sie zum Hinzufügen von SpaceIQ 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ügenStarLeaf ein, und wählen Sie im Ergebnisbereich StarLeaf aus. StarLeaf in the results list

Konfigurieren der automatischen Benutzerbereitstellung in StarLeaf

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

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

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

    Enterprise applications blade

  3. Wählen Sie in der Anwendungsliste StarLeaf aus.

    The StarLeaf link in the Applications list

  4. Wählen Sie die Registerkarte Bereitstellung.

    Screenshot of the Manage options with the Provisioning option called out.

  5. Legen Sie den Bereitstellungsmodus auf Automatisch fest.

    Screenshot of the Provisioning Mode dropdown list with the Automatic option called out.

  6. Geben Sie im Abschnitt „Administratoranmeldeinformationen“ die zuvor abgerufenen Werte für SCIM Base URL (SCIM-Basis-URL) und Access Token (Zugriffstoken) in die Felder Mandanten-URL bzw. Geheimes Token ein. Klicken Sie auf Verbindung testen, um sicherzustellen, dass Microsoft Entra ID eine Verbindung mit SpaceIQ herstellen kann. Vergewissern Sie sich im Falle eines Verbindungsfehlers, dass Ihr StarLeaf-Konto über Administratorberechtigungen verfügt, und wiederholen Sie den Vorgang.

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

    Notification Email

  8. Klicken Sie auf Speichern.

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

    Screenshot of the Mappings section showing the Synchronize Microsoft Entra users to StarLeaf option.

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

    Screenshot of the Attribute Mappings section showing nine mappings displayed.

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

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

    Provisioning Status Toggled On

  13. Legen Sie die Benutzer und/oder Gruppen fest, die in StarLeaf bereitgestellt werden sollen, indem Sie im Abschnitt Einstellungen unter Bereich die gewünschten Werte auswählen.

    Provisioning Scope

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

    Saving Provisioning Configuration

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

  • StarLeaf unterstützt derzeit keine Gruppenbereitstellung.
  • StarLeaf erfordert, dass Werte für email und userName den gleichen Quellwert haben.

Zusätzliche Ressourcen

Nächste Schritte