Sécuriser 1Password avec XFA
Ajoutez une vérification d'appareil à Unlock with SSO de 1Password, pour que seuls les appareils qui respectent votre politique XFA puissent déverrouiller 1Password avec Google ou un autre fournisseur d'identité OpenID Connect.
Comment ça fonctionne
Lorsqu'une personne déverrouille 1Password avec le SSO, 1Password l'envoie vers XFA. XFA compare son appareil à votre politique, puis l'envoie vers votre fournisseur d'identité pour se connecter. Après la connexion, la personne revient vers 1Password, qui se déverrouille. 1Password reçoit de votre fournisseur d'identité le même résultat de connexion que sans XFA. Dans ce résultat, XFA ne lit que l'adresse e-mail de la personne, pour savoir à qui appartient l'appareil vérifié.
Remarque : cet article part du principe que votre organisation dispose d'un compte XFA et que vous en êtes administrateur. Si vous n'avez pas encore de compte, vous pouvez en créer un sur https://dashboard.xfa.tech/signup.
Avant de commencer
- Un compte 1Password Business, avec un rôle de propriétaire ou d'administrateur
- Un accès administrateur à votre fournisseur d'identité
- Un rôle d'administrateur dans XFA
- Approbation des appareils pour l'authentification multifacteur désactivée dans XFA (Exiger l'approbation des appareils pour l'authentification multifacteur, dans Connexions > Paramètres). Si votre organisation l'exige, vous ne pouvez pas encore utiliser XFA avec 1Password : XFA refuse la connexion.
Votre fournisseur d'identité doit :
- inclure l'adresse e-mail de la personne dans l'ID token ;
- prendre en charge PKCE (S256), si vous utilisez un Public Client (sans secret client) ;
- avoir une seule adresse d'émetteur fixe : l'adresse de votre fournisseur d'identité que vous donnez à 1Password comme Issuer, la même pour chaque connexion de votre organisation (pour Microsoft Entra ID, utilisez l'émetteur de votre propre locataire, et non celui en
common).
Google remplit toutes ces conditions. Tout autre fournisseur qui les remplit peut aussi être utilisé.
Les règles de 1Password pour Unlock with SSO s'appliquent :
- Les membres du groupe Owners ne déverrouillent jamais avec le SSO. Ils déverrouillent avec le mot de passe de leur compte et leur Secret Key.
- 1Password n'accepte qu'un seul fournisseur d'identité pour Unlock with SSO.
- 1Password n'enregistre une configuration qu'après un Test Connection réussi.
Où va chaque valeur
- XFA redirect URI : de XFA vers votre fournisseur d'identité
- Authorization Endpoint et Token Endpoint : ceux de XFA, de XFA vers 1Password
- Issuer et User Info Endpoint : ceux de votre fournisseur d'identité, vers 1Password
- Client ID (et le secret client) : de votre fournisseur d'identité vers 1Password
- URL de découverte : de votre fournisseur d'identité vers XFA (l'étape 1 dans XFA, Autre uniquement)
Créer l'application 1Password dans XFA
- Dans le tableau de bord XFA, allez dans Intégrations, cliquez sur Configurer sur la carte 1Password, puis sur Configurer dans la section Contrôles de connexion. XFA ouvre Sécuriser 1Password avec XFA.
- Dans la carte Informations de base, saisissez un Nom. Sous Politique, choisissez la politique XFA avec les vérifications d'appareil que vous voulez au déverrouillage.
- À l'étape 1 dans XFA, Indiquez à XFA votre compte 1Password, saisissez Votre adresse de connexion 1Password : l'adresse à laquelle vous ouvrez 1Password, par exemple
team-acme.1password.com. XFA renseigne les deux redirect URI de 1Password : une pour le navigateur et une pour les applications 1Password. Vous n'avez rien à en faire. La valeur que vous copiez plus tard est la XFA redirect URI, à l'étape 2. - Sous Fournisseur d'identité, choisissez votre fournisseur. Ce choix ne se fait que dans XFA. Dans 1Password, vous choisissez toujours Other, puis Manual.
- Google : XFA renseigne les informations de Google.
- Autre, pour tous les autres fournisseurs : collez l'URL de découverte de votre fournisseur d'identité (elle se termine par /.well-known/openid-configuration) et cliquez sur Remplir.
- Cliquez sur Enregistrer et continuer plus tard. Cela enregistre l'étape 1.
- L'étape 2 dans XFA affiche la XFA redirect URI sous Pour votre fournisseur d'identité. L'étape 3 dans XFA affiche, sous Pour 1Password, le Token Endpoint et l'Authorization Endpoint de XFA.
Configurer votre fournisseur d'identité
Il vous faut un client OAuth (certains fournisseurs parlent d'application ou d'intégration d'application) pour 1Password dans votre fournisseur d'identité. Si votre équipe déverrouille déjà 1Password avec le SSO, vous pouvez garder ce client. Sinon, créez-le avec le guide de 1Password pour votre fournisseur. Lorsque ce guide vous demande de configurer 1Password, suivez plutôt Configurer Unlock with SSO dans 1Password.
Pour chaque fournisseur, la principale modification consiste à ajouter la XFA redirect URI comme redirect URI autorisée supplémentaire. Ne supprimez pas les redirect URI de 1Password qui s'y trouvent déjà. Chaque fournisseur doit aussi inclure l'adresse e-mail de la personne dans l'ID token (Avant de commencer). Une fois terminé, copiez le Client ID, et le secret client s'il y en a un : ils vont dans 1Password, pas dans XFA. Cliquez ensuite sur Marquer comme terminé à l'étape 2 dans XFA.
Guide de 1Password : Configure Unlock 1Password with Google. Le client est de type Web application.
- Dans la console Google Cloud, ouvrez APIs & Services > Clients et sélectionnez le client.
- Sous Authorized redirect URIs, cliquez sur Add URI, collez la XFA redirect URI et cliquez sur Save.
- Dans l'OAuth consent screen, ouvrez Branding. Sous Authorized domains, ajoutez
xfa.techà côté de1password.comet cliquez sur Save. - Copiez le Client ID et le Client secret. Google donne toujours un secret client.
Selon Google, les modifications peuvent prendre de 5 minutes à quelques heures.
Dans 1Password : Issuer https://accounts.google.com, User Info Endpoint https://openidconnect.googleapis.com/v1/userinfo, Client Type Private Client avec le secret client.
Microsoft Entra ID
Guide de 1Password : Configure Unlock 1Password with Microsoft Entra ID.
- Dans l'inscription d'application pour 1Password, ouvrez Authentication. Sous la plateforme Web, ajoutez la XFA redirect URI et cliquez sur Save.
- Sous Token configuration, cliquez sur Add optional claim, choisissez ID et sélectionnez email, pour que l'ID token contienne l'adresse e-mail.
- Copiez l'Application (client) ID et la valeur du secret client.
L'URL de découverte est l'OpenID Connect metadata document sous Overview > Endpoints. Elle contient l'ID de votre locataire : https://login.microsoftonline.com/<your-tenant-id>/v2.0/.well-known/openid-configuration.
Dans 1Password : Issuer https://login.microsoftonline.com/<your-tenant-id>/v2.0, User Info Endpoint https://graph.microsoft.com/oidc/userinfo, Client Type Private Client avec le secret client. Ne choisissez Public Client que si vous avez ajouté la XFA redirect URI sous la plateforme Mobile and desktop applications au lieu de Web.
Okta
Guide de 1Password : Configure Unlock 1Password with Okta.
-
Dans l'application Okta pour 1Password, ajoutez la XFA redirect URI sous Sign-in redirect URIs et cliquez sur Save.
Il se peut que l'application 1Password du catalogue Okta ne vous permette pas d'ajouter une redirect URI. Dans ce cas, créez plutôt votre propre application : Applications > Create App Integration > OIDC - OpenID Connect > Web Application. Ajoutez la XFA redirect URI sous Sign-in redirect URIs.
-
Copiez le Client ID, et le secret client s'il y en a un.
L'URL de découverte est https://<your-okta-domain>/.well-known/openid-configuration.
Dans 1Password : ouvrez l'URL de découverte dans votre navigateur. Issuer est sa valeur issuer et User Info Endpoint sa valeur userinfo_endpoint. Client Type : Private Client avec le secret client d'une Web Application. Ne choisissez Public Client qu'avec une Native Application ou une Single-Page Application qui utilise l'authentification client None et exige PKCE.
Auth0
Guide de 1Password : Configure Unlock 1Password with Auth0.
- Dans l'application Auth0 pour 1Password, ajoutez la XFA redirect URI aux Allowed Callback URLs. Séparez-la des URL déjà présentes par une virgule. Cliquez sur Save Changes.
- Copiez le Client ID, et le Client Secret si l'application en a un.
L'URL de découverte est https://<your-domain>.auth0.com/.well-known/openid-configuration.
Dans 1Password : ouvrez l'URL de découverte dans votre navigateur. Issuer est sa valeur issuer et User Info Endpoint sa valeur userinfo_endpoint. Client Type : Private Client si l'application a un secret client, sinon Public Client.
JumpCloud
Guide de 1Password : Configure Unlock 1Password with JumpCloud.
- Dans l'application OIDC JumpCloud pour 1Password, dans l'onglet SSO, ajoutez la XFA redirect URI aux Redirect URIs et enregistrez.
- Copiez le Client ID, et le secret client si l'application en a un.
L'URL de découverte est https://oauth.id.jumpcloud.com/.well-known/openid-configuration, ou https://oauth.id.eu.jumpcloud.com/.well-known/openid-configuration pour un compte dans l'UE.
Dans 1Password : ouvrez l'URL de découverte dans votre navigateur. Issuer est sa valeur issuer et User Info Endpoint sa valeur userinfo_endpoint. Client Type : Private Client si l'application a un secret client, sinon Public Client.
Autres fournisseurs OpenID Connect
Guide de 1Password : Configure Unlock 1Password with other identity providers. Utilisez cette section pour Duo, OneLogin, Ping Identity et tout autre fournisseur OpenID Connect.
- Dans l'application OpenID Connect de votre fournisseur pour 1Password, ajoutez la XFA redirect URI aux redirect URI autorisées.
- Vérifiez que le fournisseur inclut l'adresse e-mail dans l'ID token. Certains fournisseurs ont besoin pour cela d'un réglage ou d'un mappage de revendication.
- Copiez le Client ID, et le secret client si l'application en a un.
L'URL de découverte figure dans la documentation de votre fournisseur.
Dans 1Password : ouvrez l'URL de découverte dans votre navigateur. Issuer est sa valeur issuer et User Info Endpoint sa valeur userinfo_endpoint. Client Type : Private Client si l'application a un secret client, sinon Public Client.
Configurer Unlock with SSO dans 1Password
- Connectez-vous à votre compte 1Password sur 1Password.com et sélectionnez Policies dans la barre latérale.
- Sous Single sign-on, sélectionnez Manage policies.
- Choisissez Other, même si vous utilisez Google, puis Manual pour saisir vous-même chaque valeur. 1Password doit d'abord parler à XFA. L'option Google de 1Password sauterait XFA.
- Renseignez les champs :
- Client ID : de votre fournisseur d'identité
- Issuer : celui de votre fournisseur d'identité
- Token Endpoint : celui de XFA
- Authorization Endpoint : celui de XFA
- User Info Endpoint : celui de votre fournisseur d'identité
- Client Type : suivez la section de votre fournisseur. 1Password indique Public Client comme recommandé ; ignorez cette indication. Choisissez Private Client si votre fournisseur vous a donné un secret client (Google le fait toujours), et collez-le dans Client secret (value). Choisissez Public Client seulement s'il n'y a pas de secret.
- Sélectionnez Next. 1Password affiche ses redirect URI. Vous n'avez pas besoin de les copier. XFA les a renseignées à partir de votre adresse de connexion.
- De retour dans XFA, cliquez sur Marquer comme terminé à l'étape 3 dans XFA.
- Dans 1Password, sélectionnez Next, puis Test Connection. 1Password ouvre XFA, qui vérifie l'appareil que vous utilisez et vous envoie vers votre fournisseur d'identité pour vous connecter. Si une vérification échoue sur votre appareil, XFA indique ce qu'il faut corriger. Corrigez le problème et relancez Test Connection. Test Connection n'enregistre rien : rien ne change encore pour les autres.
- Une fois le test réussi, sélectionnez Save. L'enregistrement remplace votre configuration SSO actuelle : dès lors, toute personne qui déverrouille 1Password avec le SSO passe par la vérification d'appareil de XFA.
- Choisissez qui déverrouille avec le SSO sous People unlocking 1Password with an identity provider. Commencez par Only groups you select et un petit groupe de test, puis élargissez la sélection une fois que le déverrouillage fonctionne pour ce groupe. Lorsque les utilisateurs passent au SSO, 1Password leur demande une fois le mot de passe de leur compte et leur Secret Key.
- De retour dans XFA, cliquez sur Marquer comme terminé à l'étape 4 dans XFA, Tester la connexion. Cliquez ensuite sur Terminer la configuration.
Ce que voient les utilisateurs
XFA vérifie l'appareil chaque fois que 1Password demande à la personne de se connecter avec le SSO, dans le navigateur et dans les applications 1Password :
- Dans le navigateur, 1Password envoie la personne vers XFA, puis vers le fournisseur d'identité, et la renvoie vers 1Password.
- Dans l'application de bureau 1Password, le navigateur s'ouvre pour la vérification d'appareil et la connexion. Une fois ces étapes terminées, le navigateur propose d'ouvrir 1Password et l'application se déverrouille.
Si l'appareil ne respecte pas la politique, XFA indique quelle vérification échoue et comment la corriger. Si votre politique bloque une vérification qui échoue, le déverrouillage s'arrête. Si elle se contente d'avertir, la personne peut continuer. La politique, sous Politiques dans XFA, indique si une vérification bloque ou avertit.
XFA ne vérifie pas l'appareil quand :
- la personne déverrouille 1Password par biométrie (Touch ID, Windows Hello ou reconnaissance faciale), car cela ne passe pas par le SSO ;
- la personne fait partie du groupe Owners de 1Password ;
- la personne ne fait pas partie d'un groupe qui déverrouille avec le SSO.
Tester la connexion
Tout administrateur peut lancer Test Connection, les propriétaires aussi : il teste la connexion, pas leur propre déverrouillage. Pour tester le déverrouillage lui-même, utilisez un membre qui n'est pas propriétaire : les propriétaires n'utilisent jamais le SSO, donc leur déverrouillage ne passe pas par XFA. Ajoutez ce membre au groupe de test. Verrouillez 1Password et déverrouillez-le avec le SSO dans le navigateur et dans l'application de bureau. Ce membre devrait passer par la vérification d'appareil de XFA et par votre fournisseur d'identité avant que 1Password se déverrouille.
Dépannage
Le fournisseur d'identité refuse la redirect URI
Google affiche redirect_uri_mismatch lorsque la XFA redirect URI ne figure pas dans les Authorized redirect URIs du client ; les autres fournisseurs affichent une erreur similaire. Copiez-la à nouveau depuis XFA avec le bouton Copier, pour qu'elle corresponde exactement. Elle ressemble à https://device-api.xfa.tech/<application-id>/oauth2/redirect.
Si XFA refuse la redirection, l'adresse de connexion 1Password saisie dans XFA ne correspond pas à votre compte 1Password. Corrigez-la à l'étape 1 dans XFA. Utilisez l'adresse qui figure dans la barre d'adresse de votre navigateur quand vous utilisez 1Password.
Le Test Connection échoue
- L'Authorization Endpoint et le Token Endpoint dans 1Password sont ceux de XFA. L'Issuer et le User Info Endpoint sont ceux de votre fournisseur d'identité.
- Le Client ID, le Client Type et le secret client dans 1Password correspondent au client de votre fournisseur d'identité. Sinon, votre fournisseur affiche
invalid_client. - L'appareil depuis lequel vous testez respecte la politique XFA que vous avez choisie.
- Votre adresse e-mail chez le fournisseur d'identité est la même que votre adresse e-mail dans 1Password.
Le Test Connection échoue avec invalid_scope
XFA arrête la connexion avec invalid_scope lorsque l'ID token de votre fournisseur d'identité ne contient pas d'adresse e-mail. Configurez votre fournisseur pour qu'il inclue l'adresse e-mail dans l'ID token : pour Microsoft Entra ID, ajoutez la revendication facultative email (voir Microsoft Entra ID).
L'appareil ne respecte pas la politique
XFA indique à la personne quelle vérification échoue et comment la corriger. Une fois le problème corrigé, elle déverrouille à nouveau 1Password. Pour changer les vérifications qui s'appliquent, modifiez la politique liée à l'application 1Password dans XFA.