Pular para o conteúdo principal
Didit Authentication, por meio das organizações, permite que uma aplicação B2B agrupe seus usuários pela empresa em que trabalham. Cada organização tem seus próprios membros e funções, pode verificar seus domínios de e-mail para que os colegas entrem automaticamente, e pode autenticar seus usuários pelo próprio provedor de identidade SAML ou OIDC. 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. Ela é separada da sua organização no Didit, que reúne a sua própria equipe no Business Console.

Ativar organizações

As organizações estão desativadas em uma aplicação nova. Abra Authentication > Organizations no console e, no card Settings:
  • Ative Organizations.
  • Escolha o Default role for new members, a função que as pessoas recebem ao entrar por meio de um domínio verificado ou de login único (por padrão, member).
  • Mantenha Require MFA for organization admins ativado, que é a política de MFA padrão (veja abaixo).
Depois disso, você gerencia as organizações no console: New organization cria uma organização com nome e slug, que é único na aplicação. Suas organizações são criadas pela sua equipe; por enquanto, as pessoas 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 status de login único, a regra de MFA e a data de criação de cada organização. Acima dela, as métricas principais contam organizações, membros, conexões de SSO e domínios verificados.
A página Organizations no Didit Business Console, com métricas principais e uma lista de organizações com seus membros, domínios verificados e status 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, você também pode definir funções personalizadas, cada uma com uma chave e as permissões que 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 o login único, os domínios verificados, os membros, as funções e os convites dela.
Uma organização aberta no Didit Business Console, mostrando o login único SAML com um link de configuração, um domínio verificado com entrada automática e os membros e funções dela

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

Convites

Escolha Convidar membro em uma organização, informe até 20 endereços de e-mail e a função que cada pessoa vai receber (admin, member ou billing). A Didit envia um e-mail de convite para cada pessoa. Um convite tem validade de 7 dias e abre a página /invite hospedada na sua origem de login, onde a pessoa entra ou cria uma conta e ingressa na organização. A lista de Convites da organização mostra quando cada convite expira, com os botões Reenviar e Revogar.

Domínios verificados e entrada automática

Uma organização pode comprovar que é proprietária de um domínio de e-mail:
  1. Adicione o domínio à organização.
  2. Adicione o registro TXT que o Didit exibe em _didit-auth.<domain> no seu provedor de DNS, contendo o token de verificação.
  3. Verifique o domínio. Ele aparece como Verified assim que o registro for encontrado.
Com o Auto-join ativado para um domínio verificado, uma pessoa que fizer login com um endereço de e-mail verificado nesse domínio entra automaticamente na organização, com a função padrão da organização. Um domínio pode usar o auto-join em apenas uma organização da sua aplicação.

Login único corporativo

Uma organização pode fazer com que as pessoas dela façam login pelo próprio provedor de identidade, usando SAML ou OIDC.
  • Link de configuração. Escolha Copy setup link no card Single sign-on da organização e compartilhe o link com segurança com o administrador de TI da organização. Ele vale por sete dias e guia a configuração da conexão. Links de configuração exigem o plano Scale ou Enterprise; aplicações Sandbox os têm em qualquer plano.
  • SAML. Os metadados do seu provedor de serviço são publicados em {origin}/sso/saml/metadata/.
  • Localização da conexão. A página de login hospedada encontra a conexão da organização pelo domínio de e-mail verificado da pessoa, a partir de Use single sign-on ou pelo parâmetro organization=<slug> na URL de login.
  • Status. A lista de organizações mostra se cada conexão está ativa, não configurada ou aguardando um link de configuração que foi enviado.
Pessoas que fazem login pelo provedor de identidade de uma organização entram nela com a sua função padrão. Os campos de configuração de cada protocolo estão em métodos de login.

MFA para administradores da organização

A política padrão de MFA, organization_admins, exige um segundo fator de cada pessoa que tenha a função admin em qualquer organização da sua aplicação. Uma pessoa que se torna administradora precisa cadastrar um fator, e GET /session/ deixa de aceitar a sessão dela até que a sessão atenda à política novamente. Altere a política em Autenticação > Segurança e sessões, ou com mfa_policy nas configuraçõ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 informam à sua aplicação a quais organizações ela 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 fica vazia.

Importar organizações existentes

Ao importar usuários de outra plataforma, você pode trazer também a participação deles em organizações. Veja links sociais, autenticadores e organizações.
Última modificação em 22 de novembro de 2026