Pular para o conteúdo

Single sign-on

Um admin do workspace pode ligar o fornecedor de identidade do próprio cliente, para que os seus colaboradores iniciem sessão no Identiguard da mesma forma que iniciam sessão em tudo o resto. São suportados o Okta e o Microsoft Entra ID, através de OpenID Connect.

Abra Single sign-on em Workspace. Só os admins o veem na barra lateral. O single sign-on (SSO) está disponível em todos os planos.

Para a tarefa do início ao fim, consulte Configurar o single sign-on.

Regra Detalhe
Ligações por workspace Uma
Domínios de email por ligação Um
O mesmo domínio em dois workspaces Não é possível. Um domínio só pode ser verificado por um workspace.
Domínios de email públicos, como gmail.com e outlook.com Recusados
Quando começa a funcionar Só depois de o domínio ser verificado com um registo DNS

1. Criar uma aplicação no fornecedor de identidade

Seção intitulada “1. Criar uma aplicação no fornecedor de identidade”

Na página Single sign-on, escolha Okta ou Microsoft Entra ID. A página mostra então os passos de configuração numerados para esse fornecedor e o Callback / redirect URI (configure in your IdP). Use o botão de copiar ao lado. Vê Callback URL copied. (URL de callback copiado.)

  1. Na Okta Admin Console, vá a Applications → Create App Integration → OIDC → Web Application.
  2. Defina o Sign-in redirect URI com o URL de callback.
  3. Em Assignments, dê acesso aos utilizadores ou grupos que devem chegar ao Identiguard.
  4. Copie o client ID e o client secret.

O issuer é o URL da org Okta, por exemplo https://your-org.okta.com, ou o URL de um servidor de autorização personalizado.

  1. No centro de administração do Entra, vá a App registrations → New registration.
  2. Defina o Redirect URI (Web) com o URL de callback.
  3. Em Certificates & secrets, crie um client secret.
  4. Copie o application (client) ID e o valor do secret.

O issuer é https://login.microsoftonline.com/<your-tenant-id>/v2.0.

Campo O que introduzir
Issuer URL O issuer do fornecedor, como descrito acima
Client ID O client ID da aplicação
Client secret O client secret da aplicação
Email domain Apenas o domínio, como client.com. Sem https:// e sem caminho.

O texto de ajuda por baixo de Email domain diz: “People signing in with this email domain are routed to your IdP (after DNS verification).” (As pessoas que iniciam sessão com este domínio de email são encaminhadas para o seu IdP, depois da verificação por DNS.)

Escolha Create connection. Vê SSO connection created. Now verify your domain. (Ligação de SSO criada. Verifique agora o seu domínio.)

A página mostra agora o painel Verify domain ownership (verificar a propriedade do domínio).

  1. Copie Name. É _idnguard-verify. seguido do seu domínio, por exemplo _idnguard-verify.client.com.
  2. Copie Value. É um token que o Identiguard gerou para esta ligação.
  3. No fornecedor de DNS do domínio, crie um registo TXT com esse nome e esse valor.
  4. Escolha Verify domain.
Etiqueta Significado
Awaiting domain verification A ligação existe, mas ainda não é usada para iniciar sessão
Live O registo foi encontrado. O single sign-on está a funcionar.

Quando funciona, vê Domain verified. SSO is live. (Domínio verificado. O SSO está ativo.) Se o registo ainda não estiver visível, o painel mostra uma mensagem TXT record not found (registo TXT não encontrado). As alterações de DNS podem demorar alguns minutos. Aguarde e escolha Verify domain de novo.

  • Qualquer pessoa que inicie sessão com um endereço de email desse domínio é enviada para o fornecedor de identidade.
  • Entra automaticamente no workspace na primeira vez que inicia sessão.
  • O início de sessão com passkey é recusado para as contas desse domínio. Essas pessoas veem “Passkey sign-in is disabled for this account. Use your organisation’s single sign-on.” (O início de sessão com passkey está desativado para esta conta. Use o single sign-on da sua organização.)
  • Uma ligação de convite para um endereço desse domínio mostra Continue with single sign-on em vez do botão de configuração por email.

Uma pessoa que entra por single sign-on é membro por omissão. Se existir um convite pendente para o seu endereço, recebe a função do convite. Para uma pessoa que já é membro, mantém-se a mais elevada das duas funções.

Altere depois a função na página Members. Consulte Membros e funções.

Restrict membership to SSO (restringir a adesão ao SSO) aparece quando a ligação está Live. É um botão que mostra Off ou On. Escolha-o para mudar o estado.

