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

> Richten Sie eine SCIM-basierte Benutzerverzeichnissynchronisierung in Iru Endpoint ein. Stellen Sie Benutzer und Gruppen aus Ihrem Identitätsanbieter automatisch bereit und heben Sie deren Bereitstellung auf.

### Über die SCIM-Verzeichnisintegration

SCIM, das [System for Cross-domain Identity Management](https://scim.cloud/), ist ein Protokoll, das die Verwaltung von Benutzeridentitäten über verschiedene Systeme hinweg einfacher und effizienter macht. Es ist besonders nützlich, wenn Sie mehrere cloudbasierte Anwendungen verwenden, da es das Hinzufügen und Entfernen von Benutzern automatisiert.

### Funktionsweise

SCIM umfasst zwei Hauptrollen:

* **Client** – In der Regel ein Identitätsanbieter oder ein Identity-Access-Management-System wie Microsoft Entra ID oder Okta, das die zentralen Identitätsdaten verwaltet.
* **Service Provider** – Eine Software-as-a-Service-Anwendung (SaaS) wie Iru Endpoint, die Identitätsdaten zur Verwaltung von Benutzerzugriff und Berechtigungen verwendet.

SCIM unterstützt mehrere Vorgänge, darunter Bereitstellung, Synchronisierung und Aufhebung der Bereitstellung. Mit dieser Einweg-Synchronisierung können Sie Benutzerkonten in Iru Endpoint automatisch erstellen, Benutzerattribute zwischen Ihrem MDM und Ihrem IdP aktuell halten und Benutzerkonten automatisch entfernen oder deaktivieren, wenn sie nicht mehr benötigt werden.

### SCIM in Iru Endpoint konfigurieren

Um eine SCIM-Integration zwischen Ihrem Identitätsanbieter (IdP) und Iru Endpoint zu konfigurieren, müssen Sie:

* Eine neue SCIM-Verzeichnisintegration in Iru Endpoint erstellen
* Die SCIM-API-URL und das API-Token aus Iru Endpoint zur Verwendung mit Ihrem IdP abrufen.
* In Ihrem IdP eine App-Integration erstellen, SCIM-Attribute zuordnen und die gewünschten Benutzergruppen übertragen.

#### Eine neue SCIM-Verzeichnisintegration erstellen

<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-Benutzerverzeichnisintegration verwendet als Authentifizierungsmethode 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**.
  </Step>

  <Step title="Kopieren des Tokens bestätigen">
    Das Token ist nach Auswahl von „Done“ nicht mehr sichtbar. Bewahren Sie es sicher auf, bevor Sie fortfahren.
  </Step>

  <Step title="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>
</Steps>

#### Die SCIM-API-URL abrufen

Ihre SCIM-API-URL finden Sie in den Integrationsdetails in Iru Endpoint. Sie müssen diese URL bei der Konfiguration der SCIM-Verbindung an Ihren Identitätsanbieter übergeben.

<Steps>
  <Step title="Integrationsdetails aufrufen">
    Wählen Sie die **Auslassungspunkte** bei der soeben 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 mit **Kopieren** die SCIM-API-URL (z. B. `https://subdomain.api.iru.com/api/v1/scim`). Ihr Identitätsanbieter benötigt diese.

    <Note>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.</Note>
  </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>
</Steps>

### Eine SCIM-Integration umbenennen

So ändern Sie den Namen einer bestehenden SCIM-Verzeichnisintegration:

<Steps>
  <Step title="Integrationsmenü öffnen">
    Wählen Sie die **Auslassungspunkte** bei der SCIM-Verzeichnisintegration, die Sie umbenennen möchten.
  </Step>

  <Step title="Rename wählen">
    Wählen Sie **Rename**.

    <Frame>
      <img src="https://mintcdn.com/iru/eRO3-umTSfRlw-QU/assets/media/images/iru-scim-rename.png?fit=max&auto=format&n=eRO3-umTSfRlw-QU&q=85&s=23ec71b5a32fe4f4c79dbc3b0fb3d573" alt="Auslassungsmenü der SCIM-Integration mit der Option Rename" width="876" height="502" data-path="assets/media/images/iru-scim-rename.png" />
    </Frame>
  </Step>

  <Step title="Neuen Namen eingeben">
    Geben Sie den neuen Namen für die Integration ein und speichern Sie.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-rename-prompt.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=8bce3f3a702cc1044918b75de8937961" alt="Aufforderung bzw. Dialog zum Umbenennen der SCIM-Integration mit Namensfeld" width="1270" height="674" data-path="assets/media/images/iru-scim-rename-prompt.png" />
    </Frame>
  </Step>
</Steps>

### Das SCIM-Token rotieren

Rotieren Sie das SCIM-API-Token, wenn Sie das aktuelle Token ungültig machen müssen (zum Beispiel nach einem Sicherheitsvorfall oder bei einer Neukonfiguration in Ihrem IdP). Aktualisieren Sie nach dem Rotieren das neue Token in Ihrem Identitätsanbieter.

<Steps>
  <Step title="Integrationsmenü öffnen">
    Wählen Sie die **Auslassungspunkte** bei der SCIM-Verzeichnisintegration.
  </Step>

  <Step title="Rotate token wählen">
    Wählen Sie **Rotate token**.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-rotate-token.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=f8f63aedfd798b4a2c0d08f6d96f5cbc" alt="Auslassungsmenü der SCIM-Integration mit der Option Rotate token" width="1160" height="534" data-path="assets/media/images/iru-scim-rotate-token.png" />
    </Frame>
  </Step>

  <Step title="Rotation bestätigen">
    Bestätigen Sie die Rotation in der Aufforderung. Das vorherige Token funktioniert dann nicht mehr.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-rotate-prompt.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=8a4ba4bc590415c8380c2a21848455ac" alt="Bestätigungsaufforderung zum Rotieren des Tokens für die SCIM-Integration" width="1106" height="674" data-path="assets/media/images/iru-scim-rotate-prompt.png" />
    </Frame>
  </Step>

  <Step title="Neues Token kopieren">
    Kopieren Sie das neue Token und aktualisieren Sie es in Ihrem IdP.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-copy-new-token.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=12bfb79182832a84389e2f1d57f67013" alt="Das neue SCIM-Token nach der Rotation kopieren" width="1098" height="1282" data-path="assets/media/images/iru-scim-copy-new-token.png" />
    </Frame>
  </Step>
</Steps>

### Eine SCIM-Integration löschen

Durch das Entfernen einer SCIM-Verzeichnisintegration wird die Synchronisierung aus Ihrem IdP beendet und die Integration aus Iru Endpoint entfernt. Aktualisieren oder entfernen Sie die SCIM-App in Ihrem IdP, um Fehler zu vermeiden.

<Steps>
  <Step title="Integrationsmenü öffnen">
    Wählen Sie die **Auslassungspunkte** bei der SCIM-Verzeichnisintegration, die Sie entfernen möchten.
  </Step>

  <Step title="Delete integration wählen">
    Wählen Sie **Delete integration**.

    <Frame>
      <img src="https://mintcdn.com/iru/eRO3-umTSfRlw-QU/assets/media/images/iru-scim-delete-integration.png?fit=max&auto=format&n=eRO3-umTSfRlw-QU&q=85&s=f540e04a54a5ab4db9060b2aa9b6d599" alt="Auslassungsmenü der SCIM-Integration mit der Option Delete integration" width="868" height="496" data-path="assets/media/images/iru-scim-delete-integration.png" />
    </Frame>
  </Step>

  <Step title="Löschen bestätigen">
    Bestätigen Sie in der Aufforderung, dass Sie die Integration löschen möchten.

    <Frame>
      <img src="https://mintcdn.com/iru/09oHsghqQ24xDtMY/assets/media/images/iru-scim-delete-prompt.png?fit=max&auto=format&n=09oHsghqQ24xDtMY&q=85&s=fd94a0d15d035bb5c9b6468ef97b0662" alt="Bestätigungsaufforderung zum Löschen der SCIM-Integration" width="1108" height="728" data-path="assets/media/images/iru-scim-delete-prompt.png" />
    </Frame>
  </Step>
</Steps>

### SCIM-Schema und unterstützte Attribute

Iru Endpoint unterstützt die folgenden SCIM-Attribute. Beziehen Sie sich auf diese Attribute, wenn Sie Ihre SCIM-Anwendung in Ihrem IdP zuordnen.

<Note>
  Iru Endpoint verwendet keine Attribute, die nicht in der folgenden Liste enthalten sind. Um die gesendeten Attribute einzuschränken, ändern Sie bitte die in der SCIM-App in Ihrem IdP konfigurierten Attribute.
</Note>

**Benutzerattribute**

| **Attribut** | **Beschreibung** | **Erforderlich** |
| - | - | - |
| userName | Eindeutige Kennung des Benutzers, die zur Authentifizierung beim Service Provider verwendet wird | Ja |
| name.formatted | Der vollständige Name des Benutzers (zum Beispiel „John Doe“). Dieses Attribut oder das Attribut displayName ist erforderlich | Nein |
| displayName | Der vollständige Name des Benutzers (zum Beispiel „John Doe“). Dieses Attribut oder das Attribut name.formatted ist erforderlich | Ja |
| title | Der Titel des Benutzers, z. B. „Vice President“. | Nein |
| active | Der Status des Benutzers beim Identitätsanbieter. Dieses Attribut wird vom Identitätsanbieter automatisch hinzugefügt. | Ja |
| emails.value | Die E-Mail-Adresse des Benutzers als Unterattribut von emails. Iru Endpoint speichert nur die erste E-Mail-Adresse in der Liste. | Ja |
| department | Gibt den Namen einer Abteilung an. | Nein |

Wenn die erste Übertragung für einen Benutzer `active` auf `false` setzt, erstellt Iru Endpoint diesen Benutzer als gesperrt.

**Gruppenattribute**

| **Attribut** | **Beschreibung** | **Erforderlich** |
| - | - | - |
| displayName | Ein lesbarer Name für die Gruppe. | Ja |
| members | Eine Liste der Mitglieder der Gruppe. | Ja |

Wenn Sie SCIM zum Synchronisieren von Benutzern aus einem Verzeichnis verwenden, sendet die SCIM-App neue Informationen automatisch an Iru Endpoint, sodass keine Schaltfläche „Sync Now“ erforderlich ist, wie Sie sie bei den nativen Verzeichnisintegrationen für Entra ID oder Google Workspace sehen würden. Jeder Cloud-IdP hat seinen eigenen Standard für die Synchronisierung von SCIM-Daten.

Bitte lesen Sie in der Dokumentation Ihres Identitätsanbieters nach, wie die SCIM-Synchronisierung konfiguriert wird.

### Verwandte Artikel

Konfigurieren Sie SCIM in Ihrem Identitätsanbieter anhand des Artikels für Ihren IdP. Die SCIM-Implementierung von Iru Endpoint folgt der SCIMv2-Spezifikation.

<CardGroup cols={3}>
  <Card title="SCIM-Verzeichnisintegration mit Okta" icon="key" href="/de/endpoint/integrations/scim/scim-directory-integration-with-okta">
    Verbinden Sie Okta mit Iru Endpoint für die automatische Bereitstellung von Benutzern und Gruppen über SCIM
  </Card>

  <Card title="SCIM-Verzeichnisintegration mit Microsoft Entra ID" icon="microsoft" iconType="brands" href="/de/endpoint/integrations/scim/scim-directory-integration-with-microsoft-entra-id">
    Verbinden Sie Microsoft Entra ID (ehemals Azure AD) mit Iru Endpoint für die SCIM-basierte Bereitstellung von Benutzern und Gruppen
  </Card>

  <Card title="SCIM-Verzeichnisintegration mit OneLogin" icon="key" href="/de/endpoint/integrations/scim/scim-directory-integration-with-onelogin">
    Verbinden Sie OneLogin mit Iru Endpoint für die automatische Bereitstellung von Benutzern und Gruppen über SCIM
  </Card>
</CardGroup>