Como proteger o 1Password com o XFA
Acrescente uma verificação do dispositivo ao Unlock with SSO do 1Password, para que só os dispositivos que cumprem a sua política XFA possam desbloquear o 1Password com o Google ou outro identity provider OpenID Connect.
Como funciona
Quando alguém desbloqueia o 1Password com single sign-on, o 1Password envia essa pessoa para o XFA. O XFA verifica o dispositivo face à sua política e depois envia a pessoa para o seu identity provider para iniciar sessão. Após o início de sessão, a pessoa volta ao 1Password, que se desbloqueia. O 1Password recebe do seu identity provider o mesmo resultado de início de sessão que receberia sem o XFA. Desse resultado, o XFA lê apenas o endereço de e-mail da pessoa, para saber de quem é o dispositivo que verificou.
Nota: este artigo parte do princípio de que a sua organização tem uma conta XFA e de que é administrador dessa organização. Se não tiver conta, pode criar uma em https://dashboard.xfa.tech/signup.
Antes de começar
- Uma conta 1Password Business, com uma função de proprietário ou administrador
- Acesso de administrador ao seu identity provider
- Uma função de administrador no XFA
- Aprovação do dispositivo para a autenticação multifator desativada no XFA (Exigir aprovação do dispositivo para a autenticação multifator, em Ligações > Definições). Se a sua organização a exige, ainda não pode usar o XFA com o 1Password: o XFA recusa o início de sessão.
O seu identity provider tem de:
- incluir o endereço de e-mail da pessoa no ID token;
- suportar PKCE (S256), se usar um Public Client (um sem segredo do cliente);
- ter um único endereço de issuer fixo: o endereço do seu identity provider que indica ao 1Password como Issuer, o mesmo para todos os inícios de sessão na sua organização (no Microsoft Entra ID, use o issuer do seu próprio tenant, não o
common).
O Google cumpre todos estes requisitos. Qualquer outro provider que os cumpra também pode ser usado.
Aplicam-se as regras do próprio 1Password para o Unlock with SSO:
- Os membros do grupo Owners nunca desbloqueiam com SSO. Desbloqueiam com a palavra-passe da conta e a Secret Key.
- O 1Password aceita apenas um identity provider para o Unlock with SSO.
- O 1Password só guarda uma configuração depois de um Test Connection bem-sucedido.
Para onde vai cada valor
- XFA redirect URI: do XFA para o seu identity provider
- Authorization Endpoint e Token Endpoint: os do XFA, do XFA para o 1Password
- Issuer e User Info Endpoint: os do seu identity provider, para o 1Password
- Client ID (e o segredo do cliente): do seu identity provider para o 1Password
- URL de descoberta: do seu identity provider para o XFA (passo 1 do XFA, apenas Outro)
Criar a aplicação 1Password no XFA
- No painel XFA, vá a Integrações, clique em Configurar no cartão 1Password e depois em Configurar na secção Controlos de início de sessão. O XFA abre Proteja o 1Password com o XFA.
- No cartão Informações básicas, introduza um Nome. Em Política, escolha a política XFA com as verificações do dispositivo que pretende no desbloqueio.
- No passo 1 do XFA, Indique ao XFA a sua conta do 1Password, preencha O seu endereço de início de sessão do 1Password: o endereço em que abre o 1Password, por exemplo
team-acme.1password.com. O XFA preenche os dois redirect URIs do próprio 1Password, um para o navegador e outro para as aplicações 1Password. Não tem de fazer nada com eles. O valor que copia mais tarde é o XFA redirect URI, do passo 2. - Em Fornecedor de identidade, escolha o seu provider. Esta escolha existe apenas no XFA. No 1Password, escolhe sempre Other e depois Manual.
- Google: o XFA preenche os dados do Google.
- Outro, para todos os outros providers: cole o URL em URL de descoberta do seu fornecedor de identidade (termina em /.well-known/openid-configuration) e clique em Preencher.
- Clique em Guardar e continuar mais tarde. Isto guarda o passo 1.
- O passo 2 do XFA mostra o XFA redirect URI em Para o seu fornecedor de identidade. O passo 3 do XFA mostra, em Para o 1Password, o Token Endpoint e o Authorization Endpoint do XFA.
Configurar o seu identity provider
Precisa de um cliente OAuth (alguns providers chamam-lhe aplicação ou app integration) para o 1Password no seu identity provider. Se a sua equipa já desbloqueia o 1Password com SSO, pode continuar a usar esse cliente. Caso contrário, crie-o com o guia do 1Password para o seu provider. Na parte em que esse guia configura o 1Password, siga antes Configurar o Unlock with SSO no 1Password.
Para todos os providers, a principal alteração é o XFA redirect URI, como redirect URI permitido adicional. Não remova os redirect URIs do 1Password que já lá estão. Todos os providers têm também de incluir o endereço de e-mail da pessoa no ID token (Antes de começar). Quando terminar, copie o Client ID e, se houver, o segredo do cliente: vão para o 1Password, não para o XFA. Depois clique em Marcar como concluído no passo 2 do XFA.
Guia do 1Password: Configure Unlock 1Password with Google. O cliente é do tipo Web application.
- Na consola do Google Cloud, abra APIs & Services > Clients e selecione o cliente.
- Em Authorized redirect URIs, clique em Add URI, cole o XFA redirect URI e clique em Save.
- No OAuth consent screen, abra Branding. Em Authorized domains, adicione
xfa.techao lado de1password.come clique em Save. - Copie o Client ID e o Client secret. O Google dá sempre um segredo do cliente.
O Google indica que as alterações podem demorar entre 5 minutos e algumas horas.
No 1Password: Issuer https://accounts.google.com, User Info Endpoint https://openidconnect.googleapis.com/v1/userinfo, Client Type Private Client com o segredo do cliente.
Microsoft Entra ID
Guia do 1Password: Configure Unlock 1Password with Microsoft Entra ID.
- No registo da aplicação para o 1Password, abra Authentication. Na plataforma Web, adicione o XFA redirect URI e clique em Save.
- Em Token configuration, clique em Add optional claim, escolha ID e selecione email, para que o ID token inclua o endereço de e-mail.
- Copie o Application (client) ID e o valor do segredo do cliente.
O URL de descoberta é o OpenID Connect metadata document, em Overview > Endpoints. Contém o ID do seu tenant: https://login.microsoftonline.com/<your-tenant-id>/v2.0/.well-known/openid-configuration.
No 1Password: Issuer https://login.microsoftonline.com/<your-tenant-id>/v2.0, User Info Endpoint https://graph.microsoft.com/oidc/userinfo, Client Type Private Client com o segredo do cliente. Escolha Public Client apenas se adicionou o XFA redirect URI na plataforma Mobile and desktop applications em vez de Web.
Okta
Guia do 1Password: Configure Unlock 1Password with Okta.
-
Na app Okta para o 1Password, adicione o XFA redirect URI em Sign-in redirect URIs e clique em Save.
A app 1Password do catálogo da Okta pode não permitir adicionar um redirect URI. Nesse caso, crie antes a sua própria app: Applications > Create App Integration > OIDC - OpenID Connect > Web Application. Adicione o XFA redirect URI em Sign-in redirect URIs.
-
Copie o Client ID e, se houver, o segredo do cliente.
O URL de descoberta é https://<your-okta-domain>/.well-known/openid-configuration.
No 1Password: abra o URL de descoberta no navegador. O Issuer é o valor issuer desse URL e o User Info Endpoint é o valor userinfo_endpoint. Client Type: Private Client com o segredo do cliente de uma Web Application. Escolha Public Client apenas com uma Native Application ou Single-Page Application que use a autenticação de cliente None e exija PKCE.
Auth0
Guia do 1Password: Configure Unlock 1Password with Auth0.
- Na aplicação Auth0 para o 1Password, adicione o XFA redirect URI a Allowed Callback URLs. Separe-o dos URLs que já lá estão com uma vírgula. Clique em Save Changes.
- Copie o Client ID e o Client Secret, se a aplicação tiver um.
O URL de descoberta é https://<your-domain>.auth0.com/.well-known/openid-configuration.
No 1Password: abra o URL de descoberta no navegador. O Issuer é o valor issuer desse URL e o User Info Endpoint é o valor userinfo_endpoint. Client Type: Private Client se a aplicação tiver um segredo do cliente; caso contrário, Public Client.
JumpCloud
Guia do 1Password: Configure Unlock 1Password with JumpCloud.
- Na app OIDC do JumpCloud para o 1Password, no separador SSO, adicione o XFA redirect URI a Redirect URIs e guarde.
- Copie o Client ID e o segredo do cliente, se a app tiver um.
O URL de descoberta é https://oauth.id.jumpcloud.com/.well-known/openid-configuration ou, para uma conta na UE, https://oauth.id.eu.jumpcloud.com/.well-known/openid-configuration.
No 1Password: abra o URL de descoberta no navegador. O Issuer é o valor issuer desse URL e o User Info Endpoint é o valor userinfo_endpoint. Client Type: Private Client se a app tiver um segredo do cliente; caso contrário, Public Client.
Outros providers OpenID Connect
Guia do 1Password: Configure Unlock 1Password with other identity providers. Use esta secção para o Duo, o OneLogin, o Ping Identity e qualquer outro provider OpenID Connect.
- Na aplicação OpenID Connect do seu provider para o 1Password, adicione o XFA redirect URI aos redirect URIs permitidos.
- Confirme que o provider inclui o endereço de e-mail no ID token. Alguns providers precisam de uma definição ou de um mapeamento de claims para isso.
- Copie o Client ID e o segredo do cliente, se a aplicação tiver um.
O URL de descoberta está na documentação do seu provider.
No 1Password: abra o URL de descoberta no navegador. O Issuer é o valor issuer desse URL e o User Info Endpoint é o valor userinfo_endpoint. Client Type: Private Client se a aplicação tiver um segredo do cliente; caso contrário, Public Client.
Configurar o Unlock with SSO no 1Password
- Inicie sessão na sua conta 1Password em 1Password.com e selecione Policies na barra lateral.
- Em Single sign-on, selecione Manage policies.
- Escolha Other, mesmo que use o Google, e depois Manual para introduzir cada valor por si. O 1Password tem de falar primeiro com o XFA. A opção Google do 1Password saltaria o XFA.
- Preencha os campos:
- Client ID: do seu identity provider
- Issuer: o do seu identity provider
- Token Endpoint: o do XFA
- Authorization Endpoint: o do XFA
- User Info Endpoint: o do seu identity provider
- Client Type: siga a secção do seu provider. O 1Password marca Public Client como recomendado; ignore essa marca. Escolha Private Client se o seu provider lhe deu um segredo do cliente (o Google dá sempre) e cole-o em Client secret (value). Escolha Public Client só se não houver segredo.
- Selecione Next. O 1Password mostra os seus redirect URIs. Não precisa de os copiar. O XFA preencheu-os a partir do seu endereço de início de sessão.
- De volta ao XFA, clique em Marcar como concluído no passo 3 do XFA.
- No 1Password, selecione Next e depois Test Connection. O 1Password abre o XFA, que verifica o dispositivo que está a utilizar e depois o envia para o seu identity provider para iniciar sessão. Se o dispositivo falhar uma verificação, o XFA mostra o que tem de corrigir. Corrija o problema e execute Test Connection novamente. O Test Connection não guarda nada, por isso nada muda ainda para as outras pessoas.
- Quando o teste for bem-sucedido, selecione Save. Guardar substitui a sua configuração de SSO atual: a partir daí, todas as pessoas que desbloqueiam o 1Password com SSO passam pela verificação do dispositivo do XFA.
- Escolha quem desbloqueia com SSO em People unlocking 1Password with an identity provider. Comece com Only groups you select e um pequeno grupo de teste, e alargue-o quando o desbloqueio funcionar para essas pessoas. Quando as pessoas passam a usar o SSO, o 1Password pede-lhes uma vez a palavra-passe da conta e a Secret Key.
- De volta ao XFA, clique em Marcar como concluído no passo 4 do XFA, Teste a ligação. Depois clique em Concluir a configuração.
O que as pessoas veem
O XFA verifica o dispositivo sempre que o 1Password pede à pessoa que inicie sessão com SSO, no navegador e nas aplicações 1Password:
- No navegador, o 1Password envia a pessoa para o XFA, depois para o identity provider e de volta para o 1Password.
- Na aplicação de secretária do 1Password, o navegador abre-se para a verificação do dispositivo e o início de sessão. Quando o processo termina, o navegador pede para abrir o 1Password e a aplicação desbloqueia-se.
Se o dispositivo não cumprir a política, o XFA mostra qual é a verificação que falha e como resolver o problema. Se a sua política bloquear uma verificação que falha, o desbloqueio é interrompido. Se apenas avisar, a pessoa pode continuar. Consulte a política em Políticas no XFA para ver se uma verificação bloqueia ou avisa.
O XFA não verifica o dispositivo quando:
- a pessoa desbloqueia com biometria (Touch ID, Windows Hello, desbloqueio facial), porque isso não passa pelo SSO;
- a pessoa pertence ao grupo Owners do 1Password;
- a pessoa não está num grupo que desbloqueia com SSO.
Testar a ligação
Qualquer administrador pode executar o Test Connection, incluindo os proprietários: testa a ligação, não o próprio desbloqueio deles. Para testar o desbloqueio em si, use um membro que não seja proprietário: os proprietários nunca usam SSO, por isso o desbloqueio deles não passa pelo XFA. Adicione esse membro ao grupo de teste. Bloqueie o 1Password e desbloqueie-o com SSO no navegador e na aplicação de secretária. Esse membro deverá passar pela verificação do dispositivo do XFA e pelo seu identity provider antes de o 1Password se desbloquear.
Resolução de problemas
O identity provider rejeita o redirect URI
O Google mostra redirect_uri_mismatch quando o XFA redirect URI não está nos Authorized redirect URIs do cliente; outros providers mostram um erro semelhante. Copie-o novamente do XFA com o botão Copiar, para que corresponda exatamente. Tem o formato https://device-api.xfa.tech/<application-id>/oauth2/redirect.
Se o XFA rejeitar o redirecionamento, o endereço de início de sessão do 1Password no XFA não corresponde à sua conta 1Password. Corrija-o no passo 1 do XFA. Use o endereço que aparece na barra de endereço do navegador quando usa o 1Password.
O Test Connection falha
- No 1Password, o Authorization Endpoint e o Token Endpoint são os do XFA. O Issuer e o User Info Endpoint são os do seu identity provider.
- O Client ID, o Client Type e o segredo do cliente no 1Password correspondem ao cliente no seu identity provider. Se não corresponderem, o seu provider mostra
invalid_client. - O dispositivo a partir do qual testa cumpre a política XFA que escolheu.
- O seu endereço de e-mail no identity provider é igual ao seu endereço de e-mail no 1Password.
O Test Connection falha com invalid_scope
O XFA interrompe o início de sessão com invalid_scope quando o ID token do seu identity provider não tem endereço de e-mail. Configure o seu provider para incluir o endereço de e-mail no ID token: no Microsoft Entra ID, adicione a claim opcional email (consulte Microsoft Entra ID).
O dispositivo não cumpre a política
O XFA mostra à pessoa qual é a verificação que falha e como resolver o problema. Depois de o resolver, a pessoa desbloqueia novamente o 1Password. Para alterar as verificações que se aplicam, edite a política ligada à aplicação 1Password no XFA.