> ## 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.

# Organitzacions per a apps B2B: membres, rols i SSO d'empresa

> Modela els teus clients empresarials com a organitzacions a Didit Authentication, amb membres, rols, invitacions, dominis verificats, auto-alta i SSO propi.

Les organitzacions de Didit Authentication permeten que una aplicació B2B agrupi els seus usuaris segons l'empresa on treballen.
Cada organització té els seus propis membres i rols, pot verificar els seus dominis de correu electrònic perquè els companys s'hi uneixin automàticament, i pot permetre que els seus membres iniciïn sessió mitjançant el seu propi proveïdor d'identitat SAML o OIDC.
La teva aplicació llegeix les organitzacions i els rols de la persona del seu token i la seva sessió, i decideix què pot fer cada rol.

> [!NOTE]
>
> Una organització aquí és un dels **teus** clients, dins de la teva aplicació.
> És independent de la teva organització de Didit, que conté el teu propi equip a la Business Console.

## Activa les organitzacions

Les organitzacions estan desactivades per a una aplicació nova.
Obre **Authentication > Organizations** a la consola i, a la targeta **Settings**:

* Activa **Organizations**.
* Tria el **Default role for new members**, el rol que reben les persones quan s'uneixen a través d'un domini verificat o de l'inici de sessió únic (`member` per defecte).
* Mantén activat **Require MFA for organization admins**, la política de MFA per defecte (consulta [més avall](#mfa-per-a-administradors-d’organitzacions)).

Després gestiones les organitzacions a la consola: **New organization** en crea una amb el seu nom i un slug, únic dins de l'aplicació.
Les organitzacions les crea el teu equip; les persones encara no poden crear les seves pròpies organitzacions des de la teva aplicació.
La llista mostra els membres de cada organització, els dominis verificats, l'estat de l'inici de sessió únic, la regla de MFA i la data de creació, i per sobre hi ha les mètriques clau, que compten organitzacions, membres, connexions SSO i dominis verificats.

![La pàgina d'Organizations a la Didit Business Console, amb les mètriques clau i una llista d'organitzacions amb els seus membres, dominis verificats i estat de l'inici de sessió únic](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organizations.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=95f8ab54f499735fe3f8593c565c0daa)

Authentication > Organizations.

## Membres i rols

Una persona pot pertànyer a diverses organitzacions de la teva aplicació, amb un rol en cadascuna.

| Rol | Destinat a |
| - | - |
| `admin` | Persones que gestionen l'organització a la teva aplicació. |
| `member` | La resta de persones. El rol per defecte. |
| `billing` | Persones que gestionen la facturació de l'organització a la teva aplicació. |

Als plans Scale i Enterprise, i en qualsevol aplicació sandbox, també pots definir **rols personalitzats**, cadascun amb una clau i els permisos que la teva aplicació comprova, per exemple `payouts.approve`.
Un membre pot tenir un rol personalitzat a més del seu rol.

Obre una organització per veure'n l'inici de sessió únic, els dominis verificats, els membres, els rols i les invitacions.

![Una organització oberta a la Didit Business Console, que mostra el seu inici de sessió únic SAML amb un enllaç de configuració, un domini verificat amb unió automàtica, i els seus membres i rols](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organization-detail.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=c3c60f877bbd96f53cb7d6ca2095d3d1)

Inici de sessió únic, dominis verificats, membres i rols d'una organització.

## Invitacions

Tria **Invite member** per a una organització, introdueix fins a 20 adreces de correu electrònic i el rol que tindrà cadascú (`admin`, `member` o `billing`), i Didit envia a cada persona una invitació per correu electrònic.
Una invitació dura 7 dies i obre la pàgina allotjada `/invite` al teu origen d'inici de sessió, on la persona inicia sessió o crea un compte i s'uneix.
La llista **Invitations** de l'organització mostra quan caduca cada invitació, amb **Resend** i **Revoke**.

## Dominis verificats i unió automàtica

Una organització pot demostrar que és propietària d'un domini de correu electrònic:

1. Afegeix el domini a l'organització.
2. Afegeix el registre TXT que Didit mostra a `_didit-auth.<domain>` amb el teu proveïdor de DNS, que conté el token de verificació.
3. Comprova el domini. Apareix com a **Verified** quan es troba el registre.

Amb **Auto-join** activat per a un domini verificat, qualsevol persona que iniciï sessió amb una adreça de correu electrònic verificada d'aquest domini s'uneix automàticament a l'organització, amb el teu rol per defecte.
Un domini només pot unir-se automàticament a una organització de la teva aplicació.

## Inici de sessió únic d'empresa

Una organització pot fer que les seves persones iniciïn sessió amb el seu propi proveïdor d'identitat, amb SAML o OIDC.

* **Enllaç de configuració.** Trieu **Copy setup link** a la targeta **Single sign-on** de l'organització i compartiu-lo de manera segura amb l'administrador de TI de l'organització. Funciona durant set dies i els guia pas a pas en la connexió. Els enllaços de configuració requereixen el pla Scale o Enterprise; les aplicacions sandbox en tenen en qualsevol pla.
* **SAML.** Les metadades del vostre proveïdor de serveis es publiquen a `{origin}/sso/saml/metadata/`.
* **Cerca de la connexió.** La pàgina d'inici de sessió allotjada troba la connexió de l'organització a partir del domini de correu electrònic verificat de la persona, de **Use single sign-on** o de `organization=<slug>` a l'URL d'inici de sessió.
* **Estat.** La llista d'organitzacions indica si cada connexió està activa, no configurada o pendent d'un enllaç de configuració que s'ha enviat.

Les persones que inicien sessió amb el proveïdor d'identitat d'una organització s'hi afegeixen amb el vostre rol per defecte.
Els camps de configuració de cada protocol són a [mètodes d'inici de sessió](https://docs.didit.me/ca/authentication/sign-in-methods.md#sso-d’organització).

## MFA per a administradors d'organitzacions

La política de MFA predeterminada, `organization_admins`, exigeix un segon factor a totes les persones que tinguin el rol `admin` en qualsevol organització de la teva aplicació.
Una persona que esdevé administradora ha de registrar un factor, i `GET /session/` deixa d'acceptar la seva sessió fins que la sessió torni a complir la política.
Canvia la política a **Authentication > Security and sessions** o amb `mfa_policy` a la [configuració de l'aplicació](https://docs.didit.me/ca/authentication/overview.md#configuració-de-l’aplicació).

## Llegeix les organitzacions a la teva aplicació

Mentre les organitzacions estiguin activades, els tokens i la sessió de la persona indiquen a la teva aplicació a quines organitzacions pertany:

| On | Què conté |
| - | - |
| `org` claim als tokens d'accés i d'ID | `{"id", "role"}` de la pertinença a una organització més antiga de la persona, o `null`. |
| `organizations` a `GET /session/` | Totes les pertinences, amb `organization_id`, `organization__name`, `role` i `custom_role` (`key` i `permissions`, o `null`). |
| `organizations` a la sessió del SDK | La mateixa llista, per exemple `session.organizations` en JavaScript i `user.organizations` en React. |

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

Comprova el rol i els permisos al teu backend, a partir d'un token verificat o de `GET /session/`, abans de cada acció que en depengui.
Quan les organitzacions estan desactivades, `org` és `null` i la llista és buida.

## Importa organitzacions existents

Quan [importes usuaris](https://docs.didit.me/ca/authentication/migration.md) d'una altra plataforma, pots importar-ne també les membresies a organitzacions.
Consulta [enllaços socials, autenticadors i organitzacions](https://docs.didit.me/ca/authentication/migration.md#vincles-socials-autenticadors-i-organitzacions).


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