1Password mit XFA absichern
Ergänzen Sie 1Password Unlock with SSO um einen Gerätecheck, damit nur Geräte, die Ihre XFA-Richtlinie erfüllen, 1Password mit Google oder einem anderen OpenID Connect Identity Provider entsperren können.
So funktioniert es
Wenn jemand 1Password per Single Sign-On entsperrt, leitet 1Password die Person zu XFA weiter. XFA prüft ihr Gerät anhand Ihrer Richtlinie und leitet sie danach zur Anmeldung an Ihren Identity Provider weiter. Nach der Anmeldung kehrt die Person zu 1Password zurück, und 1Password wird entsperrt. 1Password erhält von Ihrem Identity Provider dasselbe Anmeldeergebnis wie ohne XFA. XFA liest aus diesem Ergebnis nur die E-Mail-Adresse der Person, um zu wissen, wessen Gerät es geprüft hat.
Hinweis: Dieser Artikel setzt voraus, dass Ihre Organisation ein XFA-Konto hat und dass Sie Administrator dieser Organisation sind. Wenn Sie noch kein Konto haben, können Sie eines unter https://dashboard.xfa.tech/signup erstellen.
Bevor Sie beginnen
- Ein 1Password Business-Konto, in dem Sie die Rolle Eigentümer oder Administrator haben
- Admin-Zugriff auf Ihren Identity Provider
- Eine Admin-Rolle in XFA
- Gerätegenehmigung für Multi-Faktor-Authentifizierung in XFA ausgeschaltet (Gerätegenehmigung für Multi-Faktor-Authentifizierung verlangen, unter Verbindungen > Einstellungen). Wenn Ihre Organisation sie verlangt, können Sie XFA noch nicht mit 1Password nutzen: XFA lehnt die Anmeldung ab.
Ihr Identity Provider muss:
- die E-Mail-Adresse der Person in das ID-Token schreiben;
- PKCE (S256) unterstützen, wenn Sie einen Public Client verwenden (einen ohne Client Secret);
- eine feste Issuer-Adresse haben: die Adresse Ihres Identity Providers, die Sie 1Password als Issuer angeben und die bei jeder Anmeldung in Ihrer Organisation dieselbe ist (verwenden Sie bei Microsoft Entra ID den eigenen Issuer Ihres Tenants, nicht den
common-Issuer).
Google erfüllt all diese Anforderungen. Jeder andere Provider, der sie erfüllt, lässt sich ebenfalls verwenden.
Es gelten die eigenen Regeln von 1Password für Unlock with SSO:
- Mitglieder der Gruppe Owners entsperren nie per SSO. Sie entsperren mit ihrem Kontopasswort und ihrem Secret Key.
- 1Password akzeptiert für Unlock with SSO nur einen Identity Provider.
- 1Password speichert eine Konfiguration erst nach einem erfolgreichen Test Connection.
Wohin welcher Wert gehört
- XFA redirect URI: von XFA zu Ihrem Identity Provider
- Authorization Endpoint und Token Endpoint: die von XFA, von XFA zu 1Password
- Issuer und User Info Endpoint: die Ihres Identity Providers, zu 1Password
- Client ID (und Client Secret): von Ihrem Identity Provider zu 1Password
- Discovery-URL: von Ihrem Identity Provider zu XFA (XFA-Schritt 1, nur bei Anderer)
Die 1Password-Anwendung in XFA anlegen
- Gehen Sie im XFA-Dashboard zu Integrationen und klicken Sie auf der Karte 1Password auf Einrichten und dann im Abschnitt Anmeldeprüfungen auf Einrichten. XFA öffnet 1Password mit XFA absichern.
- Geben Sie in der Karte Grundeinstellungen unter Name einen Namen ein. Wählen Sie unter Richtlinie die XFA-Richtlinie mit den Gerätechecks, die beim Entsperren gelten sollen.
- Geben Sie in XFA-Schritt 1 (Ihr 1Password-Konto in XFA eintragen) unter Ihre 1Password-Anmeldeadresse die Adresse ein, unter der Sie 1Password öffnen, zum Beispiel
team-acme.1password.com. XFA trägt die beiden eigenen Redirect URIs von 1Password ein: eine für den Browser und eine für die 1Password-Apps. Mit ihnen müssen Sie nichts tun. Der Wert, den Sie später kopieren, ist die XFA redirect URI aus Schritt 2. - Wählen Sie unter Identitätsanbieter Ihren Provider. Diese Auswahl gibt es nur in XFA. In 1Password wählen Sie immer Other und dann Manual.
- Google: XFA trägt die Angaben von Google ein.
- Anderer, für jeden anderen Provider: Fügen Sie die URL in Discovery-URL Ihres Identitätsanbieters (sie endet auf /.well-known/openid-configuration) ein und klicken Sie auf Ausfüllen.
- Klicken Sie auf Speichern und später fortfahren. Damit ist Schritt 1 gespeichert.
- XFA-Schritt 2 zeigt unter Für Ihren Identitätsanbieter die XFA redirect URI. XFA-Schritt 3 zeigt unter Für 1Password den Token Endpoint und den Authorization Endpoint von XFA.
Ihren Identity Provider einrichten
Sie brauchen in Ihrem Identity Provider einen OAuth-Client für 1Password (manche Provider nennen ihn Anwendung oder App-Integration). Wenn Ihr Team 1Password schon per SSO entsperrt, können Sie diesen Client weiter verwenden. Wenn nicht, legen Sie ihn mit der Anleitung von 1Password für Ihren Provider an. Wo diese Anleitung 1Password einrichtet, folgen Sie stattdessen Unlock with SSO in 1Password einrichten.
Bei jedem Provider fügen Sie vor allem die XFA redirect URI als zusätzliche zulässige Redirect URI hinzu. Entfernen Sie die Redirect URIs von 1Password nicht, die schon dort stehen. Jeder Provider muss außerdem die E-Mail-Adresse der Person in das ID-Token schreiben (Bevor Sie beginnen). Kopieren Sie danach die Client ID und, falls es eines gibt, das Client Secret: Beides kommt in 1Password, nicht in XFA. Klicken Sie dann bei XFA-Schritt 2 auf Als erledigt markieren.
Anleitung von 1Password: Configure Unlock 1Password with Google. Der Client hat den Typ Web application.
- Öffnen Sie in der Google Cloud Console APIs & Services > Clients und wählen Sie den Client aus.
- Klicken Sie unter Authorized redirect URIs auf Add URI, fügen Sie die XFA redirect URI ein und klicken Sie auf Save.
- Öffnen Sie im OAuth consent screen den Bereich Branding. Fügen Sie unter Authorized domains
xfa.techneben1password.comhinzu und klicken Sie auf Save. - Kopieren Sie die Client ID und das Client secret. Google gibt immer ein Client Secret.
Laut Google können Änderungen 5 Minuten bis einige Stunden dauern.
In 1Password: Issuer https://accounts.google.com, User Info Endpoint https://openidconnect.googleapis.com/v1/userinfo, Client Type Private Client mit dem Client Secret.
Microsoft Entra ID
Anleitung von 1Password: Configure Unlock 1Password with Microsoft Entra ID.
- Öffnen Sie in der App-Registrierung für 1Password Authentication. Fügen Sie unter der Plattform Web die XFA redirect URI hinzu und klicken Sie auf Save.
- Klicken Sie unter Token configuration auf Add optional claim, wählen Sie ID und dann email, damit das ID-Token die E-Mail-Adresse enthält.
- Kopieren Sie die Application (client) ID und den Wert des Client Secrets.
Die Discovery-URL ist das OpenID Connect metadata document unter Overview > Endpoints. Sie enthält Ihre Tenant-ID: https://login.microsoftonline.com/<your-tenant-id>/v2.0/.well-known/openid-configuration.
In 1Password: Issuer https://login.microsoftonline.com/<your-tenant-id>/v2.0, User Info Endpoint https://graph.microsoft.com/oidc/userinfo, Client Type Private Client mit dem Client Secret. Wählen Sie Public Client nur, wenn Sie die XFA redirect URI unter der Plattform Mobile and desktop applications statt unter Web hinzugefügt haben.
Okta
Anleitung von 1Password: Configure Unlock 1Password with Okta.
-
Fügen Sie in der Okta-App für 1Password die XFA redirect URI unter Sign-in redirect URIs hinzu und klicken Sie auf Save.
Die 1Password-App aus dem Okta-Katalog lässt Sie möglicherweise keine Redirect URI hinzufügen. Legen Sie dann stattdessen eine eigene App an: Applications > Create App Integration > OIDC - OpenID Connect > Web Application. Fügen Sie die XFA redirect URI unter Sign-in redirect URIs hinzu.
-
Kopieren Sie die Client ID und, falls es eines gibt, das Client Secret.
Die Discovery-URL ist https://<your-okta-domain>/.well-known/openid-configuration.
In 1Password: Öffnen Sie die Discovery-URL in Ihrem Browser. Issuer ist der Wert issuer darin und User Info Endpoint der Wert userinfo_endpoint. Client Type: Private Client mit dem Client Secret einer Web Application. Wählen Sie Public Client nur bei einer Native Application oder Single-Page Application, die die Client-Authentifizierung None verwendet und PKCE verlangt.
Auth0
Anleitung von 1Password: Configure Unlock 1Password with Auth0.
- Fügen Sie in der Auth0-Anwendung für 1Password die XFA redirect URI zu Allowed Callback URLs hinzu. Trennen Sie sie mit einem Komma von den URLs, die schon dort stehen. Klicken Sie auf Save Changes.
- Kopieren Sie die Client ID und, falls die Anwendung eines hat, das Client Secret.
Die Discovery-URL ist https://<your-domain>.auth0.com/.well-known/openid-configuration.
In 1Password: Öffnen Sie die Discovery-URL in Ihrem Browser. Issuer ist der Wert issuer darin und User Info Endpoint der Wert userinfo_endpoint. Client Type: Private Client, wenn die Anwendung ein Client Secret hat, sonst Public Client.
JumpCloud
Anleitung von 1Password: Configure Unlock 1Password with JumpCloud.
- Fügen Sie in der JumpCloud-OIDC-App für 1Password auf dem Tab SSO die XFA redirect URI zu Redirect URIs hinzu und speichern Sie.
- Kopieren Sie die Client ID und, falls die App eines hat, das Client Secret.
Die Discovery-URL ist https://oauth.id.jumpcloud.com/.well-known/openid-configuration, bei einem EU-Konto https://oauth.id.eu.jumpcloud.com/.well-known/openid-configuration.
In 1Password: Öffnen Sie die Discovery-URL in Ihrem Browser. Issuer ist der Wert issuer darin und User Info Endpoint der Wert userinfo_endpoint. Client Type: Private Client, wenn die App ein Client Secret hat, sonst Public Client.
Andere OpenID Connect Provider
Anleitung von 1Password: Configure Unlock 1Password with other identity providers. Verwenden Sie diesen Abschnitt für Duo, OneLogin, Ping Identity und jeden anderen OpenID Connect Provider.
- Fügen Sie in der OpenID Connect-Anwendung Ihres Providers für 1Password die XFA redirect URI zu den zulässigen Redirect URIs hinzu.
- Prüfen Sie, ob der Provider die E-Mail-Adresse in das ID-Token schreibt. Manche Provider brauchen dafür eine Einstellung oder ein Claim-Mapping.
- Kopieren Sie die Client ID und, falls die Anwendung eines hat, das Client Secret.
Die Discovery-URL finden Sie in der Dokumentation Ihres Providers.
In 1Password: Öffnen Sie die Discovery-URL in Ihrem Browser. Issuer ist der Wert issuer darin und User Info Endpoint der Wert userinfo_endpoint. Client Type: Private Client, wenn die Anwendung ein Client Secret hat, sonst Public Client.
Unlock with SSO in 1Password einrichten
- Melden Sie sich auf 1Password.com bei Ihrem 1Password-Konto an und wählen Sie in der Seitenleiste Policies.
- Wählen Sie unter Single sign-on die Option Manage policies.
- Wählen Sie Other, auch wenn Sie Google verwenden, und danach Manual, damit Sie jeden Wert selbst eingeben können. 1Password muss zuerst mit XFA sprechen. Die Google-Option von 1Password würde XFA überspringen.
- Füllen Sie die Felder aus:
- Client ID: aus Ihrem Identity Provider
- Issuer: der Ihres Identity Providers
- Token Endpoint: der von XFA
- Authorization Endpoint: der von XFA
- User Info Endpoint: der Ihres Identity Providers
- Client Type: wie im Abschnitt zu Ihrem Provider angegeben. 1Password markiert Public Client als empfohlen; ignorieren Sie diese Markierung. Wählen Sie Private Client, wenn Ihr Provider Ihnen ein Client Secret gegeben hat (Google immer), und fügen Sie es in Client secret (value) ein. Wählen Sie Public Client nur, wenn es kein Secret gibt.
- Wählen Sie Next. 1Password zeigt seine Redirect URIs an. Diese müssen Sie nicht kopieren. XFA hat sie anhand Ihrer Anmeldeadresse eingetragen.
- Klicken Sie in XFA bei XFA-Schritt 3 auf Als erledigt markieren.
- Wählen Sie in 1Password Next und dann Test Connection. 1Password öffnet XFA, das das Gerät prüft, an dem Sie arbeiten, und Sie zur Anmeldung an Ihren Identity Provider weiterleitet. Wenn Ihr Gerät einen Check nicht besteht, zeigt XFA, was zu beheben ist. Beheben Sie es und führen Sie Test Connection erneut aus. Test Connection speichert nichts, für alle anderen ändert sich also noch nichts.
- Wenn der Test erfolgreich ist, wählen Sie Save. Das Speichern ersetzt Ihre bisherige SSO-Einrichtung: Ab dann läuft jeder, der 1Password per SSO entsperrt, durch den Gerätecheck von XFA.
- Legen Sie unter People unlocking 1Password with an identity provider fest, wer per SSO entsperrt. Beginnen Sie mit Only groups you select und einer kleinen Testgruppe, und erweitern Sie den Kreis, sobald das Entsperren für diese Gruppe funktioniert. Wenn Personen auf SSO umstellen, fragt 1Password sie einmal nach ihrem Kontopasswort und ihrem Secret Key.
- Klicken Sie in XFA bei XFA-Schritt 4 (Verbindung testen) auf Als erledigt markieren. Klicken Sie dann auf Einrichtung abschließen.
Was Personen sehen
XFA prüft das Gerät im Browser und in den 1Password-Apps jedes Mal, wenn 1Password die Person zur Anmeldung per SSO auffordert:
- Im Browser leitet 1Password die Person zu XFA weiter, dann zum Identity Provider und zurück zu 1Password.
- In der 1Password-Desktop-App öffnet sich der Browser für den Gerätecheck und die Anmeldung. Danach fragt der Browser, ob er 1Password öffnen darf, und die App wird entsperrt.
Wenn das Gerät die Richtlinie nicht erfüllt, zeigt XFA, welcher Check fehlschlägt und wie er sich beheben lässt. Wenn Ihre Richtlinie einen fehlgeschlagenen Check blockiert, wird das Entsperren abgebrochen. Wenn sie nur warnt, kann die Person fortfahren. Ob ein Check blockiert oder warnt, sehen Sie in der Richtlinie, unter Richtlinien in XFA.
XFA prüft das Gerät nicht, wenn:
- die Person per Biometrie entsperrt (Touch ID, Windows Hello, Gesichtserkennung), weil das nicht über SSO läuft;
- die Person in der Gruppe Owners von 1Password ist;
- die Person in keiner Gruppe ist, die per SSO entsperrt.
Die Verbindung testen
Jeder Administrator kann Test Connection ausführen, auch Eigentümer: Er testet die Verbindung, nicht ihr eigenes Entsperren. Um das Entsperren selbst zu testen, verwenden Sie ein Mitglied, das kein Eigentümer ist: Eigentümer verwenden nie SSO, daher läuft ihr Entsperren nicht über XFA. Fügen Sie dieses Mitglied zur Testgruppe hinzu. Sperren Sie 1Password und entsperren Sie es per SSO im Browser und in der Desktop-App. Das Mitglied sollte den Gerätecheck von XFA und die Anmeldung bei Ihrem Identity Provider durchlaufen, bevor 1Password entsperrt wird.
Fehlersuche
Der Identity Provider lehnt die Redirect URI ab
Google zeigt redirect_uri_mismatch, wenn die XFA redirect URI nicht unter den Authorized redirect URIs des Clients steht; andere Provider zeigen einen ähnlichen Fehler. Kopieren Sie sie mit der Schaltfläche Kopieren erneut aus XFA, damit sie genau übereinstimmt. Sie sieht so aus: https://device-api.xfa.tech/<application-id>/oauth2/redirect.
Wenn XFA die Weiterleitung ablehnt, stimmt die 1Password-Anmeldeadresse in XFA nicht mit Ihrem 1Password-Konto überein. Korrigieren Sie sie in XFA-Schritt 1. Verwenden Sie die Adresse, die in der Adressleiste Ihres Browsers steht, wenn Sie 1Password nutzen.
Test Connection schlägt fehl
- Authorization Endpoint und Token Endpoint in 1Password sind die von XFA. Issuer und User Info Endpoint sind die Ihres Identity Providers.
- Client ID, Client Type und das Client Secret in 1Password stimmen mit dem Client in Ihrem Identity Provider überein. Wenn nicht, zeigt Ihr Provider
invalid_client. - Das Gerät, mit dem Sie testen, erfüllt die XFA-Richtlinie, die Sie gewählt haben.
- Ihre E-Mail-Adresse beim Identity Provider ist dieselbe wie Ihre E-Mail-Adresse in 1Password.
Test Connection schlägt mit invalid_scope fehl
XFA bricht die Anmeldung mit invalid_scope ab, wenn das ID-Token Ihres Identity Providers keine E-Mail-Adresse enthält. Stellen Sie Ihren Provider so ein, dass er die E-Mail-Adresse in das ID-Token schreibt: Fügen Sie bei Microsoft Entra ID den optionalen Claim email hinzu (siehe Microsoft Entra ID).
Das Gerät erfüllt die Richtlinie nicht
XFA zeigt der Person, welcher Check fehlschlägt und wie sie ihn beheben kann. Nachdem sie ihn behoben hat, entsperrt sie 1Password erneut. Um festzulegen, welche Checks gelten, bearbeiten Sie die Richtlinie, die mit der 1Password-Anwendung in XFA verknüpft ist.