> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/global-settings/global-settings-docs-de/sicherheit/identitatsanbieter-sso/scim-konfigurationen/microsoft-entra-id-scim-konfiguration.md).

# Microsoft Entra ID – SCIM – Konfiguration

{% hint style="success" %}

#### 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.
{% endhint %}

## ![](https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FSxcnKlaJKPzDqONWoDNv%2FSummary2-Small-Icon.svg?alt=media\&token=5e3253d0-a069-4ba5-9c06-83c70bd0b21d) Ü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](/global-settings/global-settings-docs-de/sicherheit/identitatsanbieter-sso/scim-fur-flosum-konfigurieren.md)

{% hint style="warning" %}

#### 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.
{% endhint %}

## 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:

<div align="left"><figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FoCInfQodq2t2msKVB6Gd%2FUsingJitProvisioning-Azure-01.png?alt=media&amp;token=341b9789-2f46-433c-b14d-97816e6a9ceb" alt="" width="563"><figcaption></figcaption></figure></div>

| 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)](/global-settings/global-settings-docs-de/sicherheit/identitatsanbieter-sso/einen-identitatsanbieter-hinzufugen-sso.md)
* [Microsoft Entra ID – OIDC – Konfiguration](/global-settings/global-settings-docs-de/sicherheit/identitatsanbieter-sso/oidc-identitatsanbieter/microsoft-entra-id-oidc-konfiguration.md)
* [Microsoft Entra ID – SAML – Konfiguration](/global-settings/global-settings-docs-de/sicherheit/identitatsanbieter-sso/saml-identitatsanbieter/microsoft-entra-id-saml-konfiguration.md)

## Entra ID konfigurieren

{% stepper %}
{% step %}

### 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ü.&#x20;

   <div align="left"><figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FHzu22O2vEM1k36WsbwoD%2FConfiguringScim-MsEntra-S01-01.png?alt=media&amp;token=d59fb06e-c47e-4d2b-9df2-12ddf931310d" alt="" width="563"><figcaption></figcaption></figure></div>
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.

<table><thead><tr><th width="159.6666259765625">Region</th><th>SCIM-API-URL</th></tr></thead><tbody><tr><td>Vereinigte Staaten</td><td>https://global-us.flosum.app/api/v1/scim</td></tr><tr><td>Deutschland</td><td>https://global-de.flosum.app/api/v1/scim</td></tr><tr><td>Japan</td><td>https://global-jp.flosum.app/api/v1/scim</td></tr><tr><td>Australien</td><td>https://global-au.flosum.app/api/v1/scim</td></tr></tbody></table>

7. **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](/global-settings/global-settings-docs-de/sicherheit/api-token/ein-api-token-erstellen.md)
8. Klicken Sie auf **Verbindung testen** um zu überprüfen, ob eine Verbindung zu Ihrem Flosum-Tenant hergestellt werden kann.&#x20;

   <div align="left"><figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FM0LMh4tRYs8u6DAZP52l%2FConfiguringScim-MsEntra-S01-02.png?alt=media&amp;token=240c857e-22e1-49bd-8ff8-200ce43d17a2" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
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.

![](https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FUgJcnuoNMs325Imo3t42%2FConfiguringScim-MsEntra-S02-02.png?alt=media\&token=413a060e-56b2-474a-93f6-626392667ebb)
{% endhint %}

9. Klicken Sie auf **Speichern**.&#x20;

   <div align="left"><figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2Fy4ghmBeZgfjSSP7flr16%2FConfiguringScim-MsEntra-S02-03.png?alt=media&amp;token=64d6d31d-5530-4e70-96d4-53d8e1d69e29" alt="" width="548"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### 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ü.&#x20;
2. Klicken Sie auf **Microsoft Entra ID-Benutzer bereitstellen** in den **Zuordnungen** Abschnitt.&#x20;

   <div align="left"><figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2F0WPat5u1UZSp0svSSeG9%2FConfiguringScim-MsEntra-S03-01.png?alt=media&amp;token=d3435aee-7178-4aec-820c-88e2df0566f2" alt="" width="563"><figcaption></figcaption></figure></div>
3. Stellen Sie sicher, dass **Aktiviert** auf **Ja**.
4. Stellen Sie sicher, dass alle **Zielobjektaktionen** (**Erstellen**, **Aktualisieren**, und **Löschen**) aktiviert sind.&#x20;

   <div align="left"><figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FmekMhTChVN6L0IWD73If%2FConfiguringScim-MsEntra-S03-02.png?alt=media&amp;token=6dd271b9-feff-4a30-bad0-51a6ee096a33" alt="" width="563"><figcaption></figcaption></figure></div>
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.

<figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FhmA6WLv94oDCMAXjuc5Y%2FConfiguringScim-MsEntra-S03-03.png?alt=media&amp;token=b5971f68-e5d4-49c4-a7b4-71a03c3580ac" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="260.3333740234375">Flosum-SCIM-API-Attribut</th><th>Microsoft-Entra-ID-Attribut</th></tr></thead><tbody><tr><td>userName</td><td>mail</td></tr><tr><td>active</td><td>Switch([IsSoftDeleted],,"False","True","True","False")</td></tr><tr><td>emails[type eq "work"].value</td><td>mail</td></tr><tr><td>name.givenName</td><td>givenName</td></tr><tr><td>name.familyName</td><td>surname</td></tr><tr><td>externalId</td><td>objectId</td></tr></tbody></table>

{% hint style="warning" %}
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.

![](https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2F1Vquc2ymSPdrEBcxF5J5%2FConfiguringScim-MsEntra-S03-04.png?alt=media\&token=229e2973-c761-4da9-9110-9be66506d76e)
{% endhint %}

{% hint style="info" %}
Während der Benutzerbereitstellung wird das Zeitzonenattribut standardmäßig auf Etc/UTC gesetzt.
{% endhint %}
{% endstep %}

{% step %}

### 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ü.&#x20;
2. Klicken Sie auf **Microsoft Entra ID-Gruppen bereitstellen** in den **Zuordnungen** Abschnitt.
3. Stellen Sie sicher, dass **Aktiviert** auf **Nein**.&#x20;

   <div align="left"><figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FsUfpPNDJNQS4jJHJq9ss%2FConfiguringScim-MsEntra-S04-01.png?alt=media&amp;token=abf6e51f-b3fe-4614-884a-783976d34146" alt="" width="563"><figcaption></figcaption></figure></div>
4. Wenn Änderungen vorgenommen wurden, klicken Sie auf **Speichern**.
   {% endstep %}

{% step %}

### 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**.&#x20;

   <div align="left"><figure><img src="https://1457152582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsEk2hU5IMh3HEY5dJZjR%2Fuploads%2FqnPEKLGyDC23B3GI3gOB%2FConfiguringScim-MsEntra-S05-01.png?alt=media&amp;token=10f8408c-4a11-40c5-b369-4a87ea8dc275" alt="" width="563"><figcaption></figcaption></figure></div>
3. Klicken Sie auf **Speichern**.&#x20;

{% hint style="info" %}
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.
{% endhint %}

**Bereitstellung deaktivieren**

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

{% hint style="info" %}
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.
{% endhint %}
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/global-settings/global-settings-docs-de/sicherheit/identitatsanbieter-sso/scim-konfigurationen/microsoft-entra-id-scim-konfiguration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
