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

# Erweiterte Passport-Fehlerbehebung

> Beheben Sie erweiterte Passport-Probleme in Iru Endpoint. Diagnostizieren Sie Fehler bei der Token-Aktualisierung, IdP-Synchronisierungsprobleme, Schlüsselbundfehler und Anmeldeschleifen.

<Callout icon="apple" color="#B84A7A" iconType="regular">Diese Anleitung gilt für Mac-Computer</Callout>

### Anmeldung, Diagnose und Netzwerk

<CardGroup cols={2}>
  <Card title="Mit der vollständigen E-Mail-Adresse anmelden" icon="user">
    Geben Sie im Passport-Anmeldefenster immer die vollständige E-Mail-Adresse des Benutzers in das Feld für den Benutzernamen ein, damit die Sitzung Ihren IdP statt der lokalen Authentifizierung verwendet. Wie das Anmeldefenster und die Sichtbarkeitseinstellungen mit Passport zusammenwirken, erfahren Sie unter [Passport-Kompatibilität](/de/endpoint/library/passport/passport-compatibility-with-macos-and-iru-endpoint-features#login-window).
  </Card>

  <Card title="Passport Diagnostics verwenden" icon="display">
    Wenn sich ein Benutzer nicht anmelden kann, öffnen Sie Iru Endpoint Passport Diagnostics auf dem Mac mit **Command-Shift-K-L**. Das Fenster zeigt nützliche Details an, einschließlich der von Ihrem IdP zurückgegebenen Fehlermeldungen.
  </Card>

  <Card title="Netzwerkverbindung bestätigen" icon="wifi">
    Passport muss Ihren IdP erreichen, um Anmeldedaten zu validieren. Wenn Sie das Passport-Anmeldefenster anpassen, aktivieren Sie den Netzwerkmanager, damit Benutzer bei Bedarf einem WLAN beitreten können. Die Steuerung berücksichtigt die AirPort-Sicherheitseinstellungen in macOS.
  </Card>

  <Card title="WLAN-Einschränkungen und Isolationstests" icon="triangle-exclamation">
    Passport zeigt oben rechts im Anmeldefenster ein WLAN-Symbol an; Benutzer können es auswählen, um einem passwortgeschützten Netzwerk beizutreten. Passport unterstützt keine Captive Portals, Click-Through-Bestätigungsseiten oder Enterprise-802.1X-Netzwerke, die in diesem Ablauf einen separaten Benutzernamen und ein separates Passwort erfordern. Um Netzwerkprobleme einzugrenzen, testen Sie im Passport-Anmeldefenster mit einem mobilen Hotspot oder kabelgebundenem Ethernet.
  </Card>
</CardGroup>

### Nachnamen (familyName) in Ihrem IdP sicherstellen

Passport erfordert einen **familyName**-Wert in den Benutzerattributen des IdP. Füllen Sie **Last name** oder das entsprechende Nachnamenfeld für jedes Konto aus, das sich mit Passport anmeldet, einschließlich Dienstkonten, mit denen Sie testen.

### Von Passport unterstützte IdPs

Die derzeit von Iru Endpoint Passport unterstützten IdPs sind [Google Workspace](/de/endpoint/library/passport/google-workspace/passport-configuration-with-google-workspace), [Microsoft Entra ID](/de/endpoint/library/passport/microsoft-entra-id/passport-troubleshooting-with-microsoft-entra-id-formerly-azure-ad), [Okta](/de/endpoint/library/passport/okta/passport-configuration-with-okta) und [OneLogin](/de/endpoint/library/passport/onelogin/passport-configuration-with-onelogin).

### Passport-Anforderungen bei Verwendung anderer IdPs

Die [Passport-Konfiguration](/de/endpoint/library/passport/configure-the-passport-library-item) erfordert OIDC- und ROPG-Workflows (Resource Owner Password Grant), um zu funktionieren. Klären Sie mit Ihrem IdP, ob diese Funktionen unterstützt werden.

Iru bietet zwar die Wahl zwischen Mac-Anmeldung und Webanmeldung, richten Sie Passport jedoch zuerst mit Mac-Anmeldung ein, da bei der Konfiguration von Webanmeldung zusätzliche Faktoren eine Rolle spielen können. Als Referenz können Sie die unterstützten Konfigurationen mit Google Workspace, Microsoft Entra ID, Okta oder OneLogin heranziehen.

* [Passport-Konfiguration mit Google Workspace](/de/endpoint/library/passport/google-workspace/passport-configuration-with-google-workspace)
* [Passport-Konfiguration mit Microsoft Entra ID (früher Azure AD)](/de/endpoint/library/passport/microsoft-entra-id/configure-passport-with-microsoft-entra-id-mac-login)
* [Passport-Konfiguration mit Okta](/de/endpoint/library/passport/okta/passport-configuration-with-okta)
* [Passport-Konfiguration mit OneLogin](/de/endpoint/library/passport/onelogin/passport-configuration-with-onelogin)

Wenn Sie keinen der oben genannten Identitätsanbieter verwenden, können Sie Passport möglicherweise trotzdem über die Option **Sonstige** konfigurieren.

### Anderen IdP konfigurieren

#### Authentifizierungskonfiguration

* Wenn Sie einen anderen IdP als Google Workspace, Microsoft Entra ID, Okta oder OneLogin konfigurieren, wählen Sie im Dropdown-Menü **Identitätsanbieter** die Option **Sonstige** aus.

#### Authentifizierungsmodus

* Wenn Sie **keine** Multi-Faktor-Authentifizierung (MFA) verwenden, müssen Sie Mac-Anmeldung wählen.

* Wenn Sie Multi-Faktor-Authentifizierung (MFA) **verwenden**, müssen Sie Webanmeldung wählen.

#### Mac-Anmeldung

<Steps>
  <Step title="Identity Provider URL eingeben">
    Geben Sie die **Identitätsanbieter-URL** ein.
  </Step>

  <Step title="Client ID eingeben">
    Geben Sie die **Client ID** der Passport-App ein, die Sie in Ihrem IdP erstellt haben (kann auch App ID heißen)
  </Step>
</Steps>

#### Webanmeldung

<Steps>
  <Step title="Identity Provider URL eingeben">
    Geben Sie die **Identity Provider URL** ein
  </Step>

  <Step title="Client ID eingeben">
    Geben Sie die **Client ID** der Passport-App ein, die Sie in Ihrem IdP erstellt haben (kann auch App ID heißen)
  </Step>

  <Step title="PKCE- und POST-Authentifizierungsunterstützung konfigurieren">
    Bei Verwendung von Webanmeldung muss Ihre App sowohl die PKCE-Authentifizierung (Proof Key for Code Exchange) als auch die POST-Authentifizierung unterstützen. Bei einigen IdPs müssen dafür zwei verschiedene Apps konfiguriert werden.
  </Step>

  <Step title="Redirect URI festlegen">
    Die **Redirect URI** sollte in den meisten Fällen die Standard-Redirect-URI Ihres IdP sein.
  </Step>
</Steps>

### Fehlerbehebung

Bei der Behebung von Passport-Problemen mit der Option **Sonstige** als Passport-IdP sind viele Faktoren zu berücksichtigen. Dieser Abschnitt hilft Ihnen, Fehler zu erfassen, zu verstehen und die Konfiguration anzupassen.

<AccordionGroup>
  <Accordion title="POST token 401: Ungültige Benutzeranmeldedaten">
    **Was Sie sehen:**

    `"error":"Unauthorized","error_description":"Authentication Failed: Invalid user credentials"`

    **Was zu tun ist:**

    * Bestätigen Sie Benutzername und Passwort bei Ihrem IdP.
    * Wenn die GET-Anfrage an Ihre OIDC-Well-known-URL `openid-configuration` **200** zurückgibt, erreichen die **Identitätsanbieter-URL** und die **Client ID** im Passport Library Item den IdP in der Regel korrekt. Ihr IdP bezeichnet die Client-Kennung möglicherweise als **Application ID**.
  </Accordion>

  <Accordion title="POST token 403: Benutzer hat keinen Zugriff auf die Passport-App">
    **Was Sie sehen:**

    `"error":"access_denied","error_description":"End-user does not have access to this application"`

    **Was zu tun ist:**

    * Bestätigen Sie in Ihrem IdP, dass der Benutzer oder die Gruppe auf die Passport-OIDC-Anwendung zugreifen kann und dass Anmelde- oder Zugriffsregeln dies zulassen.
    * Wenn die GET-Anfrage an Ihre OIDC-Well-known-URL `openid-configuration` **200** zurückgibt, erreichen die **Identitätsanbieter-URL** und die **Client ID** im Passport Library Item den IdP in der Regel korrekt. Ihr IdP bezeichnet die Client-Kennung möglicherweise als **Application ID**.
  </Accordion>

  <Accordion title="Ticket Decode failed">
    **Was Sie sehen:**

    Ticket decode failed. Failed to login with possible error: Unknown

    **Was zu tun ist:**

    * Entfernen Sie das optionale **Client secret** aus dem Passport Library Item, lassen Sie das Gerät einchecken, melden Sie den lokalen Benutzer ab und melden Sie sich erneut mit Passport an.
    * Wenn der Fehler weiterhin besteht, schließen Sie Netzwerkprobleme mit einem mobilen Hotspot im Passport-Anmeldefenster aus.
  </Accordion>

  <Accordion title="No key was found matching familyName">
    **Was Sie sehen:**

    An error occurred fetching user info: No key was found matching "familyName"

    **Was zu tun ist:**

    * Füllen Sie **Last name** oder das entsprechende Nachnamenfeld für den Benutzer in Ihrem IdP aus. Passport erfordert dieses Attribut.
  </Accordion>
</AccordionGroup>

Wenn weiterhin Probleme mit Passport auftreten, [wenden Sie sich an den Support](/de/iru/iru-support/support-customer-portal).

#### Fehlercode-Suche

Viele IdPs generieren eigene spezifische Fehlercodes. Prüfen Sie bei Ihrem IdP, ob es eine Suchseite gibt, auf der Sie mehr über den jeweiligen Fehler erfahren können. Ein Beispiel dafür ist das [Fehlercode-Formular](https://login.microsoftonline.com/error) von Microsoft zum Nachschlagen von Microsoft Entra ID-Fehlern.

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Passport-Kompatibilität mit macOS- und Iru Endpoint-Funktionen" icon="apple" href="/de/endpoint/library/passport/passport-compatibility-with-macos-and-iru-endpoint-features">
    Passport-Kompatibilität mit macOS- und Iru-Funktionen
  </Card>

  <Card title="Passwörter mit Passport verwalten" icon="key" href="/de/endpoint/library/passport/managing-passwords-with-passport">
    So verwalten Sie Passwörter mit Passport.
  </Card>
</CardGroup>