> ## 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 por Empresa

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

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.

> [!NOTE]
>
> 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](#mfa-para-administradores-de-organizações)).

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](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 | Destinada a |
| - | - |
| `admin` | Pessoas que gerem a organização na sua aplicação. |
| `member` | Todos os restantes. A função predefinida. |
| `billing` | Pessoas que tratam da faturação da organização na sua aplicação. |

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

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

| Onde | O que contém |
| - | - |
| declaração `org` nos tokens de acesso e de ID | `{"id", "role"}` da adesão mais antiga da pessoa a uma organização, ou `null`. |
| `organizations` em `GET /session/` | Todas as adesõ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 está vazia.

## Importar organizações existentes

Ao [importar utilizadores](https://docs.didit.me/pt/authentication/migration.md) de outra plataforma, pode trazer também as respetivas adesões a organizações.
Consulte [links sociais, autenticadores e organizações](https://docs.didit.me/pt/authentication/migration.md#ligações-sociais-aplicações-de-autenticação-e-organizações).


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