Pular para o conteúdo principal

1PasswordComo 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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. Clique em Guardar e continuar mais tarde. Isto guarda o passo 1.
  6. 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.

Google

Guia do 1Password: Configure Unlock 1Password with Google. O cliente é do tipo Web application.

  1. Na consola do Google Cloud, abra APIs & Services > Clients e selecione o cliente.
  2. Em Authorized redirect URIs, clique em Add URI, cole o XFA redirect URI e clique em Save.
  3. No OAuth consent screen, abra Branding. Em Authorized domains, adicione xfa.tech ao lado de 1password.com e clique em Save.
  4. 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.

  1. No registo da aplicação para o 1Password, abra Authentication. Na plataforma Web, adicione o XFA redirect URI e clique em Save.
  2. 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.
  3. 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.

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

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

  1. 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.
  2. 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.

  1. Na app OIDC do JumpCloud para o 1Password, no separador SSO, adicione o XFA redirect URI a Redirect URIs e guarde.
  2. 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.

  1. Na aplicação OpenID Connect do seu provider para o 1Password, adicione o XFA redirect URI aos redirect URIs permitidos.
  2. 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.
  3. 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

  1. Inicie sessão na sua conta 1Password em 1Password.com e selecione Policies na barra lateral.
  2. Em Single sign-on, selecione Manage policies.
  3. 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.
  4. 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.
  5. 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.
  6. De volta ao XFA, clique em Marcar como concluído no passo 3 do XFA.
  7. 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.
  8. 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.
  9. 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.
  10. 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.