> For the complete documentation index, see [llms.txt](https://docs.scepman.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scepman.com/es/despliegue-de-scepman/deployment-guides/scenarios/certificate-based-authentication-for-entra-id.md).

# Autenticación basada en certificados para Entra ID

La autenticación basada en certificados ofrece una sólida alternativa de seguridad para acceder a los recursos de Entra ID. Este artículo ofrece un recorrido sobre cómo configurar este método, utilizando SCEPman como la Autoridad de certificación para simplificar la gestión de certificados.

## Habilitar la CRL de SCEPman

{% content-ref url="/pages/92baba2732a23e632bf3c4aac6f37ee4777cbf20" %}
[Habilitar CRL](https://docs.scepman.com/es/administracion-de-certificados/manage-certificates/enabling-crl.md)
{% endcontent-ref %}

Entra ID requerirá una CRL para validar los certificados. Asegúrate de establecer las siguientes variables de entorno en tu servicio de aplicaciones para que la CRL esté disponible:

[AppConfig:CRL:RequestToken](https://docs.scepman.com/scepman-configuration/application-settings/crl#appconfig-crl-requesttoken)

Establécelo en una cadena personalizada que se usará en la URL para permitir la descarga de la CRL.

[AppConfig:CRL:Source](https://docs.scepman.com/scepman-configuration/application-settings/crl#appconfig-crl-source)

Esta es la fuente a partir de la cual SCEPman genera la CRL. Asegúrate de que esté establecido en `Almacenamiento`

## Configurar Entra ID

{% stepper %}
{% step %}

### Crear PKI en Entra Security Center

En Entra ID, navega a **Protección** > **Centro de seguridad** > [**Infraestructura de clave pública**](https://entra.microsoft.com/#view/Microsoft_AAD_IAM/SecurityMenuBlade/~/PublicKeyInfrastructure/menuId/SecurityCenter/fromNav/)**,** haz clic en *Crear PKI* y selecciona un nombre para mostrar coincidente.
{% endstep %}

{% step %}

### Agregar Autoridad de Certificación

Ve a la PKI recién creada y haz clic en *Agregar autoridad de certificación* para cargar el certificado de CA de tu instancia de SCEPman. Este certificado puede obtenerse desde su página principal en el menú del lado derecho (*Obtener certificado de CA*).

Para la URL de la lista de revocación de certificados, puedes introducir la URL con el siguiente formato:

```
https://scepman.contoso.com/crl/pem/{YourCrlRequestToken}
```

{% hint style="warning" %}
Asegúrate de incluir la `/pem/` ruta en tu URL, ya que Entra podría tener problemas de compatibilidad al usar el formato DER predeterminado.
{% endhint %}

Esto debería dejarte ahora con una autoridad de certificación similar a la siguiente:

<figure><img src="https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FJ8NIUb0d7eyJ6VLQboOr%2Fimage.png?alt=media&amp;token=9db3a6e0-f62a-4b5d-9225-3fd9df3d00cd" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Habilitar CBA en Métodos de autenticación

Con la CA en su lugar, podemos continuar y habilitar la autenticación basada en certificados en **Protección** > **Métodos de autenticación** > [**Políticas**](https://entra.microsoft.com/#view/Microsoft_AAD_IAM/AuthenticationMethodsMenuBlade/~/AdminAuthMethods/fromNav/)

Ve a la *autenticación basada en certificados* política, actívala y permite que todos los usuarios o grupos específicos usen este método:

![](https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FA5JQWoky2wn9xy7BK384%2Fimage.png?alt=media\&token=be93a02a-0a8d-4e54-a816-d003d6b05c41)
{% endstep %}

{% step %}

### Configurar la autenticación basada en certificados

Cambia a la *Configurar* pestaña y revisa las opciones:

**Requerir validación de CRL**: ✅

Esta es una parte esencial de la seguridad que proporciona este método, ya que la CRL indicará a Entra ID qué certificados han sido revocados y, por lo tanto, no deberán permitirse para la autenticación.

**Pistas del emisor** : ✅

Al habilitar las pistas del emisor, solo se mostrarán durante la autenticación los certificados emitidos por la CA configurada.

Deja la configuración predeterminada para el enlace de autenticación y continúa para crear una regla que permita la autoridad de certificación creada anteriormente:

<figure><img src="https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FE8UtFEErL3Into71bGui%2Fimage.png?alt=media&amp;token=17f860ed-2f4d-492d-b574-dd56f7cff9b4" alt=""><figcaption></figcaption></figure>

**Fuerza de autenticación**:

Esto define el peso de la autenticación al usar esta CA. Si seleccionas *autenticación de un solo factor*, otro método de autenticación puede ser necesario dependiendo de la aplicación a la que se acceda.

**Vinculación de afinidad**:

La vinculación de afinidad define los detalles requeridos en el certificado, que deben coincidir con los datos correspondientes en el objeto de usuario para que se permita la autenticación. Como actualmente SCEPman no puede agregar ninguna información de certificado en el objeto de usuario, recomendamos establecer esto en **Bajo** a menos que configures la información requerida manualmente.

{% hint style="warning" %}
La intensidad de autenticación y la configuración de la vinculación de afinidad dependen en gran medida del caso de uso específico y del tipo de cuentas que quieras proteger con este método de autenticación. Si quieres proteger usuarios con privilegios muy altos, deberías considerar añadir manualmente la información del certificado en sus cuentas de usuario para lograr una alta afinidad.
{% endhint %}
{% endstep %}
{% endstepper %}

## Uso

Con la configuración en su lugar, un usuario puede seleccionar *Usar un certificado o tarjeta inteligente*:

<figure><img src="https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FadOI8hZm2kOoKAOvi0vq%2Fimage.png?alt=media&amp;token=bba5bfbd-6577-48b6-adc7-66a49edbdf35" alt=""><figcaption></figcaption></figure>

Lo que a su vez solicitará el certificado que se usará para la autenticación.

<figure><img src="https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FsNh5rtPY52gnNZCkq9X4%2Fimage.png?alt=media&amp;token=85568bc1-3daa-4691-827d-f002b0701bf2" alt=""><figcaption></figcaption></figure>

## Agregar manualmente la asignación de certificados para una vinculación de alta afinidad

Si quieres habilitar CBA usando solo la vinculación de alta afinidad, puedes introducir manualmente los detalles del certificado en la información autorizada del usuario.

Ve a las propiedades de los usuarios en Entra ID, edítalas y ahora edita los **IDs de usuario del certificado**:

<figure><img src="https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FyGzQlmHC4nv6yzEKBwZG%2Fimage.png?alt=media&amp;token=9ab1a272-df75-46c0-b2ca-51c18420e823" alt=""><figcaption></figcaption></figure>

El formato requerido de estos IDs depende de los campos que se hayan configurado en la vinculación de usuario de los métodos de autenticación. Puede encontrarse una lista de formatos en la correspondiente [documentación de Microsoft](https://learn.microsoft.com/en-us/entra/identity/authentication/concept-certificate-based-authentication-certificateuserids#supported-patterns-for-certificate-user-ids).

Ejemplo para la *SHA1PublicKey* vinculación:

```
X509:<SHA1-PUKEY>9600e49d740011187e5c734bab4a3d5d18d2a87a
```

Esto utiliza la huella digital del certificado para vincular de forma sólida la identidad del usuario.


---

# 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.scepman.com/es/despliegue-de-scepman/deployment-guides/scenarios/certificate-based-authentication-for-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.
