> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SCIM-Verzeichnisintegration mit Microsoft Entra ID

> Konfigurieren Sie die SCIM-Verzeichnisintegration zwischen Microsoft Entra ID und Iru Endpoint. Stellen Sie Benutzer und Gruppen über SCIM automatisch bereit und heben Sie deren Bereitstellung auf.

### Über die SCIM-Verzeichnisintegration mit Microsoft Entra ID

Mit der SCIM-Verzeichnisintegration mit Microsoft Entra ID in Iru Endpoint können Sie eine SCIM-basierte Benutzerverzeichnissynchronisierung zwischen Microsoft Entra ID und Iru Endpoint einrichten, die die automatische Bereitstellung und Aufhebung der Bereitstellung von Benutzern und Gruppen ermöglicht.

### Funktionsweise

Die SCIM-Integration stellt eine sichere Verbindung zwischen Microsoft Entra ID und Iru Endpoint her und ermöglicht die automatische Synchronisierung von Benutzer- und Gruppendaten. Wenn Benutzer oder Gruppen in Microsoft Entra ID hinzugefügt, geändert oder entfernt werden, werden diese Änderungen über das SCIM-Protokoll automatisch in Iru Endpoint übernommen.

### Voraussetzungen

* Prüfen Sie unbedingt die unterstützten Benutzer- und Gruppenattribute, die im Artikel [SCIM-Verzeichnisintegration](/de/endpoint/integrations/scim/scim-directory-integration#scim-schema-and-supported-attributes) aufgeführt sind.
* Stellen Sie sicher, dass keine verschachtelten Gruppen in SCIM enthalten sind, da Microsoft diese Funktion nicht unterstützt.

<Tabs>
  <Tab title="Iru Endpoint">
    ### SCIM-Token und API-URL abrufen

    Führen Sie diese Schritte zuerst in Iru Endpoint durch. Sie benötigen das SCIM-Zugriffstoken und die API-URL bei der Konfiguration von Microsoft Entra ID. Alle Details finden Sie im Artikel [SCIM-Verzeichnisintegration](/de/endpoint/integrations/scim/scim-directory-integration).

    <Steps>
      <Step title="Integrationen öffnen">
        Wählen Sie in Iru Endpoint in der Seitenleiste die [**Schaltfläche Kontomenü**](/de/iru/platform-overview/account-menu) und dann **Integrationen**.

        <Frame>
          <img src="https://mintcdn.com/iru/8BYPjuKZa-zyEEf_/assets/media/images/iru-nav-integrations.png?fit=max&auto=format&n=8BYPjuKZa-zyEEf_&q=85&s=e89fa7e9b81ac504a6f519608e10b8a3" alt="Screenshot des Kontomenüs mit hervorgehobener Option Integrations" width="562" height="1040" data-path="assets/media/images/iru-nav-integrations.png" />
        </Frame>
      </Step>

      <Step title="Alle Integrationen durchsuchen">
        Wählen Sie oben rechts auf der Seite „Integrations“ **Alle Integrationen durchsuchen**.
      </Step>

      <Step title="Nach Directory integrations filtern">
        Aktivieren Sie den Filter **Directory integrations**.
      </Step>

      <Step title="SCIM protocol auswählen">
        Wählen Sie die Kachel **SCIM protocol**.

        <Frame>
          <img src="https://mintcdn.com/iru/mFx4MUIljla7jvxs/assets/media/images/iru-integrations-add-scim.png?fit=max&auto=format&n=mFx4MUIljla7jvxs&q=85&s=336ae459ab0810c8d899d6abecb96ad9" alt="Seite zum Hinzufügen einer neuen Integration mit der Kachel SCIM protocol" width="2126" height="1354" data-path="assets/media/images/iru-integrations-add-scim.png" />
        </Frame>
      </Step>

      <Step title="Konfiguration starten">
        Wählen Sie **Erste Schritte**.
      </Step>

      <Step title="Integration benennen">
        Geben Sie einen eindeutigen Namen für die SCIM-Integration ein.
      </Step>

      <Step title="Authentifizierungstoken generieren">
        Wählen Sie **Token generieren**. Die SCIM-Integration verwendet einen HTTP-Authorization-Header mit einem Bearer-Token.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-name.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=cf4df5d3d63147de7739024f71f94bf8" alt="Bildschirm zur Konfiguration einer SCIM-Benutzerintegration mit Namensfeld und Schaltfläche Token generieren" width="1898" height="1258" data-path="assets/media/images/iru-scim-name.png" />
        </Frame>
      </Step>

      <Step title="Token kopieren">
        Wählen Sie **Copy token**. Das Token ist nach Auswahl von „Done“ nicht mehr sichtbar. Bewahren Sie es sicher auf, da Sie es auf der Registerkarte **Microsoft Entra ID** benötigen.
      </Step>

      <Step title="Bestätigen und Einrichtung abschließen">
        Bestätigen Sie durch Aktivieren des Kontrollkästchens, dass Sie das Token kopiert haben, und wählen Sie dann **Fertig**. Sie kehren zur Seite **Integrationen** zurück.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-copy-token.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=c31e71ca70b13bd8db22047685ff47ae" alt="Dialog zum Kopieren des Tokens und Konfigurieren mit Ihrem Identitätsanbieter mit der Schaltfläche Copy token" width="1912" height="1262" data-path="assets/media/images/iru-scim-copy-token.png" />
        </Frame>
      </Step>

      <Step title="Integrationsdetails aufrufen">
        Wählen Sie die **Auslassungspunkte** bei der von Ihnen erstellten SCIM-Verzeichnisintegration.
      </Step>

      <Step title="Details anzeigen">
        Wählen Sie **View Details**.

        <Frame>
          <img src="https://mintcdn.com/iru/eRO3-umTSfRlw-QU/assets/media/images/iru-scim-view-details.png?fit=max&auto=format&n=eRO3-umTSfRlw-QU&q=85&s=72a2ce0cf83d041f18caa066996ffd4f" alt="Liste der Verzeichnisintegrationen mit SCIM-Integration und Auslassungsmenü mit View details, Rename, Rotate token, Delete" width="876" height="492" data-path="assets/media/images/iru-scim-view-details.png" />
        </Frame>
      </Step>

      <Step title="API-URL kopieren">
        Kopieren Sie die SCIM-API-URL (z. B. `https://subdomain.api.iru.com/api/v1/scim`). Ihr Identitätsanbieter benötigt diese. Die in Ihrem Tenant angezeigte URL zeigt möglicherweise noch die Domain `api.kandji.io`. Die `api.kandji.io`-Version der SCIM-API-URL funktioniert für diesen Zweck ebenfalls.
      </Step>

      <Step title="Details schließen">
        Wählen Sie **Schließen**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-copy-api-url.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=f826bc146ef440fff34093ffeb0202d6" alt="Dialog mit Details zur Benutzerintegration mit SCIM-API-URL und Kopierschaltfläche" width="1258" height="804" data-path="assets/media/images/iru-scim-copy-api-url.png" />
        </Frame>
      </Step>

      <Step title="Zur Registerkarte Microsoft Entra ID wechseln">
        Halten Sie das Token und die API-URL bereit und wechseln Sie dann zur Registerkarte **Microsoft Entra ID**, um die SCIM-App-Integration zu erstellen und zu konfigurieren.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Microsoft Entra ID">
    <Note>
      Schließen Sie zuerst die Registerkarte **Iru Endpoint** ab, um das SCIM-Token und die API-URL zu erhalten. Sie geben diese in den folgenden Schritten ein.
    </Note>

    ### Die SCIM-Integration in Microsoft Entra ID erstellen

    <Steps>
      <Step title="Microsoft Entra Admin Center öffnen">
        Melden Sie sich beim [Microsoft Entra Admin Center](https://entra.microsoft.com) an.
      </Step>

      <Step title="Zu Entra ID navigieren">
        Öffnen Sie das Portalmenü und wählen Sie dann **Entra ID**.
      </Step>

      <Step title="Enterprise apps aufrufen">
        Wählen Sie im Menü **Entra ID** die Option **Enterprise apps**.
      </Step>

      <Step title="Neue Anwendung erstellen">
        Wählen Sie **New application**.

        <Note>
          Wenn Sie bereits eine SAML-Single-Sign-On-Anwendung erstellt haben, können Sie diese Anwendung auswählen und SCIM hinzufügen.
        </Note>

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-id-new-app.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=c2cf9fdd7e1bb1642bde470e6b2cb9e1" alt="Microsoft Entra ID Enterprise applications All applications mit der Schaltfläche New application" width="3584" height="2006" data-path="assets/media/images/iru-scim-entra-id-new-app.png" />
        </Frame>
      </Step>

      <Step title="Anwendungstyp wählen">
        Wählen Sie **Create your own application**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-create-own-app.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=e8ee8a2bc2755af20b6e3899cb060fbc" alt="Microsoft Entra ID Browse gallery mit Create your own application" width="3584" height="1538" data-path="assets/media/images/iru-scim-entra-create-own-app.png" />
        </Frame>
      </Step>

      <Step title="Anwendung benennen">
        Geben Sie der Anwendung einen Namen.
      </Step>

      <Step title="Integrationstyp auswählen">
        Wählen Sie **Integrate any other application you don't find in the gallery (Non-gallery)**.
      </Step>

      <Step title="Anwendung erstellen">
        Wählen Sie **Erstellen**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-create-own-app-name-settings.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=cba41a5ec1b20278e90e2a50596f575e" alt="Dialog Create your own application in Microsoft Entra ID mit App-Name und Option Non-gallery" width="1150" height="1202" data-path="assets/media/images/iru-scim-entra-create-own-app-name-settings.png" />
        </Frame>
      </Step>

      <Step title="Provisioning aufrufen">
        Sie werden zur Übersichtsseite der neu erstellten App weitergeleitet.
        Wählen Sie unter **Verwalten** die Option **Provisioning**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-provisioning.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=254b497e5495f90c98dd2aa3f8043f96" alt="Übersicht der Iru SCIM-App in Microsoft Entra ID mit Provisioning unter Manage" width="3274" height="1976" data-path="assets/media/images/iru-scim-entra-provisioning.png" />
        </Frame>
      </Step>

      <Step title="Neue Konfiguration erstellen">
        Wählen Sie **New Configuration**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-new-config.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=f467f0725c3ed827be07becb33457fba" alt="Microsoft Entra ID Provisioning Erste Schritte mit der Schaltfläche New configuration" width="1884" height="1318" data-path="assets/media/images/iru-scim-entra-new-config.png" />
        </Frame>
      </Step>

      <Step title="Authentifizierungsmethode auswählen">
        Wählen Sie im Dropdown-Menü **Select authentication method** die Option **Bearer authentication**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-provisioning-configuration.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=8e4dd75bab8d15c0867bda9f6737d821" alt="Neue Provisioning-Konfiguration in Microsoft Entra ID mit Bearer authentication, Tenant URL und Secret token" width="1886" height="1470" data-path="assets/media/images/iru-scim-entra-provisioning-configuration.png" />
        </Frame>
      </Step>

      <Step title="SCIM-Verbindung konfigurieren">
        Fügen Sie die SCIM-API-URL, die Sie auf der Registerkarte **Iru Endpoint** kopiert haben, in das Feld **Tenant URL** ein.
      </Step>

      <Step title="Secret Token hinzufügen">
        Fügen Sie das Token, das Sie auf der Registerkarte **Iru Endpoint** erhalten haben, in das Feld **Secret token** ein.
      </Step>

      <Step title="Verbindung testen">
        Wählen Sie **Test connection**. Es sollte eine Benachrichtigung über einen erfolgreichen Test angezeigt werden.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-provisioning-test-success.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=20452fe2fa50403d81da1e52d8188c51" alt="Erfolgsmeldung für den Verbindungstest beim Provisioning in Microsoft Entra ID" width="684" height="128" data-path="assets/media/images/iru-scim-entra-provisioning-test-success.png" />
        </Frame>
      </Step>

      <Step title="Konfiguration erstellen">
        Wählen Sie **Erstellen**.
      </Step>

      <Step title="Provisioning-Einstellungen aufrufen">
        Wählen Sie im Bereich „Manage“ die Option **Provisioning**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-entra-provisioning-mapping.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=7c8a14a6cc74dbcfc10cf82ce6af826e" alt="Übersicht der Provisioning-Konfiguration in Microsoft Entra ID" width="1864" height="1532" data-path="assets/media/images/iru-scim-entra-provisioning-mapping.png" />
        </Frame>
      </Step>

      <Step title="Zuordnungen konfigurieren">
        Erweitern Sie das Dreieck **Mappings** und stellen Sie sicher, dass sowohl „Groups“ als auch „Users“ aktiviert sind.
      </Step>

      <Step title="Einstellungen konfigurieren">
        Erweitern Sie das Dreieck **Einstellungen**.
      </Step>

      <Step title="Bereich festlegen">
        Wählen Sie für **Scope** die Option **Sync only assigned users and groups**.
      </Step>

      <Step title="Provisioning aktivieren">
        Setzen Sie **Provisioning Status** auf „On“.
      </Step>

      <Step title="Konfiguration speichern">
        Wählen Sie **Speichern**.

        <Frame>
          <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-mapping-settings.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=0970d7108a416da6b5087fbf537785a2" alt="Mappings und Settings beim Provisioning in Microsoft Entra ID mit Scope und Provisioning Status" width="2034" height="1962" data-path="assets/media/images/iru-scim-mapping-settings.png" />
        </Frame>
      </Step>

      <Step title="Einstellungen schließen">
        Wählen Sie das **X** in der oberen rechten Ecke, um die Einstellungen zu schließen.
      </Step>
    </Steps>

    ### Benutzer und Gruppen zuweisen

    <Steps>
      <Step title="Users and groups aufrufen">
        Wählen Sie unter **Verwalten** die Option **Users and groups**.
      </Step>

      <Step title="Benutzer und Gruppen hinzufügen">
        Wählen Sie im Menü **Add user/group**.
      </Step>

      <Step title="Benutzer und Gruppen auswählen">
        Wählen Sie im Dialog **Add Assignment** den Link unter **Users and groups**.
      </Step>

      <Step title="Aus der Liste wählen">
        Eine Liste von Benutzern und Sicherheitsgruppen wird angezeigt. Sie können nach einem bestimmten Benutzer oder einer bestimmten Gruppe suchen oder mehrere Benutzer und Gruppen aus der Liste auswählen.
      </Step>

      <Step title="Zuweisungen auswählen">
        Wählen Sie die Benutzer und Gruppen aus, die zugewiesen werden sollen.
      </Step>

      <Step title="Auswahl bestätigen">
        Wählen Sie **Auswählen**.
      </Step>

      <Step title="Zuweisung abschließen">
        Wählen Sie **Zuweisen**, um die Zuweisung von Benutzern und Gruppen zur App abzuschließen.
      </Step>

      <Step title="Zuweisung überprüfen">
        Vergewissern Sie sich, dass die hinzugefügten Benutzer und Gruppen in der Liste **Users and groups** angezeigt werden.
      </Step>
    </Steps>

    <Note>
      Wenn eine Meldung angezeigt wird, dass ein kostenloser Tarif verwendet wird, können Sie der SCIM-Unternehmens-App nur Benutzer (keine Gruppen) hinzufügen.
    </Note>

    ### Hinweise

    <CardGroup cols={2}>
      <Card title="Synchronisierung" icon="arrows-rotate">
        Die Benutzersynchronisierung erfolgt in eine Richtung. Die Microsoft Entra ID-SCIM-App sendet Benutzerinformationen nur dann an Iru Endpoint, wenn neue Informationen benötigt werden. Wenn ein Benutzer oder eine Gruppe nach dem Erstellen der App zur SCIM-App in Microsoft Entra ID hinzugefügt wird, erfolgt alle 40 Minuten eine Synchronisierung (von Microsoft Entra ID festgelegt). Um früher zu synchronisieren, stoppen und starten Sie das Provisioning in der SCIM-App in Microsoft Entra ID. Dies hat keine Auswirkungen auf bestehende Benutzer oder Gruppen in Iru Endpoint.
      </Card>

      <Card title="Benutzer entfernen" icon="user-minus">
        Wenn Entra ID einen Benutzer auf inaktiv setzt, wird der Benutzer in Ihrem Iru Endpoint-Tenant als inaktiv gesetzt. Wenn Entra ID einen Benutzer löscht, wird der Benutzer aus Ihrem Iru Endpoint-Tenant gelöscht.
      </Card>

      <Card title="Bedingte Logik in Blueprints" icon="code-branch">
        Wenn Sie bedingte Logik der [Assignment Map](/de/endpoint/blueprints/assignment-maps/using-conditional-logic-in-blueprints) mit Gruppen verwenden, müssen Sie jede Gruppe, die in Iru Endpoint bereitgestellt werden soll, explizit zur SCIM-App hinzufügen. Gruppen werden nicht automatisch synchronisiert, nur weil Benutzer hinzugefügt werden, die zufällig Mitglieder der Gruppe sind.
      </Card>

      <Card title="Starke Zertifikatzuordnung für AD CS" icon="certificate">
        Wenn Sie Microsoft Active Directory Certificate Services für die zertifikatbasierte Authentifizierung verwenden, stellen Sie sicher, dass Ihre SCIM-Attributzuordnungen die Anforderungen an eine starke Zertifikatzuordnung unterstützen. Erforderliche Zuordnungen und Zertifikatsaktualisierungen finden Sie unter [Konfiguration der starken Zertifikatzuordnung für Active Directory](/de/endpoint/integrations/certificate-services/active-directory-certificate-services/active-directory-certificate-services-ad-cs-strong-mapping-configuration).
      </Card>
    </CardGroup>

    #### Microsoft Device Compliance

    Wenn Sie eine Entra ID-SCIM-Benutzerverzeichnisintegration und die Microsoft Device Compliance-Integration verwenden, stellen Sie sicher, dass die Benutzer- und Gruppenattributzuordnungen für das Attribut **externalId** in Ihrer SCIM-Anwendung wie unten aufgeführt auf objectId verweisen. Die **objectId** wird von Iru Endpoint verwendet, um Benutzer- und Gruppenressourcen in Intune zuzuordnen.

    <table>
      <thead>
        <tr>
          <th><strong>Benutzerattribut</strong></th>
          <th><strong>Benutzerwert</strong></th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td>externalId</td>
          <td>objectId</td>
        </tr>
      </tbody>
    </table>

    <table>
      <thead>
        <tr>
          <th><strong>Gruppenattribut</strong></th>
          <th><strong>Gruppenwert</strong></th>
        </tr>
      </thead>

      <tbody>
        <tr>
          <td>externalId</td>
          <td>objectId</td>
        </tr>
      </tbody>
    </table>

    **Benutzer- und Gruppenzuordnungen aktualisieren**

    <Steps>
      <Step title="SCIM-Anwendung aufrufen">
        Navigieren Sie im [Microsoft Entra Admin Center](https://entra.microsoft.com) zur SCIM-Unternehmensanwendung.
      </Step>

      <Step title="Provisioning öffnen">
        Wählen Sie **Provisioning**.
      </Step>

      <Step title="Attributzuordnung aufrufen">
        Wählen Sie den Bereich **Attribute mapping (Preview)**.
      </Step>

      <Step title="Benutzer- oder Gruppenzuordnung wählen">
        Wenn Sie Benutzerattribute aktualisieren, wählen Sie **Provision Microsoft Entra ID Users.**
        Wenn Sie Gruppenattribute aktualisieren, wählen Sie **Provision Microsoft Entra ID Groups**.
      </Step>

      <Step title="Zuordnung der externalId überprüfen">
        Überprüfen Sie, ob externalId auf objectId abgebildet ist.
      </Step>

      <Step title="Zuordnung bei Bedarf aktualisieren">
        Falls nicht, wählen Sie die Schaltfläche **Bearbeiten** rechts neben dem Attribut und wählen Sie objectId aus der Liste.
      </Step>

      <Step title="Änderungen speichern">
        Wählen Sie **Speichern**.
      </Step>

      <Step title="Zur Übersicht zurückkehren">
        Wählen Sie das **X**, um zurückzukehren.
      </Step>

      <Step title="Provisioning neu starten">
        Wenn Werte geändert wurden, müssen Sie zurück auf der Provisioning-Übersichtsseite die aktualisierten Werte sofort an Iru Endpoint übertragen, indem Sie den Provisioning-Dienst stoppen und anschließend wieder starten.
      </Step>

      <Step title="Provisioning pausieren">
        Wählen Sie die Schaltfläche **Pause provisioning**.
      </Step>

      <Step title="Provisioning starten">
        Wählen Sie die Schaltfläche **Start provisioning**.
      </Step>
    </Steps>
  </Tab>
</Tabs>