> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zylon.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración con Microsoft Entra (SSO)

### Agregar una nueva aplicación para Zylon

El objetivo es obtener 3 valores que se utilizarán para configurar Zylon para poder iniciar sesión con una cuenta de Microsoft.

* `Application (client) ID`
* `Client Secret`

1. Primero necesitas iniciar sesión en el panel de consola [https://portal.azure.com/#home](https://portal.azure.com/#home)
2. Haz clic en `Microsoft Entra Id`

<img src="https://mintcdn.com/zylon/BXrLYrh44RWGgEbL/images/operator-manual/openid-images/microsoft/image.png?fit=max&auto=format&n=BXrLYrh44RWGgEbL&q=85&s=cd5a3a168800539d6a172d12b9a639c2" alt="image.png" width="2270" height="386" data-path="images/operator-manual/openid-images/microsoft/image.png" />

3. Registra una nueva aplicación. Haz clic en `App registrations` en el menú izquierdo.

<img src="https://mintcdn.com/zylon/bIRZmoPdFWuTOEQj/images/operator-manual/openid-images/microsoft/image_1.png?fit=max&auto=format&n=bIRZmoPdFWuTOEQj&q=85&s=b39240470fa532c148d5a2d7044d4e00" alt="image.png" width="2366" height="1076" data-path="images/operator-manual/openid-images/microsoft/image_1.png" />

4. Haz clic en `New Registration`.

<img src="https://mintcdn.com/zylon/bIRZmoPdFWuTOEQj/images/operator-manual/openid-images/microsoft/image_2.png?fit=max&auto=format&n=bIRZmoPdFWuTOEQj&q=85&s=c0802132759a745e16d35c368d473837" alt="image.png" width="2422" height="904" data-path="images/operator-manual/openid-images/microsoft/image_2.png" />

1. Se abrirá una nueva ventana y necesitarás agregar la siguiente información

* ⚠️ El tipo de Redirect URI es **web**⚠️
* Dominio: `https://zylon.company.com/api/v1/auth/microsoft/callback`. Reemplaza `zylon.company.com` con el dominio donde está alojado Zylon (Es el mismo dominio que en el archivo de configuración ubicado en `/etc/zylon/zylon-conf.yaml`).
* Tipos de cuenta admitidos: Se admiten todos los tipos de cuenta. Elige según tus necesidades específicas.

<img src="https://mintcdn.com/zylon/bIRZmoPdFWuTOEQj/images/operator-manual/openid-images/microsoft/image_3.png?fit=max&auto=format&n=bIRZmoPdFWuTOEQj&q=85&s=c05fc3ea6500ec894aa29bba0c1f39bb" alt="image.png" width="1890" height="1188" data-path="images/operator-manual/openid-images/microsoft/image_3.png" />

* En caso de que quieras cambiarlo más tarde, puedes hacerlo en `Application Overview`

<img src="https://mintcdn.com/zylon/bIRZmoPdFWuTOEQj/images/operator-manual/openid-images/microsoft/image_4.png?fit=max&auto=format&n=bIRZmoPdFWuTOEQj&q=85&s=8a45683409d3da704563900f8487e601" alt="image.png" width="2726" height="630" data-path="images/operator-manual/openid-images/microsoft/image_4.png" />

5. Guarda el siguiente valor que se usará más tarde en el archivo de configuración para Zylon.

* Application (client) ID

<img src="https://mintcdn.com/zylon/bIRZmoPdFWuTOEQj/images/operator-manual/openid-images/microsoft/image_5.png?fit=max&auto=format&n=bIRZmoPdFWuTOEQj&q=85&s=22e6f6ee68858bca69404fb6e365b52c" alt="image.png" width="2616" height="652" data-path="images/operator-manual/openid-images/microsoft/image_5.png" />

6. Ahora necesitamos generar el `ClientSecret`. Ve al menú izquierdo y haz clic en `Manage > Certificates & secrets`

<img src="https://mintcdn.com/zylon/bIRZmoPdFWuTOEQj/images/operator-manual/openid-images/microsoft/image_6.png?fit=max&auto=format&n=bIRZmoPdFWuTOEQj&q=85&s=c171e6123e85978a76430a13ea32a6a9" alt="image.png" width="50%" data-path="images/operator-manual/openid-images/microsoft/image_6.png" />

7. Haz clic en `New client secret` y agrega la información requerida

<img src="https://mintcdn.com/zylon/bIRZmoPdFWuTOEQj/images/operator-manual/openid-images/microsoft/image_7.png?fit=max&auto=format&n=bIRZmoPdFWuTOEQj&q=85&s=ede6d89d5c968411e21a1eecd09635cd" alt="image.png" width="2568" height="1520" data-path="images/operator-manual/openid-images/microsoft/image_7.png" />

8. Copia el `Value` del secreto del cliente.

<img src="https://mintcdn.com/zylon/bIRZmoPdFWuTOEQj/images/operator-manual/openid-images/microsoft/image_8.png?fit=max&auto=format&n=bIRZmoPdFWuTOEQj&q=85&s=8a216df83330c7711de9f9dd0a1e164f" alt="image.png" width="2120" height="586" data-path="images/operator-manual/openid-images/microsoft/image_8.png" />

9. Verifica que el permiso `User.read` esté concedido. Haz clic en `API Permissions` en el menú izquierdo. Deberías verlo allí por defecto. En caso de que falte, concédelo.

<img src="https://mintcdn.com/zylon/bIRZmoPdFWuTOEQj/images/operator-manual/openid-images/microsoft/image_9.png?fit=max&auto=format&n=bIRZmoPdFWuTOEQj&q=85&s=d59e4c567215bb167d30d6bc5ce888d0" alt="image.png" width="2778" height="1446" data-path="images/operator-manual/openid-images/microsoft/image_9.png" />

10. Agrega la siguiente configuración a `/etc/zylon/zylon-conf.yaml`

<Warn>
  El archivo de configuración es un archivo `.yaml` por lo que la sangría, espacios, punto y coma, comillas dobles son muy importantes
</Warn>

```yaml theme={null}
auth:
  microsoft:
    enabled: true
    redirectUri: "https://zylon.company.com/api/v1/auth/microsoft/callback"
    tenantId: "common"
    clientId: "8c7d......"
    clientSecret: ".RS8Q~....."
```

Ejecuta el siguiente comando para actualizar la configuración

```yaml theme={null}
sudo zylon-cli update
```

Ahora deberías ver el SSO de Microsoft Account

<Tip>
  En caso de que no veas el botón de Microsoft Account para iniciar sesión, limpia la caché del navegador.
</Tip>

### Cómo gestionar usuarios

Para limitar el número de usuarios que pueden iniciar sesión en Zylon, consulta el siguiente enlace, por defecto todos en el Directorio pueden acceder a Zylon y se les otorgará el rol `member`

[https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/what-is-access-management](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/what-is-access-management)