> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-es/proteger-y-gobernar/identity-providers/microsoft-entra-id.md).

# Microsoft Entra ID

Usa Microsoft Entra ID (antes Azure AD) como tu proveedor de identidad para que los usuarios inicien sesión en Dispel con sus credenciales de Microsoft mediante OAuth (OIDC) o SAML.

## Resumen

Conecta Microsoft Entra ID — la plataforma de identidad en la nube de Microsoft, antes conocida como Azure AD — como proveedor de identidad de tu organización. Una vez conectado, tus usuarios inician sesión en Dispel con sus credenciales de Microsoft mediante inicio de sesión único. Puedes conectar Entra mediante **OAuth (OIDC)** o **SAML**.

Esta página cubre la configuración específica de Entra. Para el comportamiento compartido que se aplica a todos los proveedores — cómo inician sesión los usuarios, el mapeo de grupos, MFA y la desconexión — consulta [Proveedores de identidad](/documentation/documentation-es/proteger-y-gobernar/identity-providers.md).

{% hint style="info" %}
**Dónde encontrarlo.** Inicia sesión como administrador de la organización y abre **Configuración → Integraciones** (o la página dedicada **Configuración → Autenticación** página). Microsoft Entra ID aparece en la **Identidad y autenticación (IdP / SSO)** sección. Haz clic en **Conectar** en su tarjeta para comenzar.
{% endhint %}

## Antes de comenzar

