Saltar para o conteúdo principal
As organizações do Didit Authentication permitem que uma aplicação B2B agrupe os seus utilizadores pela empresa onde trabalham. Cada organização tem os seus próprios membros e funções, pode verificar os seus domínios de e-mail para que os colegas se juntem automaticamente, e pode autenticar os seus utilizadores através de um fornecedor de identidade SAML ou OIDC próprio. A sua aplicação lê as organizações e as funções da pessoa a partir do token e da sessão, e decide o que cada função pode fazer.
Uma organização, neste contexto, é um dos seus clientes, dentro da sua aplicação. É separada da sua organização Didit, que reúne a sua própria equipa na Business Console.

Ativar organizações

As organizações estão desativadas numa nova aplicação. Abra Authentication > Organizations na consola e, no cartão Settings:
  • Ative Organizations.
  • Escolha o Default role for new members, a função que as pessoas recebem ao aderir através de um domínio verificado ou de início de sessão único (member por predefinição).
  • Mantenha Require MFA for organization admins ativo, a política de MFA predefinida (ver abaixo).
Depois, gere as organizações na consola: New organization cria uma organização com o nome e um slug, único na aplicação. As suas organizações são criadas pela sua equipa; as pessoas ainda não podem criar as próprias organizações a partir da sua aplicação. A lista mostra os membros, os domínios verificados, o estado do início de sessão único, a regra de MFA e a data de criação de cada organização, e as métricas principais acima dela contam as organizações, os membros, as ligações SSO e os domínios verificados.
A página Organizations na Didit Business Console, com as métricas principais e uma lista de organizações com os respetivos membros, domínios verificados e estado de single sign-on

Authentication > Organizations.

Membros e funções

Uma pessoa pode pertencer a várias organizações da sua aplicação, com uma função em cada uma. Nos planos Scale e Enterprise, e em todas as aplicações Sandbox, pode também definir funções personalizadas, cada uma com uma chave e as permissões que a sua aplicação verifica, por exemplo payouts.approve. Um membro pode ter uma função personalizada além da sua função. Abra uma organização para ver a respetiva autenticação única, os domínios verificados, os membros, as funções e os convites.
Uma organização aberta na Didit Business Console, mostrando a sua autenticação única SAML com uma ligação de configuração, um domínio verificado com adesão automática e os seus membros e funções

Autenticação única, domínios verificados, membros e funções de uma organização.

Convites

Escolha Invite member numa organização, introduza até 20 endereços de e-mail e a função que cada pessoa recebe (admin, member ou billing), e a Didit envia a cada pessoa um convite por e-mail. Um convite é válido durante 7 dias e abre a página alojada /invite na sua origem de início de sessão, onde a pessoa inicia sessão ou cria uma conta e se junta à organização. A lista Invitations da organização mostra quando expira cada convite, com Resend e Revoke.

Domínios verificados e auto-join

Uma organização pode provar que é proprietária de um domínio de e-mail:
  1. Adicione o domínio à organização.
  2. Adicione o registo TXT que a Didit apresenta em _didit-auth.<domain> no seu fornecedor de DNS, contendo o token de verificação.
  3. Verifique o domínio. Ele aparece como Verified assim que o registo for encontrado.
Com o Auto-join ativado para um domínio verificado, uma pessoa que inicie sessão com um endereço de e-mail verificado nesse domínio junta-se automaticamente à organização, com a sua função predefinida. Um domínio pode ter o auto-join ativado em apenas uma organização da sua aplicação.

Início de sessão único da organização

Uma organização pode permitir que os seus utilizadores iniciem sessão através do seu próprio fornecedor de identidade, com SAML ou OIDC.
  • Ligação de configuração. Escolha Copy setup link no cartão Single sign-on da organização e partilhe-a de forma segura com o administrador de TI da organização. Funciona durante sete dias e orienta-o na configuração da ligação. As ligações de configuração requerem o plano Scale ou Enterprise; as aplicações Sandbox têm-nas em qualquer plano.
  • SAML. Os metadados do seu fornecedor de serviços estão publicados em {origin}/sso/saml/metadata/.
  • Localização da ligação. A página de início de sessão alojada encontra a ligação da organização a partir do domínio de e-mail verificado da pessoa, a partir de Use single sign-on ou a partir de organization=<slug> no URL de início de sessão.
  • Estado. A lista de organizações mostra se cada ligação está ativa, não configurada ou à espera de uma ligação de configuração enviada.
As pessoas que iniciam sessão através do fornecedor de identidade de uma organização juntam-se a ela com a função predefinida da sua organização. Os campos de configuração de cada protocolo estão em métodos de início de sessão.

MFA para administradores de organizações

A política MFA predefinida, organization_admins, exige um segundo fator a cada pessoa que tenha a função admin em qualquer organização da sua aplicação. Uma pessoa que passe a ser administradora tem de registar um fator, e GET /session/ deixa de aceitar a respetiva sessão até que esta cumpra novamente a política. Altere a política em Authentication > Security and sessions ou com mfa_policy nas definições da aplicação.

Ler organizações na sua aplicação

Enquanto as organizações estiverem ativas, os tokens e a sessão da pessoa indicam à sua aplicação a que organização pertence:
Verifique a função e as permissões no seu backend, a partir de um token verificado ou de GET /session/, antes de cada ação que dependa delas. Quando as organizações estiverem desativadas, org é null e a lista está vazia.

Importar organizações existentes

Ao importar utilizadores de outra plataforma, pode trazer também as respetivas adesões a organizações. Consulte links sociais, autenticadores e organizações.
Última modificação em 22 de novembro de 2026