> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizações B2B: membros, funções e SSO corporativo

> Modele seus clientes B2B como organizações no Didit Authentication, com membros, funções, convites, domínios verificados e SSO próprio.

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.

> [!NOTE]
>
> 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](#mfa-para-administradores-da-organização)).

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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organizations.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=95f8ab54f499735fe3f8593c565c0daa)

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.

| Função | Destinado a |
| - | - |
| `admin` | Pessoas que gerenciam a organização na sua aplicação. |
| `member` | Todas as demais pessoas. A função padrão. |
| `billing` | Pessoas que cuidam do faturamento da organização na sua aplicação. |

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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organization-detail.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=c3c60f877bbd96f53cb7d6ca2095d3d1)

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](https://docs.didit.me/pt-br/authentication/sign-in-methods.md#sso-da-organização).

## 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](https://docs.didit.me/pt-br/authentication/overview.md#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:

| Onde | O que contém |
| - | - |
| Claim `org` nos tokens de acesso e de ID | `{"id", "role"}` da associação mais antiga da pessoa a uma organização, ou `null`. |
| `organizations` em `GET /session/` | Todas as associações, com `organization_id`, `organization__name`, `role` e `custom_role` (`key` e `permissions`, ou `null`). |
| `organizations` na sessão do SDK | A mesma lista, por exemplo `session.organizations` em JavaScript e `user.organizations` em React. |

```json theme={null}
{
  "organizations": [
    {
      "organization_id": "3e9a1f0b-5c2d-4e7f-8a6b-9c0d1e2f3a4b",
      "organization__name": "Northwind",
      "role": "admin",
      "custom_role": {"key": "approver", "permissions": ["payouts.approve"]}
    }
  ]
}
```

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](https://docs.didit.me/pt-br/authentication/migration.md) de outra plataforma, você pode trazer também a participação deles em organizações.
Veja [links sociais, autenticadores e organizações](https://docs.didit.me/pt-br/authentication/migration.md#vínculos-sociais-autenticadores-e-organizações).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.