Skip to main content
Diese Anleitung gilt für Mac-Computer

Über die Passport-Fehlerbehebung mit Okta

Die Passport-Fehlerbehebung mit Okta umfasst die Lösung von Authentifizierungsproblemen, die bei der Verwendung von Passport mit Okta als Identitätsanbieter (IdP) auftreten. Diese Anleitung hilft Ihnen, häufige Konfigurations- und Authentifizierungsprobleme speziell bei der Okta-Integration zu erkennen und zu beheben.

Funktionsweise

Wenn bei Okta Probleme mit der Passport-Authentifizierung auftreten, umfasst die Fehlerbehebung die Prüfung der Okta-Anwendungseinstellungen, die Überprüfung der OIDC-Konfiguration, die Untersuchung der Authentifizierungsabläufe und die Behebung von Konfigurationsabweichungen zwischen Passport und Ihrem Okta-Mandanten.

Anmeldung, Diagnose und Netzwerk

Mit der vollständigen E-Mail-Adresse anmelden

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.

Passport Diagnostics verwenden

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.

Netzwerkverbindung bestätigen

Passport muss Okta 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.

WLAN-Einschränkungen und Isolationstests

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.

Häufige Okta-Fehler

Informationen zum Nachschlagen von Okta-API-Fehlercodes finden Sie unter Okta API Error Codes auf der Okta-Entwicklerseite.
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. Diese Antwort bedeutet in der Regel, dass die Anmeldedaten nicht mit den von Okta erwarteten übereinstimmen.
  • 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 Okta in der Regel korrekt. In Okta kann derselbe Wert als Application ID angezeigt werden.
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 Okta, dass der Benutzer oder die Gruppe der Passport-OIDC-Anwendung zugewiesen ist und dass die Anmelderegeln den Zugriff 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 Okta in der Regel korrekt. In Okta kann derselbe Wert als Application ID angezeigt werden.