> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/es/autenticacion/azure-auth.md).

# Uso de Entra ID (Azure AD) para autenticación

Guía paso a paso para configurar Microsoft Entra ID (Azure AD) como fuente de autorización OAuth2 en VergeOS, incluyendo registro de aplicaciones, integración de grupos y aprovisionamiento de usuarios.

VergeOS se puede configurar para permitir que los usuarios se autentiquen usando sus credenciales corporativas de Azure. Esta página lo guiará a través del proceso de configuración.

## Configurar una fuente de autorización de Entra ID

1. En los servicios de Azure: registre una aplicación web de un solo inquilino, estableciendo la ***URI de redireccionamiento*** en la URL del sistema VergeOS y creando un nuevo secreto de cliente. **Azure Active Directory > Registros de aplicaciones > Nuevo registro** ![azurereg1.png](https://1206374132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-bb5217dce60d2b5fbc13525b6c4d55fde916fd24%2Fazurereg1.png?alt=media)

   ![azurereg2.png](https://1206374132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-b0d802ab9f75bd8da9c880b685efdbf1c08482cb%2Fazurereg2.png?alt=media)
2. Cree un nuevo secreto de cliente. **Registros de aplicaciones > Credenciales de cliente > Agregar un certificado o secreto. Haga clic en +Nuevo secreto de cliente.**

   * Ingrese una **descripción y fecha de vencimiento** para el nuevo secreto de cliente.
   * **Obtenga lo siguiente de Azure** para usarlo en la configuración de la fuente de autorización dentro de VergeOS:
     * **ID de inquilino** - **sugerencia:&#x20;*****Todos los servicios > Azure Active Directory > Información general.*****&#x20;El ID de inquilino se muestra en Información básica.**
     * **ID de cliente** - **sugerencia:&#x20;*****Registros de aplicaciones de Azure > Elemento configurado > Credenciales de cliente***
     * **Secreto de cliente** - **sugerencia:&#x20;*****Registros de aplicaciones de Azure > Elemento configurado > Credenciales de cliente*****&#x20;Use el campo "VALUE".**

   ![azureclientsecretadd.png](https://1206374132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-c610e7f4a2b6df1024f288adee4abc9a8b7e2645%2Fazureclientsecretadd.png?alt=media) ![azureclientsecret2.png](https://1206374132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-0984cccf8b287e22110087cb9a1a6dd3480b234b%2Fazureclientsecret2.png?alt=media)
3. Haga clic en **Sistema** en el menú superior.
4. Seleccione **Fuentes de autenticación**.
5. Haga clic en **Nuevo** en el menú de la izquierda.
6. Ingrese una ***Nombre*** para la fuente (como "Azure"). Este nombre aparecerá en el botón de inicio de sesión de la página de acceso de VergeOS. ![azureauthform.png](https://1206374132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-e9db0034056da44a679926f7e04c71f9a7a4ecfa%2Fazureauthform.png?alt=media)
7. En el ***Controlador*** campo (lista desplegable), seleccione **Azure AD**.
8. Ingrese el ***ID de inquilino*** obtenido en el paso anterior.
9. La ***URI de redireccionamiento*** debe ser la URL de su sistema VergeOS (por ejemplo: https\:/\[]/verge.io.mycompanyabc.com)
10. Ingrese ***URL del punto final para que el usuario cierre el token de sesión*** (https\:/\[]/login.microsoftonline.com/***ID\_DE\_INQUILINO***/oauth2/v2.0/logout)
11. ***Alcance*** normalmente debe dejarse en el valor predeterminado: "OpenID profile email".
12. ***Alcance de grupo*** debe configurarse si los usuarios deben crearse automáticamente según la pertenencia a grupos; normalmente, se establece en la palabra "groups" sin signos de puntuación.
13. Ingrese el ***ID de cliente*** obtenido en el paso anterior.
14. Ingrese el ***Secreto de cliente*** obtenido en el paso anterior.
15. ***Campos de usuario remoto*** define la lista de campos usados para localizar inicialmente al usuario de Azure; este campo se completa automáticamente con (sub,preferred\_username,email nickname), una lista predeterminada que normalmente puede funcionar para la mayoría de las implementaciones. **Nota: Por razones de seguridad, no se recomienda localizar usuarios remotos basándose en campos que puedan ser modificados por el usuario final en el sistema remoto.**
16. Para trasladar la pertenencia a grupos desde Azure a VergeOS, marque la casilla ***Actualizar membresía de grupo*** . Los grupos deben crearse en VergeOS siguiendo las instrucciones a continuación.
17. **Funciones de creación automática de usuarios (opcional)**: Los usuarios pueden crearse automáticamente al iniciar sesión por primera vez en VergeOS; esto puede seleccionarse para todos los usuarios de Entra ID o limitarse a usuarios en grupos específicos de Entra ID.
    * ***Crear usuarios automáticamente*** - Si todos los usuarios deben crearse automáticamente, ingrese `.*` aquí.
    * ***Crear usuarios automáticamente en un grupo*** - Para crear automáticamente solo los usuarios que sean miembros de grupos específicos de Entra ID, ingrese el/los ID de objeto del grupo en formato de expresión regular (regex).

{% hint style="info" %}
**Creación automática de usuarios en grupos**

* La **Alcance de grupo** debe definirse. (Campo Alcance de grupo definido arriba)
* **Configuración del token** debe configurarse en Entra ID (instrucciones abajo).
* Entra ID **grupos** especificados para la creación automática **deben crearse en el lado de VergeOS** (instrucciones abajo).
* Para crear automáticamente según el grupo, el ***Crear usuarios automáticamente*** **campo debe estar vacío**
* Se pueden ingresar varios ID de grupo específicos usando el formato: (ID)|(ID)|(ID)
  {% endhint %}

18. **Opciones (se recomienda habilitarlas):**

* ***Actualizar usuario remoto:*** - una vez que el usuario se encuentre en Entra ID, actualice el usuario de VergeOS *Nombre de usuario remoto* al ID único correspondiente de Azure.

{% hint style="success" %}
**Habilitar Actualizar usuario remoto permitirá que el sistema VergeOS almacene el ID único de Azure en el registro del usuario de VergeOS (después de localizar inicialmente al usuario de Entra ID con los campos definidos en Campos de usuario remoto), de modo que posteriormente se pueda usar el identificador único para buscar al usuario de Entra ID; normalmente esto se recomienda, ya que campos como la dirección de correo electrónico pueden cambiar.**
{% endhint %}

* ***Actualizar dirección de correo electrónico del usuario:*** - Actualice la dirección de correo electrónico del usuario de VergeOS para que coincida con la dirección de correo electrónico dentro de Entra ID.
* ***Actualizar nombre para mostrar del usuario:*** - Actualice el nombre para mostrar del usuario de VergeOS para que coincida con el nombre para mostrar dentro de Entra ID.
* ***Actualizar membresía de grupo:*** - Actualice los grupos de los que un usuario de VergeOS es miembro. (Se requiere un Alcance de grupo para que esto funcione.)

19. **Campos opcionales adicionales:** Vea [**Fuentes de autorización (general)**](https://docs.verge.io/run-the-platform/es/autenticacion/auth-sources-general.md) para obtener información sobre campos opcionales adicionales.

## Agregar grupos de Azure a VergeOS

La interacción con grupos de Azure requiere un token en el registro de la aplicación de Entra ID y la creación de grupos en VergeOS:

### Configure una configuración de token en Entra ID

1. Navegue a la **página de registro de la aplicación** de la aplicación creada arriba.
2. Haga clic en **Configuración del token** en el menú de la izquierda y haga clic en **+Agregar reclamo de grupos**.
3. Marque los **tipos de grupo**.
4. Establezca **ID, Acceso y SAML en sAMAccountName**.

![azure-editgroupsclaim.pn](https://1206374132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-24b1f0220d3e8fb693bfde10d1a6b8bc186f1012%2Fazure-editgroupsclaim.png?alt=media)

### Pasos para agregar grupos de Azure

1. Navegue a **Sistema > Grupos.**
2. Haga clic en **Nuevo** en el menú de la izquierda.
3. Ingrese el grupo ***Nombre*** para que coincida con el nombre del grupo en Entra ID.
4. Opcionalmente, se puede ingresar un ***Correo electrónico*** para el grupo. Esta dirección de correo electrónico se usa para enviar alertas de suscripción y/o informes asignados al grupo.
5. Copie el **Id. de objeto** correspondiente de la página Grupos/Todos los grupos en Entra ID al campo ***Identificador*** .
6. Haga clic en **Enviar** (parte inferior de la página) para guardar el nuevo grupo.

![azure-groupspage.png](https://1206374132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-82bed5065e0cf17ab7b46e6fd3b73037e16cfc40%2Fazure-groupspage.png?alt=media)

![azure-creategroup.png](https://1206374132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-df56aab13c11b1297fa9c58d855f1404cd45c165%2Fazure-creategroup.png?alt=media)

## Agregar manualmente usuarios de Azure

Después de crear la fuente de autenticación de Azure, los usuarios pueden crearse manualmente en VergeOS para utilizar la fuente de autorización para la autenticación de inicio de sesión. Crear usuarios manualmente solo es necesario cuando los usuarios no están configurados para crearse automáticamente.

### Agregar usuarios de VergeOS que usarán la autenticación de Entra ID

Al crear el nuevo usuario, use la siguiente configuración:

* ***Fuente de autorización:*** Seleccione la fuente de Entra ID de la lista desplegable
* ***Nombre de usuario:*** nombre único dentro del sistema VergeOS; normalmente se recomienda usar el nombre principal de Azure.
* ***Nombre de usuario remoto:*** use el valor de uno de los campos definidos como *campos de usuario remoto* estos son campos que se buscan en Azure (por ejemplo, nombre de usuario, correo electrónico)
* ***Nombre para mostrar:*** (opcional) Si *Actualizar nombre para mostrar del usuario* está habilitado en la fuente de autenticación de Entra ID, el nombre para mostrar se sincronizará automáticamente desde Entra ID.
* ***Dirección de correo electrónico:*** (opcional) Si *Actualizar dirección de correo electrónico del usuario* está habilitado en la fuente de autenticación de Entra ID, la dirección de correo electrónico se sincronizará automáticamente desde Entra ID.

![azure-newuser.png](https://1206374132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-542e4c78a054f2f87e170465de77547161eb9ae2%2Fazure-newuser.png?alt=media)


---

# 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.verge.io/run-the-platform/es/autenticacion/azure-auth.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.
