Pular para o conteúdo

Configurar o single sign-on

Este guia configura o single sign-on (SSO) para um workspace do princípio ao fim. As definições estão descritas em Single sign-on.

  • A função de admin no workspace. Qualquer plano.
  • Um administrador da organização Okta ou do diretório Entra ID do cliente.
  • Alguém que possa adicionar um registo TXT ao DNS do domínio de email do cliente.
  • O domínio de email do próprio cliente. Os domínios públicos, como gmail.com, são recusados.

1. Escolher o fornecedor e copiar o URL de callback

Seção intitulada “1. Escolher o fornecedor e copiar o URL de callback”
  1. Abra Single sign-on em Workspace.
  2. Escolha Okta ou Microsoft Entra ID.
  3. Copie Callback / redirect URI (configure in your IdP) com o botão de copiar.

2. Criar a aplicação no fornecedor de identidade

Seção intitulada “2. Criar a aplicação no fornecedor de identidade”

Siga os passos numerados que a página mostra para o fornecedor que escolheu.

  • Okta: crie uma aplicação web OIDC, defina o sign-in redirect URI como o URL de callback, atribua os utilizadores ou os grupos, e copie o client ID e o client secret.
  • Microsoft Entra ID: crie um registo de aplicação, defina o redirect URI web como o URL de callback, crie um client secret, e copie o application (client) ID e o valor do segredo.
  1. Introduza o Issuer URL.
    • Okta: o URL da organização, por exemplo https://your-org.okta.com, ou o URL de um servidor de autorização personalizado.
    • Entra ID: https://login.microsoftonline.com/<tenant-id>/v2.0.
  2. Introduza o Client ID e o Client secret.
  3. Introduza o Email domain como um domínio simples, por exemplo client.com.
  4. Escolha Create connection.

Vê SSO connection created. Now verify your domain. (Ligação SSO criada. Verifique agora o seu domínio.) O distintivo indica Awaiting domain verification (a aguardar a verificação do domínio).

  1. Em Verify domain ownership, copie Name. É _idnguard-verify. seguido do domínio.
  2. Copie Value.
  3. No alojamento de DNS, crie um registo TXT com esse nome e esse valor.
  4. Escolha Verify domain.

Vê Domain verified. SSO is live. (Domínio verificado. O SSO está ativo.) e o distintivo muda para Live.

Se aparecer uma mensagem TXT record not found (registo TXT não encontrado), aguarde alguns minutos e escolha de novo Verify domain. As alterações de DNS demoram algum tempo.

  1. Termine a sessão ou abra uma janela privada do browser.
  2. Na página de início de sessão, escolha Continue with single sign-on.
  3. Introduza um endereço de email profissional do domínio e escolha Continue.
  4. Inicie sessão no fornecedor de identidade. Abre-se o dashboard do workspace.

Teste com uma segunda pessoa antes de informar toda a equipa.

As pessoas que aderem através de single sign-on chegam como membros.

  1. Abra Members.
  2. Escolha a função certa no campo Role da linha de cada pessoa.

Na página Single sign-on, escolha o botão ao lado de Restrict membership to SSO (restringir a adesão ao SSO) para que indique On. Vê Membership is now restricted to SSO. Email invitations are blocked. (A adesão está agora restringida ao SSO. Os convites por email estão bloqueados.)

A partir de agora, só o fornecedor de identidade decide quem pode aderir.

Com Restrict membership to SSO ligado, não pode convidar um endereço exterior ao domínio. Para convidar uma pessoa externa:

  1. Abra Single sign-on. Ao lado de Restrict membership to SSO, escolha On para que indique Off.
  2. Abra Members, introduza o endereço e a função da pessoa externa e escolha Send Invite.
  3. Depois de a pessoa externa ter aderido, reponha Restrict membership to SSO em On.
  1. Abra Single sign-on e escolha Remove connection.
  2. Confirme a pergunta do browser.

As pessoas mantêm as suas contas e as suas adesões. Cada pessoa do domínio configura então uma passkey a partir de Create account / set up a passkey, na página de início de sessão.

O que vê O que fazer
Bad Request: issuer does not look like a valid … issuer (Pedido inválido: o issuer não parece ser um issuer válido) Utilize o formato de issuer indicado no passo 3 para o seu fornecedor.
Bad Request: Enter a bare domain like client.com (no scheme or path). (Pedido inválido: introduza um domínio simples, como client.com, sem esquema nem caminho.) Remova https:// e tudo o que estiver depois do domínio.
Bad Request: Public email provider domains cannot be used for SSO routing. (Pedido inválido: os domínios de fornecedores de email públicos não podem ser utilizados para o encaminhamento de SSO.) Utilize o domínio da própria organização.
The domain … is already verified by another workspace. (O domínio … já está verificado por outro workspace.) Outro workspace reclamou o domínio. Esse workspace remove a sua ligação, ou contacte o suporte.
Could not read the identity provider’s OpenID configuration (Não foi possível ler a configuração OpenID do fornecedor de identidade) Verifique se há erros de escrita no Issuer URL.
TXT record not found … Verifique o nome e o valor do registo no alojamento de DNS. Aguarde alguns minutos. Tente de novo.
No single sign-on for this domain. (Não há single sign-on para este domínio.) ao iniciar sessão O domínio ainda não está verificado. Conclua o passo 4.
Verify the domain first. SSO-only membership requires a live connection. (Verifique primeiro o domínio. A adesão apenas por SSO exige uma ligação ativa.) Verifique o domínio antes de restringir a adesão.
Uma pessoa inicia sessão mas recebe You do not have access to this workspace. (Não tem acesso a este workspace.) Verifique se a pessoa está atribuída à aplicação no fornecedor de identidade.

Todas as mensagens estão explicadas em Single sign-on e em Iniciar sessão.