Microsoft Entra ID – SCIM – Konfiguration

Wichtiger Hinweis

Die Anweisungen in diesem Artikel beziehen sich auf eine App eines Drittanbieters und spiegeln möglicherweise nicht die neueste Version wider. Bitte verwenden Sie diese Anweisungen als Leitfaden zur Durchführung der Aufgabe, seien Sie jedoch darauf aufmerksam, dass einige Bildschirme, Feldnamen und Schritte geändert worden sein können.

Übersicht

Dieser Artikel enthält Einzelheiten zur Konfiguration eines Entra-ID-Identitätsanbieters für die Verwendung der SCIM-API von Flosum. Weitere Informationen zu SCIM finden Sie im folgenden Artikel.

• SCIM für Flosum konfigurieren

Kunden-gehostet

Kunden, die Flosum-Apps auf ihrer eigenen Infrastruktur hosten, haben eine benutzerdefinierte URL zum Anmelden bei ihren Apps. Wenn Sie diese Dokumentation verwenden, ersetzen Sie beliebige Flosum-gehostete URLs durch Ihre eigenen URLs.

Voraussetzungen

Bevor Sie die automatisierte Bereitstellung einrichten, stellen Sie sicher, dass SAML-basiertes SSO in Ihrem Flosum-Tenant korrekt konfiguriert und voll funktionsfähig ist.

Stellen Sie sicher, dass Ihre SAML-Attribute und -Ansprüche Konfiguration die folgenden Attribute enthält:

Anspruchsname	Wert
userUniqueId	user.objectid
firstName	user.givenname
lastName	user.surname
email	user.mail

Anweisungen zum Hinzufügen und Konfigurieren eines Microsoft Entra ID-Identitätsanbieters finden Sie in den folgenden Artikeln.

• Einen Identitätsanbieter hinzufügen (SSO)

• Microsoft Entra ID – OIDC – Konfiguration

• Microsoft Entra ID – SAML – Konfiguration

Entra ID konfigurieren

1

API-Integration konfigurieren

1. Melden Sie sich bei Ihrem Entra-ID-Konto an.
2. Greifen Sie auf den von Ihnen erstellten Identitätsanbieter zu.
3. Klicken Sie auf Bereitstellung unter Verwalten im linken Seitenleistenmenü.

   
4. Ändern Sie Bereitstellungsmodus von Manuell zu Automatisch.
5. Vervollständigen Sie den Abschnitt mit den Administratoranmeldeinformationen Abschnitt.
6. Mandanten-URL: Geben Sie die SCIM-API-URL für Ihre Region aus der folgenden Tabelle ein.

Region	SCIM-API-URL
Vereinigte Staaten	https://global-us.flosum.app/api/v1/scim
Deutschland	https://global-de.flosum.app/api/v1/scim
Japan	https://global-jp.flosum.app/api/v1/scim
Australien	https://global-au.flosum.app/api/v1/scim

1. Geheimer Token: Geben Sie Ihren Global Settings API-Token. Wenn Sie keinen API-Token haben, finden Sie im folgenden Artikel Anweisungen zum Erstellen eines solchen.

   1. Ein API-Token erstellen

2. Klicken Sie auf Verbindung testen um zu überprüfen, ob eine Verbindung zu Ihrem Flosum-Tenant hergestellt werden kann.

   

Wenn Sie keine Verbindungsbestätigung erhalten, überprüfen Sie Mandanten-URL und stellen Sie sicher, dass sie nicht durch Firewalls oder andere Netzwerkverkehrsfilter blockiert wird. Überprüfen Sie dann, ob die API-Token korrekt ist.

1. Klicken Sie auf Speichern.

   

2

Benutzerzuordnungen

Die Flosum-SCIM-API verwendet bestimmte Metadatenwerte aus Entra-ID-Benutzerprofilen. Dieser Abschnitt erläutert die erforderlichen Zuordnungen zwischen Flosum-SCIM-API- und Entra-ID-Attributen.

1. Klicken Sie auf Bereitstellung unter Verwalten im linken Seitenleistenmenü.
2. Klicken Sie auf Microsoft Entra ID-Benutzer bereitstellen in den Zuordnungen Abschnitt.

   
3. Stellen Sie sicher, dass Aktiviert auf Ja.
4. Stellen Sie sicher, dass alle Zielobjektaktionen (Erstellen, Aktualisieren, und Löschen) aktiviert sind.

   
5. Wenn Änderungen vorgenommen wurden, klicken Sie auf Speichern.
6. Attributzuordnungen legen fest, welche Microsoft-Entra-ID-Attribute mit welchen Flosum-SCIM-API-Attributen synchronisiert werden. Sehen Sie sich den Screenshot und die Tabelle unten an, um zu erfahren, wie die korrekten Attributzuordnungen festgelegt werden.

Flosum-SCIM-API-Attribut	Microsoft-Entra-ID-Attribut
userName	mail
active	Switch([IsSoftDeleted],,"False","True","True","False")
emails[type eq "work"].value	mail
name.givenName	givenName
name.familyName	surname
externalId	objectId

Flosum verwendet die E-Mail-Adresse als Benutzernamen. Stellen Sie sicher, dass das userName Attribut dem mail Attribut zugeordnet ist. Der folgende Screenshot zeigt, wie das mail Attribut bearbeitet wird, um diese Zuordnung einzurichten.

Während der Benutzerbereitstellung wird das Zeitzonenattribut standardmäßig auf Etc/UTC gesetzt.

3

Gruppenzuordnungen

Die Flosum-SCIM-API unterstützt derzeit keine Gruppenbereitstellung. Stellen Sie sicher, dass die Gruppensynchronisierung deaktiviert ist.

1. Klicken Sie auf Bereitstellung unter Verwalten im linken Seitenleistenmenü.
2. Klicken Sie auf Microsoft Entra ID-Gruppen bereitstellen in den Zuordnungen Abschnitt.
3. Stellen Sie sicher, dass Aktiviert auf Nein.

   
4. Wenn Änderungen vorgenommen wurden, klicken Sie auf Speichern.

4

Bereitstellung starten

Nachdem Sie Entra ID für die Arbeit mit Flosums SCIM-API konfiguriert haben, können Sie die Bereitstellung in Entra ID aktivieren, um den Prozess der Benutzerbereitstellung zu starten.

1. Klicken Sie auf Bereitstellung unter Verwalten im linken Seitenleistenmenü.
2. In den Einstellungen Abschnitt den Bereitstellungsstatus zu Ein.

   
3. Klicken Sie auf Speichern.

Dadurch wird die anfängliche Bereitstellung gestartet, was einige Zeit dauern kann. Prüfen Sie nach etwa 20 Minuten den unteren Bereich der Seite, um den Status zu sehen.

Bereitstellung deaktivieren

Die Bereitstellung kann deaktiviert werden, indem der Bereitstellungsstatus zu Aus.

Wenn Sie ein dringendes Update benötigen, stoppen Sie die Bereitstellung und starten Sie sie neu. Dadurch wird eine sofortige erneute Synchronisierung ausgelöst, die alle Updates umfasst.