Estado Efeito Mensagem
On Os convites por email são bloqueados. Os novos membros só podem entrar através do fornecedor de identidade. Membership is now restricted to SSO. Email invitations are blocked. (A adesão está agora restrita ao SSO. Os convites por email estão bloqueados.)
Off Os convites por email funcionam a par do single sign-on. Email invitations re-enabled alongside SSO. (Convites por email reativados a par do SSO.)

Desative-o por pouco tempo para convidar alguém de fora do domínio e depois ative-o de novo. Os passos estão em Configurar o single sign-on.

  1. Escolha Remove connection.
  2. O browser pergunta: “Remove this SSO connection? Users keep their accounts and memberships.” (Remover esta ligação de SSO? Os utilizadores mantêm as suas contas e adesões.) Confirme.

Vê SSO connection removed. (Ligação de SSO removida.)

As pessoas mantêm as suas contas e as suas adesões a workspaces. As pessoas desse domínio passam a precisar de uma passkey para iniciar sessão. Cada uma pede uma ligação de configuração em Create account / set up a passkey, na página de início de sessão.

O que vê Porquê O que fazer
Bad Request: issuer does not look like a valid Okta issuer ou …Microsoft Entra ID issuer (o issuer não parece ser um issuer válido do Okta ou do Microsoft Entra ID), com um exemplo O Issuer URL está errado para o fornecedor escolhido. Okta: use o URL da org ou o URL de um servidor de autorização personalizado. Entra ID: use https://login.microsoftonline.com/<tenant-id>/v2.0.
Bad Request: clientId and clientSecret are required. (clientId e clientSecret são obrigatórios.) Client ID ou Client secret está vazio. Preencha os dois.
Bad Request: Enter a bare domain like client.com (no scheme or path). (Introduza apenas o domínio, como client.com, sem esquema nem caminho.) Email domain tem https:// ou um caminho. Introduza apenas o domínio.
Bad Request: Public email provider domains cannot be used for SSO routing. (Os domínios de fornecedores de email públicos não podem ser usados para encaminhamento por SSO.) O domínio é de um fornecedor de email público. Use o domínio próprio da organização.
This workspace already has an SSO connection. Remove it first. (Este workspace já tem uma ligação de SSO. Remova-a primeiro.) Um workspace pode ter uma ligação. Remova a existente e depois crie a nova.
The domain … is already verified by another connection. ou …by another workspace. (O domínio já está verificado por outra ligação, ou por outro workspace.) Outro workspace reclamou o domínio. O outro 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) com um motivo O Identiguard não conseguiu contactar o documento de descoberta do fornecedor, ou não pôde confiar nele. Verifique o Issuer URL e se o fornecedor de identidade está acessível.
Could not register the identity provider. (Não foi possível registar o fornecedor de identidade.) com ou sem um motivo O registo falhou. Verifique o client ID e o secret e depois tente novamente.
Failed to save SSO connection (Não foi possível guardar a ligação de SSO) O servidor não devolveu uma mensagem utilizável. Tente novamente. Se continuar, indique ao suporte a hora e a página.
O que vê Porquê O que fazer
TXT record not found on _idnguard-verify. e o seu domínio, e depois DNS changes can take a few minutes to propagate. (As alterações de DNS podem demorar alguns minutos a propagar-se.) O registo está em falta, tem o nome ou o valor errado, ou ainda não está visível. Verifique o registo no fornecedor de DNS. Aguarde alguns minutos. Escolha Verify domain de novo.
Domain already verified. (Domínio já verificado.) Escolheu Verify domain numa ligação ativa. Nada a fazer.
This connection’s identity provider no longer matches the domain that was verified. Remove the connection and set it up again. (O fornecedor de identidade desta ligação já não corresponde ao domínio que foi verificado. Remova a ligação e configure-a de novo.) O fornecedor e o domínio verificado já não correspondem. Remova a ligação e crie-a de novo.
Verification failed (A verificação falhou) O servidor não devolveu uma mensagem utilizável. Tente novamente dentro de alguns minutos.
O que vê Porquê O que fazer
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.) Restrict membership to SSO foi alterado antes de o domínio ser verificado. Verifique primeiro o domínio.
No SSO connection configured for this workspace. (Não há nenhuma ligação de SSO configurada para este workspace.) A ligação foi removida noutro separador ou por outro admin. Recarregue a página.
Copy failed. Select and copy manually. (A cópia falhou. Selecione e copie manualmente.) O browser bloqueou a área de transferência. Selecione o texto e copie-o à mão.
Failed to load SSO status (Não foi possível carregar o estado do SSO) A página não conseguiu carregar a ligação. Recarregue a página.
Forbidden: only workspace admins can manage single sign-on. (Proibido: apenas os admins do workspace podem gerir o single sign-on.) Não é admin do workspace. Peça a um admin.

As mensagens que as pessoas veem quando iniciam sessão estão em Iniciar sessão.