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

# Benutzerdefiniertes OIDC

> Verbinden Sie einen beliebigen OpenID Connect-Identitätsanbieter mit Iru Identity für die föderierte Anmeldung, indem Sie Iru als Client registrieren und Claims Benutzerattributen zuordnen.

Wenn Ihr Identitätsanbieter den **OpenID Connect (OIDC)**-Standard unterstützt, aber
nicht durch eine fertige Vorlage abgedeckt ist, verbinden Sie ihn als **benutzerdefinierte OIDC**-Verbindung.
Iru registriert sich als **Client** Ihres Anbieters: Ihr Anbieter authentifiziert den
Benutzer und gibt Identitätsdaten an Iru zurück, die Iru verwendet, um die Sitzung zu starten
und den Benutzer einem Iru-Benutzer zuzuordnen.

<Warning>
  Benutzerdefinierte OIDC-Verbindungen sind **demnächst verfügbar**. Google Workspace-, Microsoft Entra
  ID- und benutzerdefinierte SAML-Verbindungen sind bereits heute verfügbar.
</Warning>

<Info>
  Bei den meisten Organisationen, die Iru Identity als Identitätsanbieter verwenden, melden sich Benutzer
  direkt mit einem Passkey oder der Iru Access-App an. Verbinden Sie einen OIDC-Anbieter,
  wenn Sie Iru Identity als Authentifizierungsschicht für die Iru-Plattform
  statt als primären Identitätsanbieter verwenden oder um eine Migration zu Iru
  Identity zu erleichtern. Siehe [Föderierte Authentifizierung](/de/identity/connections/connections-overview).
</Info>

<Note>
  Sie benötigen Administratorzugriff auf Ihren Iru-Mandanten sowie Administratorzugriff auf
  Ihren OIDC-Identitätsanbieter, um diese Verbindung einzurichten.
</Note>

## Bevor Sie beginnen

<Steps>
  <Step title="Iru als Anwendung bei Ihrem Anbieter registrieren">
    Erstellen Sie in Ihrem OIDC-Anbieter eine Anwendung (Client) für Iru, typischerweise einen
    **Web**- oder **vertraulichen** Client, der den Authorization Code Flow verwendet. Sie
    erhalten eine **Client-ID** und ein **Client-Secret**, die Sie in Iru eingeben. Die genauen
    Schritte finden Sie in der Konsole Ihres Anbieters; folgen Sie dessen aktueller Dokumentation.
  </Step>

  <Step title="Redirect-URI von Iru hinzufügen">
    Ihr Anbieter muss wissen, wohin der Benutzer nach der Anmeldung zurückgeleitet werden soll.
    Kopieren Sie die **Redirect-URI**, die Iru für diese Verbindung anzeigt, und fügen Sie sie der
    Liste der zulässigen Redirect-URIs in der Anwendung Ihres Anbieters hinzu.
  </Step>

  <Step title="Benötigte Scopes bestätigen">
    Iru fordert die Standard-OpenID Connect-**Scopes** (`openid`, `profile` und
    `email`) an, damit Ihr Anbieter das Basisprofil und die E-Mail-Adresse des Benutzers zurückgibt. Stellen
    Sie sicher, dass Ihr Anbieter so konfiguriert ist, dass er den Claim freigibt, über den Sie die Zuordnung vornehmen möchten.
  </Step>

  <Step title="Sicherstellen, dass Ihre Benutzer in Iru vorhanden sind">
    Eine Anmeldung über eine Verbindung wird einem vorhandenen Iru-Benutzer zugeordnet. Fügen Sie
    Ihre Benutzer zuerst hinzu oder importieren Sie sie; siehe [Benutzer importieren](/de/identity/directory/importing-users)
    oder [Directory Sync](/de/identity/directory/directory-sync).
  </Step>
</Steps>

## Einen OIDC-Anbieter verbinden

