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.)
- Na Okta Admin Console, vá a Applications → Create App Integration → OIDC → Web Application.
- Defina o Sign-in redirect URI com o URL de callback.
- Em Assignments, dê acesso aos utilizadores ou grupos que devem chegar ao Identiguard.
- 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.
Microsoft Entra ID
Seção intitulada “Microsoft Entra ID”- No centro de administração do Entra, vá a App registrations → New registration.
- Defina o Redirect URI (Web) com o URL de callback.
- Em Certificates & secrets, crie um client secret.
- Copie o application (client) ID e o valor do secret.
O issuer é https://login.microsoftonline.com/<your-tenant-id>/v2.0.
2. Criar a ligação no Identiguard
Seção intitulada “2. Criar a ligação no Identiguard”| 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.)
3. Verificar o domínio
Seção intitulada “3. Verificar o domínio”A página mostra agora o painel Verify domain ownership (verificar a propriedade do domínio).
- Copie Name. É
_idnguard-verify.seguido do seu domínio, por exemplo_idnguard-verify.client.com. - Copie Value. É um token que o Identiguard gerou para esta ligação.
- No fornecedor de DNS do domínio, crie um registo TXT com esse nome e esse valor.
- 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.
O que acontece quando fica ativo
Seção intitulada “O que acontece quando fica ativo”- 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.
A função que as novas pessoas recebem
Seção intitulada “A função que as novas pessoas recebem”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
Seção intitulada “Restrict membership to SSO”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.
Remover a ligação
Seção intitulada “Remover a ligação”- Escolha Remove connection.
- 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.
Resolução de problemas
Seção intitulada “Resolução de problemas”Criar a ligação
Seção intitulada “Criar a ligaçã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. |
Verificar o domínio
Seção intitulada “Verificar o domínio”| 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. |
Outras mensagens
Seção intitulada “Outras mensagens”| 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.