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

# Organizaciones B2B: miembros, roles y SSO por empresa

> Gestiona a tus clientes B2B como organizaciones en Didit Authentication: miembros, roles, invitaciones, dominios verificados y SSO por empresa.

Las organizaciones de Didit Authentication permiten a una aplicación B2B agrupar a sus usuarios por la empresa en la que trabajan.
Cada organización tiene sus propios miembros y roles, puede verificar sus dominios de correo electrónico para que sus compañeros se unan automáticamente, y puede autenticar a sus usuarios mediante su propio proveedor de identidad SAML u OIDC.
Tu aplicación lee las organizaciones y los roles de la persona desde su token y su sesión, y decide qué puede hacer cada rol.

> [!NOTE]
>
> Una organización en este contexto es uno de **tus** clientes, dentro de tu aplicación.
> Es distinta de tu organización en Didit, que agrupa a tu propio equipo en la Business Console.

## Activar las organizaciones

Las organizaciones están desactivadas en una aplicación nueva.
Abre **Authentication > Organizations** en la consola y, en su tarjeta **Settings**:

* Activa **Organizations**.
* Elige el **Default role for new members**, el rol que reciben las personas cuando se unen a través de un dominio verificado o del inicio de sesión único (`member` por defecto).
* Mantén activada la opción **Require MFA for organization admins**, la política de MFA predeterminada (consulta [más abajo](#mfa-para-administradores-de-organizaciones)).

Después gestionas las organizaciones desde la consola: **New organization** crea una con su nombre y un slug, único dentro de la aplicación.
Tu equipo crea las organizaciones; por ahora las personas no pueden crear sus propias organizaciones desde tu aplicación.
La lista muestra los miembros de cada organización, sus dominios verificados, el estado del inicio de sesión único, la regla de MFA y la fecha de creación. Encima de la lista, las métricas clave cuentan organizaciones, miembros, conexiones de inicio de sesión único y dominios verificados.

![La página Organizations en la Didit Business Console, con las métricas clave y una lista de organizaciones con sus miembros, dominios verificados y estado del inicio de sesión único](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organizations.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=95f8ab54f499735fe3f8593c565c0daa)

Authentication > Organizations.

## Miembros y roles

Una persona puede pertenecer a varias organizaciones de tu aplicación, con un rol en cada una.

| Rol | Destinado a |
| - | - |
| `admin` | Personas que gestionan la organización en tu aplicación. |
| `member` | Todos los demás. Es el rol por defecto. |
| `billing` | Personas que gestionan la facturación de la organización en tu aplicación. |

En los planes Scale y Enterprise, y en cada aplicación de sandbox, también puedes definir **roles personalizados**, cada uno con una clave y los permisos que tu aplicación comprueba, por ejemplo `payouts.approve`.
Un miembro puede tener un rol personalizado además de su rol.

Abre una organización para ver su inicio de sesión único, sus dominios verificados, sus miembros, sus roles y sus invitaciones.

![Una organización abierta en la Business Console de Didit, con su inicio de sesión único SAML y un enlace de configuración, un dominio verificado con unión automática, y sus miembros y roles](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organization-detail.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=c3c60f877bbd96f53cb7d6ca2095d3d1)

El inicio de sesión único, los dominios verificados, los miembros y los roles de una organización.

## Invitaciones

Elige **Invite member** en una organización, introduce hasta 20 direcciones de correo electrónico y el rol que recibirá cada una (`admin`, `member` o `billing`), y Didit envía a cada persona una invitación por correo electrónico.
Una invitación tiene una validez de 7 días y abre la página alojada `/invite` en tu origen de inicio de sesión, donde la persona inicia sesión o crea una cuenta y se une.
La lista **Invitations** de la organización muestra cuándo caduca cada invitación, con **Resend** y **Revoke**.

## Dominios verificados y unión automática

Una organización puede demostrar que es propietaria de un dominio de correo electrónico:

1. Añade el dominio a la organización.
2. Añade con tu proveedor de DNS el registro TXT que Didit muestra en `_didit-auth.<domain>` y que contiene el token de verificación.
3. Comprueba el dominio. Aparece como **Verificado** una vez que se encuentra el registro.

Con **Unión automática** activada para un dominio verificado, una persona que inicie sesión con una dirección de correo electrónico verificada de ese dominio se une automáticamente a la organización, con tu rol predeterminado.
Un dominio solo puede unirse automáticamente a una organización de tu aplicación.

## Inicio de sesión único corporativo

Una organización puede permitir que sus personas inicien sesión a través de su propio proveedor de identidad, con SAML u OIDC.

* **Enlace de configuración.** Elige **Copiar enlace de configuración** en la tarjeta **Inicio de sesión único** de la organización y compártelo de forma segura con el administrador de TI de la organización. Funciona durante siete días y los guía paso a paso durante la configuración de la conexión. Los enlaces de configuración requieren el plan Scale o Enterprise; las aplicaciones sandbox los tienen en cualquier plan.
* **SAML.** Los metadatos de tu proveedor de servicios se publican en `{origin}/sso/saml/metadata/`.
* **Localizar la conexión.** La página de inicio de sesión alojada encuentra la conexión de la organización a partir del dominio de correo electrónico verificado de la persona, desde **Usar el inicio de sesión único** o desde `organization=<slug>` en la URL de inicio de sesión.
* **Estado.** La lista de organizaciones muestra si cada conexión está activa, sin configurar o a la espera de un enlace de configuración que se ha enviado.

Las personas que inician sesión a través del proveedor de identidad de una organización se unen a ella con tu rol predeterminado.
Los campos de configuración de cada protocolo están en [métodos de inicio de sesión](https://docs.didit.me/es/authentication/sign-in-methods.md#sso-de-organización).

## MFA para administradores de organizaciones

La política MFA predeterminada, `organization_admins`, exige un segundo factor a cada persona que tenga el rol `admin` en cualquier organización de tu aplicación.
Una persona que pase a ser administradora debe registrar un factor, y `GET /session/` deja de aceptar su sesión hasta que esta cumpla de nuevo la política.
Cambia la política en **Authentication > Security and sessions** o con `mfa_policy` en la [configuración de la aplicación](https://docs.didit.me/es/authentication/overview.md#configuración-de-la-aplicación).

## Leer organizaciones en tu aplicación

Mientras las organizaciones están activadas, los tokens y la sesión de la persona indican a tu aplicación a qué organizaciones pertenece:

| Dónde | Qué contiene |
| - | - |
| Claim `org` de los tokens de acceso y de ID | `{"id", "role"}` de la membresía de organización más antigua de la persona, o `null`. |
| `organizations` en `GET /session/` | Cada membresía, con `organization_id`, `organization__name`, `role` y `custom_role` (`key` y `permissions`, o `null`). |
| `organizations` en la sesión del SDK | La misma lista, por ejemplo `session.organizations` en JavaScript y `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"]}
    }
  ]
}
```

Comprueba el rol y los permisos en tu backend, a partir de un token verificado o de `GET /session/`, antes de cada acción que dependa de ellos.
Cuando las organizaciones están desactivadas, `org` es `null` y la lista está vacía.

## Importar organizaciones existentes

Cuando [importas usuarios](https://docs.didit.me/es/authentication/migration.md) desde otra plataforma, puedes traer también sus membresías en organizaciones.
Consulta [enlaces sociales, autenticadores y organizaciones](https://docs.didit.me/es/authentication/migration.md#vínculos-sociales-autenticadores-y-organizaciones).


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