<Steps>
  <Step title="Verbindung hinzufügen">
    Fügen Sie unter **Access → Authentication** eine **Authentifizierungsmethode** hinzu und wählen Sie **OIDC**.
  </Step>

  <Step title="Client-Details eingeben">
    Geben Sie die **Client-ID** und das **Client-Secret** der Anwendung ein, die Sie
    bei Ihrem Anbieter registriert haben, zusammen mit den Angaben, die Iru benötigt, um die
    Anmelde-Endpunkte Ihres Anbieters zu erreichen.
  </Step>

  <Step title="Claim für die Benutzerkennung wählen">
    Teilen Sie Iru mit, welcher **Claim** in der Antwort Ihres Anbieters den Benutzer identifiziert –
    zum Beispiel der Subject-, E-Mail- oder Preferred-Username-Claim. Dies ist der
    Wert, den Iru liest, um zu erkennen, wer sich angemeldet hat.
  </Step>

  <Step title="Benutzerzuordnung festlegen">
    Wählen Sie, mit welchem Iru-Benutzerwert dieser Claim abgeglichen wird (UPN, Benutzername,
    externe ID oder ein benutzerdefiniertes Attribut). Wählen Sie einen Wert, der für jeden Benutzer eindeutig und stabil
    ist. Siehe [Benutzerzuordnung](/de/identity/connections/connections-overview#what-you-configure-on-every-identity-provider-connection).
  </Step>

  <Step title="Verwendungszweck der Verbindung wählen">
    Wählen Sie die **Anwendungsfälle** der Verbindung: **Endbenutzer-Anmeldung**, **Geräteregistrierung**
    oder beides.
  </Step>

  <Step title="Auf Ihre Domänen beschränken">
    Wenn nur Benutzer in bestimmten E-Mail-Domänen diese Verbindung verwenden sollen,
    aktivieren Sie **Domänenbeschränkungen** und fügen Sie diese Domänen hinzu.
  </Step>

  <Step title="Speichern und testen">
    Speichern Sie die Verbindung und melden Sie sich dann als Testbenutzer an, um die Übergabe zu bestätigen:
    Ihr Anbieter authentifiziert den Benutzer, gibt den identifizierenden Claim zurück und
    Iru ordnet ihn dem richtigen Benutzer zu.
  </Step>
</Steps>

<Tip>
  Der **Claim für die Benutzerkennung** und Ihre Wahl der **Benutzerzuordnung** wirken zusammen:
  Der Claim ist der Wert, den Ihr Anbieter sendet, und die Zuordnung legt fest, welchem Iru-Benutzerfeld
  er entsprechen muss. Wählen Sie einen Claim, den Ihr Anbieter für alle befüllt
  und der mit dem Iru-Wert übereinstimmt, über den Sie die Zuordnung vornehmen.
</Tip>

## So funktioniert die Anmeldung nach der Verbindung

Wenn sich jemand anmeldet, übergibt Iru die Anmeldung an Ihren OIDC-Anbieter. Der
Anbieter authentifiziert den Benutzer und gibt Identitäts-Claims zurück, Iru ordnet diese
einem Iru-Benutzer zu, und die Sitzung wird fortgesetzt. Anschließend wertet Iru die
[Authentifizierungsrichtlinie](/de/identity/authentication/authentication-policies) der App aus,
bevor Zugriff gewährt wird. Einen vollständigen Überblick finden Sie unter
[Systemarchitektur](/de/identity/getting-started/system-architecture).

## Verwandte Themen

<CardGroup cols={2}>
  <Card title="Föderierte Authentifizierung" icon="plug" href="/de/identity/connections/connections-overview">
    Anwendungsfälle, Domänenbeschränkungen und Benutzerzuordnung an einem Ort erklärt.
  </Card>

  <Card title="Benutzerdefiniertes SAML" icon="shield-halved" href="/de/identity/connections/custom-saml">
    Verbinden Sie einen Identitätsanbieter, der SAML statt OpenID Connect verwendet.
  </Card>

  <Card title="Google Workspace" icon="google" href="/de/identity/connections/google-workspace">
    Verbinden Sie Google Workspace mit der fertigen Vorlage.
  </Card>

  <Card title="Microsoft Entra ID" icon="microsoft" href="/de/identity/connections/microsoft-entra-id">
    Verbinden Sie Microsoft Entra ID mit der fertigen Vorlage.
  </Card>
</CardGroup>