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

# Organisations B2B : membres, rôles et SSO d'entreprise

> Modélisez vos clients entreprises comme organisations dans Didit Authentication : membres, rôles, invitations, domaines vérifiés, SSO dédié.

Les organisations de Didit Authentication permettent à une application B2B de regrouper ses utilisateurs en fonction de l'entreprise pour laquelle ils travaillent.
Chaque organisation possède ses propres membres et rôles, peut vérifier ses domaines e-mail afin que ses collègues la rejoignent automatiquement et peut authentifier ses utilisateurs via son propre fournisseur d'identité SAML ou OIDC.
Votre application lit les organisations et les rôles de la personne à partir de son token et de sa session, puis détermine ce que chaque rôle peut faire.

> [!NOTE]
>
> Dans ce contexte, une organisation désigne l'un de **vos** clients, au sein de votre application.
> Elle est distincte de votre organisation Didit, qui regroupe votre propre équipe dans la Business Console.

## Activer les organisations

Les organisations sont désactivées pour une nouvelle application.
Ouvrez **Authentication > Organizations** dans la console, puis dans sa carte **Settings** :

* Activez **Organizations**.
* Choisissez le **Default role for new members**, c'est-à-dire le rôle attribué aux personnes qui rejoignent une organisation via un domaine vérifié ou l'authentification unique (`member` par défaut).
* Laissez **Require MFA for organization admins** activée, qui correspond à la politique MFA par défaut (voir [ci-dessous](#authentification-mfa-pour-les-administrateurs-d’organisation)).

Vous gérez ensuite les organisations dans la console : **New organization** crée une organisation avec son nom et un slug, unique dans l'application.
Vos organisations sont créées par votre équipe ; les personnes ne peuvent pas encore créer leurs propres organisations depuis votre application.
La liste affiche pour chaque organisation ses membres, ses domaines vérifiés, le statut de son authentification unique, sa règle MFA et sa date de création. Les métriques clés au-dessus comptent les organisations, les membres, les connexions SSO et les domaines vérifiés.

![La page Organizations de la Didit Business Console, avec les métriques clés et la liste des organisations, leurs membres, leurs domaines vérifiés et le statut de leur authentification unique](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organizations.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=95f8ab54f499735fe3f8593c565c0daa)

Authentication > Organizations.

## Membres et rôles

Une personne peut appartenir à plusieurs organisations de votre application, avec un rôle dans chacune.

| Rôle | Destiné à |
| - | - |
| `admin` | Les personnes qui gèrent l'organisation dans votre application. |
| `member` | Toutes les autres personnes. Le rôle par défaut. |
| `billing` | Les personnes qui gèrent la facturation de l'organisation dans votre application. |

Sur les forfaits Scale et Enterprise, ainsi que dans chaque application Sandbox, vous pouvez également définir des **rôles personnalisés**, chacun avec une clé et les autorisations que votre application vérifie, par exemple `payouts.approve`.
Un membre peut détenir un rôle personnalisé en plus de son rôle.

Ouvrez une organisation pour voir son authentification unique, ses domaines vérifiés, ses membres, ses rôles et ses invitations.

![Une organisation ouverte dans la Business Console de Didit, affichant son authentification unique SAML avec un lien de configuration, un domaine vérifié avec rattachement automatique, ainsi que ses membres et ses rôles](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organization-detail.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=c3c60f877bbd96f53cb7d6ca2095d3d1)

L'authentification unique, les domaines vérifiés, les membres et les rôles d'une organisation.

## Invitations

Choisissez **Invite member** pour une organisation, saisissez jusqu'à 20 adresses e-mail et le rôle attribué à chacune (`admin`, `member` ou `billing`). Didit envoie alors une invitation par e-mail à chaque personne.
Une invitation est valable 7 jours et ouvre la page hébergée `/invite` sur l'origine depuis laquelle vous vous connectez, où la personne se connecte ou crée un compte, puis rejoint l'organisation.
La liste **Invitations** de l'organisation indique la date d'expiration de chaque invitation, avec les boutons **Resend** et **Revoke**.

## Domaines vérifiés et adhésion automatique

Une organisation peut prouver qu'elle possède un domaine d'e-mail :

1. Ajoutez le domaine à l'organisation.
2. Ajoutez l'enregistrement TXT que Didit affiche à `_didit-auth.<domain>` auprès de votre fournisseur DNS, contenant le token de vérification.
3. Vérifiez le domaine. Il apparaît comme **Verified** une fois l'enregistrement trouvé.

Lorsque **Auto-join** est activé pour un domaine vérifié, une personne qui se connecte avec une adresse e-mail vérifiée de ce domaine rejoint automatiquement l'organisation, avec votre rôle par défaut.
Un domaine ne peut permettre l'adhésion automatique qu'à une seule organisation de votre application.

## Authentification unique de l'organisation

Une organisation peut permettre à ses membres de se connecter par son propre fournisseur d'identité, avec SAML ou OIDC.

* **Lien de configuration.** Cliquez sur **Copy setup link** dans la carte **Single sign-on** de l'organisation, puis partagez-le de manière sécurisée avec l'administrateur informatique de l'organisation. Il reste valide pendant sept jours et guide la personne pas à pas dans la connexion. Les liens de configuration nécessitent le forfait Scale ou Enterprise, sauf pour les applications sandbox, qui en disposent quel que soit le forfait.
* **SAML.** Vos métadonnées de fournisseur de services sont publiées à l'adresse `{origin}/sso/saml/metadata/`.
* **Recherche de la connexion.** La page de connexion hébergée identifie la connexion de l'organisation à partir du domaine e-mail vérifié de la personne, à partir de **Use single sign-on**, ou à partir de `organization=<slug>` dans l'URL de connexion.
* **Statut.** La liste des organisations indique si chaque connexion est active, non configurée, ou en attente d'un lien de configuration envoyé.

Les personnes qui se connectent par le fournisseur d'identité d'une organisation rejoignent celle-ci avec votre rôle par défaut. Les champs de configuration de chaque protocole sont décrits dans les [méthodes de connexion](https://docs.didit.me/fr/authentication/sign-in-methods.md#sso-d’organisation).

## Authentification MFA pour les administrateurs d'organisation

La politique MFA par défaut, `organization_admins`, exige que chaque personne détenant le rôle `admin` dans n'importe quelle organisation de votre application utilise un second facteur.
Une personne qui devient administrateur doit enregistrer un facteur, et `GET /session/` cesse d'accepter sa session tant que celle-ci ne respecte pas à nouveau la politique.
Modifiez la politique sous **Authentification > Sécurité et sessions**, ou avec `mfa_policy` dans les [paramètres de l'application](https://docs.didit.me/fr/authentication/overview.md#paramètres-de-l’application).

## Lire les organisations dans votre application

Lorsque les organisations sont activées, les tokens et la session de la personne indiquent à votre application à quelles organisations elle appartient :

| Emplacement | Contenu |
| - | - |
| Revendication `org` dans les tokens d'accès et d'identité | `{"id", "role"}` de la première appartenance à une organisation de la personne, ou `null`. |
| `organizations` dans `GET /session/` | Toutes les appartenances, avec `organization_id`, `organization__name`, `role` et `custom_role` (`key` et `permissions`, ou `null`). |
| `organizations` dans la session du SDK | La même liste, par exemple `session.organizations` en JavaScript et `user.organizations` dans React. |

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

Vérifiez le rôle et les autorisations côté serveur, à partir d'un token vérifié ou de `GET /session/`, avant chaque action qui en dépend.
Lorsque les organisations sont désactivées, `org` vaut `null` et la liste est vide.

## Importer les organisations existantes

Lorsque vous [importez des utilisateurs](https://docs.didit.me/fr/authentication/migration.md) depuis une autre plateforme, vous pouvez également importer leurs appartenances à des organisations.
Voir [liens sociaux, authentificateurs et organisations](https://docs.didit.me/fr/authentication/migration.md#liens-sociaux-authentificateurs-et-organisations).


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