* Configurarás la parte del IdP en el **centro de administración de Microsoft Entra** (o el portal de Azure), así que necesitarás acceso administrativo allí.
* Decide un protocolo — **OAuth (OIDC)** o **SAML**. Consulta [Elegir un protocolo](/documentation/documentation-es/proteger-y-gobernar/identity-providers.md#choosing-a-protocol).
* Asegúrate de que los usuarios que iniciarán sesión a través de Entra ya estén **invitados a tu organización** en Dispel. El SSO autentica a los usuarios, pero no crea acceso por sí solo.

{% hint style="warning" %}
**Un proveedor a la vez.** Si tu organización ya está conectada a otro proveedor de identidad, desconéctalo antes de conectar Entra.
{% endhint %}

## Conectar con OAuth (OIDC)

#### En Microsoft Entra ID

1. En el centro de administración de Microsoft Entra, ve a **Registros de aplicaciones → Nuevo registro** y crea una aplicación para Dispel.
2. Agrega un **Web** URI de redirección de tu dirección de Dispel seguida de `/oauth/login-callback` — por ejemplo `https://app.dispel.com/oauth/login-callback`. Confirma la dirección exacta para tu entorno con tu representante de Dispel si no estás seguro.
3. En **Certificados y secretos**, crea un **secreto de cliente** y copia su valor.
4. Anota tu **ID de aplicación (cliente)** y el extremo OAuth/OIDC de tu inquilino.

#### En Dispel

1. Haz clic en **Conectar** en la tarjeta de Microsoft Entra ID y **Selecciona Protocolo de autenticación → OAuth**.
2. Completa los campos:

| Campo                                | Valor de Entra                                                                                  |
| ------------------------------------ | ----------------------------------------------------------------------------------------------- |
| **URL de cliente**                   | El extremo OAuth/OIDC de tu inquilino (donde se emiten los tokens).                             |
| **ID de cliente**                    | El **ID de aplicación (cliente)** de tu registro de aplicación.                                 |
| **Secreto de cliente**               | El valor del secreto del cliente que creaste.                                                   |
| **Identificador de la organización** | Un identificador único que elijas; los usuarios lo escriben en la pantalla de inicio de sesión. |

3. Haz clic en **Guardar configuración**.

## Conectar con SAML

#### En Microsoft Entra ID

1. En el centro de administración de Microsoft Entra, ve a **Aplicaciones empresariales → Nueva aplicación → Crear tu propia aplicación**, luego abre **Inicio de sesión único → SAML**.
2. En **Configuración básica de SAML**, pega los valores que Dispel muestra en la parte superior de su formulario SAML:
   * **Identificador (ID de entidad)** ← de Dispel **ID de entidad del Proveedor de servicios (SP)**.
   * **URL de respuesta (URL del servicio de consumidor de aserciones)** ← de Dispel **URL del Servicio de consumidor de aserciones**.
3. De la configuración SAML de Entra, recopila:
   * **URL de inicio de sesión** → de Dispel **URL de SSO**.
   * **Identificador de Microsoft Entra** → de Dispel **ID de entidad del proveedor de identidad**.
   * Descarga el **Certificado (Base64)** → de Dispel **Certificado de firma en Base64**.

#### En Dispel

1. Haz clic en **Conectar** en la tarjeta de Microsoft Entra ID y **Selecciona Protocolo de autenticación → SAML**.
2. Copia el **ID de entidad del Proveedor de servicios (SP)** y **URL del Servicio de consumidor de aserciones** mostrados en la parte superior del formulario (usa **Copiar ID** / **Copiar URL**) en Entra, como arriba.
3. Completa los campos:

| Campo                                        | Valor de Entra                                                                                  |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| **URL de SSO**                               | El Entra **URL de inicio de sesión**.                                                           |
| **ID de entidad del proveedor de identidad** | El **Identificador de Microsoft Entra**.                                                        |
| **Certificado de firma en Base64**           | El certificado Base64 descargado. Pégalo o usa **Subir certificado**.                           |
| **Identificador de la organización**         | Un identificador único que elijas; los usuarios lo escriben en la pantalla de inicio de sesión. |

4. Haz clic en **Guardar configuración**.
5. Haz clic en **Probar conexión**. Dispel te redirige a Entra para iniciar sesión y luego muestra el correo electrónico y el nombre que recibió. Si la prueba falla, confirma que los valores coinciden con tu aplicación de Entra y que el usuario de prueba está invitado a tu organización.

## Después de conectar

* **Los usuarios inician sesión** introduciendo tu identificador de organización en la pantalla de inicio de sesión de Dispel y autenticándote con Microsoft. Consulta [Cómo inician sesión los usuarios](/documentation/documentation-es/proteger-y-gobernar/identity-providers.md#how-users-sign-in).
* **Asignar grupos de Entra a grupos de Dispel** para que la membresía se mantenga sincronizada — consulta [Mapeo de grupos OIDC](/documentation/documentation-es/integrar-y-administrar/integrations/oidc-group-mapping.md).
* **MFA** lo que se aplica en Entra se aplica durante el inicio de sesión; los códigos de un solo uso por correo electrónico de Dispel no se aplican a los usuarios de SSO. Consulta [SSO y autenticación multifactor](/documentation/documentation-es/proteger-y-gobernar/identity-providers.md#sso-and-multi-factor-authentication).
* **Para cambiar de protocolo o de proveedor**, desconéctalo primero. Consulta [Cambiar o desconectar un proveedor](/documentation/documentation-es/proteger-y-gobernar/identity-providers.md#switching-or-disconnecting-a-provider).

## Preguntas frecuentes

<details>

<summary>¿Es lo mismo que «Azure AD»?</summary>

Sí. Microsoft cambió el nombre de Azure Active Directory a Microsoft Entra ID. Si tu consola de Entra aún muestra etiquetas de "Azure AD" en algunos lugares, la configuración es la misma.

</details>

<details>

<summary>¿Qué protocolo debo usar con Entra?</summary>

Cualquiera funciona. Usa el que coincida con cómo esté configurada tu aplicación de Entra: un registro de aplicación OIDC para OAuth, o una aplicación empresarial con inicio de sesión único SAML para SAML.

</details>

<details>

<summary>Falló mi prueba de conexión SAML. ¿Qué debo comprobar?</summary>

Confirma que la URL de SSO, el ID de entidad y el certificado coinciden exactamente con tu aplicación SAML de Entra, que pegaste el ID de entidad del SP y la URL ACS de Dispel en la Configuración básica de SAML de Entra, y que el usuario de prueba existe en Entra y está invitado a tu organización de Dispel.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dispel.com/documentation/documentation-es/proteger-y-gobernar/identity-providers/microsoft-entra-id.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.