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

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

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.

​
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, Microsoft Entra ID, Okta und OneLogin.

​
Passport-Anforderungen bei Verwendung anderer IdPs

Die Passport-Konfiguration 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. 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

1

Identity Provider URL eingeben

Geben Sie die Identitätsanbieter-URL ein.
2

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)

​
Webanmeldung

1

Identity Provider URL eingeben

Geben Sie die Identity Provider URL ein
2

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)
3

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

Redirect URI festlegen

Die Redirect URI sollte in den meisten Fällen die Standard-Redirect-URI Ihres IdP sein.

​
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.
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.
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.
Was Sie sehen:Ticket decode failed. Failed to login with possible error: UnknownWas 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.
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.
Wenn weiterhin Probleme mit Passport auftreten, wenden Sie sich an den Support.

​
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 von Microsoft zum Nachschlagen von Microsoft Entra ID-Fehlern.

​
Verwandte Artikel

Passport-Kompatibilität mit macOS- und Iru Endpoint-Funktionen

Passport-Kompatibilität mit macOS- und Iru-Funktionen

Passwörter mit Passport verwalten

So verwalten Sie Passwörter mit Passport.