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 Microsoft Entra ID 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 der StarLeaf-Administratorkonsole mit den aufgerufenen Optionen „Integrations“ und „Add integration“

  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 des Dialogfelds „Add integration“ mit den aufgerufenen Textfeldern für Typ und Name

  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 des Dialogfelds „Edit integration“ mit den aufgerufenen Textfeldern für Typ, Name und SCIM-Basis-URL

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. Screenshot der StarLeaf in der Ergebnisliste.

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.

    Screenshot: Seite für Unternehmensanwendungen

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

    Screenshot des StarLeaf-Links 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 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.

    Screenshot: Mandanten-URL und -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.

    Screenshot: Benachrichtigungs-E-Mail

  8. Klicken Sie auf Speichern.

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

  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 des Abschnitts „Attributzuordnungen“ mit neun 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 SpaceIQ zu aktivieren, ändern Sie den Bereitstellungsstatus im Abschnitt Einstellungen zu Ein.

    Screenshot: Aktivierter Bereitstellungsstatus

  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.

    Screenshot: Bereitstellungsbereich.

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

Weitere Ressourcen

Nächste Schritte