> 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/administracion-de-certificados/static-certificates/kandji-1.md).

# Iru (anteriormente Kandji)

Emite certificados en Iru conectando SCEPman como CA externa.

SCEPman se puede conectar a [Iru](https://www.iru.com/) como CA externa con una contraseña de desafío, lo que permite que los dispositivos inscritos obtengan certificados.

Para obtener información más general sobre otras soluciones MDM y la integración con SCEPman, consulta [aquí](https://docs.scepman.com/es/administracion-de-certificados/static-certificates.md).

{% stepper %}
{% step %}

### Habilitar la integración con Iru

La integración de SCEPman se puede habilitar fácilmente mediante las siguientes variables de entorno en SCEPman App Service:

{% hint style="success" %}
Si la sincronización de Iru con Entra está habilitada, usa [Validación estática de AAD](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/staticaad-validation.md). Esto vincula los certificados a objetos de Entra y admite la revocación automática cuando esos objetos se deshabilitan o eliminan.

Usa la validación estática solo cuando la sincronización con Entra no esté disponible. Configura el punto de conexión seleccionado en [Otras soluciones MDM](https://docs.scepman.com/es/administracion-de-certificados/static-certificates.md#choose-an-endpoint).
{% endhint %}

{% hint style="info" %}
Puedes distinguir entre SCEPman App Service y Certificate Master buscando el App Service **sin** el «-cm» en su nombre
{% endhint %}

<details>

<summary>Validación de Static-AAD</summary>

Usa estos ajustes cuando la sincronización de Iru con Entra esté habilitada.

Usa los nombres de configuración correspondientes al sistema operativo de tu App Service.

{% tabs %}
{% tab title="Linux" %}
Los App Services de Linux usan dobles guiones bajos (`__`) en lugar de dos puntos.

| Configuración                                                                                                                                                                                                                                      | Descripción                                                                        | Valor                                                    |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------- |
| [AppConfig\_\_StaticAADValidation\_\_Enabled](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-enabled)                                              | Habilitar la validación vinculada a Entra                                          | **true** para habilitarla, **false** para deshabilitarla |
| [AppConfig\_\_StaticAADValidation\_\_RequestPassword](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-requestpassword)                              | Autentica las solicitudes de certificados. Guarda este secreto en Azure Key Vault. | Genera una contraseña de 32 caracteres                   |
| [AppConfig\_\_StaticAADValidation\_\_ValidityPeriodDays](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-validityperioddays) (opcional)             | Validez del certificado en días                                                    | 365                                                      |
| [AppConfig\_\_StaticAADValidation\_\_EnableCertificateStorage](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-enablecertificatestorage) (opcional) | Almacena los certificados emitidos y habilita la revocación automática             | **true**                                                 |
| {% endtab %}                                                                                                                                                                                                                                       |                                                                                    |                                                          |

{% tab title="Windows" %}
Los App Services de Windows usan dos puntos (`:`) en los nombres de configuración.

| Configuración                                                                                                                                                                                                                                | Descripción                                                                        | Valor                                                    |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------- |
| [AppConfig:StaticAADValidation:Enabled](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-enabled)                                              | Habilitar la validación vinculada a Entra                                          | **true** para habilitarla, **false** para deshabilitarla |
| [AppConfig:StaticAADValidation:RequestPassword](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-requestpassword)                              | Autentica las solicitudes de certificados. Guarda este secreto en Azure Key Vault. | Genera una contraseña de 32 caracteres                   |
| [AppConfig:StaticAADValidation:ValidityPeriodDays](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-validityperioddays) (opcional)             | Validez del certificado en días                                                    | 365                                                      |
| [AppConfig:StaticAADValidation:EnableCertificateStorage](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-enablecertificatestorage) (opcional) | Almacena los certificados emitidos y habilita la revocación automática             | **true**                                                 |
| {% endtab %}                                                                                                                                                                                                                                 |                                                                                    |                                                          |
| {% endtabs %}                                                                                                                                                                                                                                |                                                                                    |                                                          |

</details>

<details>

<summary>Validación de Static</summary>

Usa estos ajustes cuando la sincronización de Iru con Entra no esté disponible.

Utiliza los nombres de configuración correspondientes al sistema operativo de tu servicio de aplicaciones.

{% tabs %}
{% tab title="Linux" %}
Los servicios de aplicaciones de Linux utilizan dos guiones bajos consecutivos (`__`) en lugar de dos puntos.

|                                                                                                               Configuración                                                                                                               | Descripción                                                                                                                                                                                                                                                                                                                                         |                             Valor                            |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------: |
|                        [AppConfig\_\_StaticValidation\_\_Enabled](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enabled)                       | Habilitar la validación de terceros                                                                                                                                                                                                                                                                                                                 | ***true*** para habilitarla, ***false*** para deshabilitarla |
|                [AppConfig\_\_StaticValidation\_\_RequestPassword](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-requestpassword)               | <p>Las solicitudes de firma de certificados enviadas a SCEPman para su firma se autentican con esta contraseña estática segura<br><br><strong>Recomendación</strong>: Guarda este secreto en <a href="https://docs.scepman.com/es/configuracion-de-scepman/application-settings.md#secure-configuration-in-azure-key-vault">Azure KeyVault</a>.</p> |           *genera una contraseña de 32 caracteres*           |
|       [AppConfig\_\_StaticValidation\_\_ValidityPeriodDays](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-validityperioddays) (opcional)       | Número de días de validez de los certificados emitidos mediante Iru                                                                                                                                                                                                                                                                                 |                              365                             |
| [AppConfig\_\_StaticValidation\_\_EnableCertificateStorage](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enablecertificatestorage) (opcional) | Almacena los certificados solicitados en Storage Account para que aparezcan en SCEPman Certificate Master                                                                                                                                                                                                                                           | ***true*** para habilitarla, ***false** para deshabilitarla* |
|                                                                                                                {% endtab %}                                                                                                               |                                                                                                                                                                                                                                                                                                                                                     |                                                              |

{% tab title="Windows" %}
Los servicios de aplicaciones de Windows utilizan dos puntos (`:`) en los nombres de configuración.

|                                                                                                            Configuración                                                                                                            | Descripción                                                                                                                                                                                                                                                                                                                                         |                             Valor                            |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------: |
|                        [AppConfig:StaticValidation:Enabled](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enabled)                       | Habilitar la validación de terceros                                                                                                                                                                                                                                                                                                                 | ***true*** para habilitarla, ***false*** para deshabilitarla |
|                [AppConfig:StaticValidation:RequestPassword](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-requestpassword)               | <p>Las solicitudes de firma de certificados enviadas a SCEPman para su firma se autentican con esta contraseña estática segura<br><br><strong>Recomendación</strong>: Guarda este secreto en <a href="https://docs.scepman.com/es/configuracion-de-scepman/application-settings.md#secure-configuration-in-azure-key-vault">Azure KeyVault</a>.</p> |           *genera una contraseña de 32 caracteres*           |
|       [AppConfig:StaticValidation:ValidityPeriodDays](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-validityperioddays) (opcional)       | Número de días de validez de los certificados emitidos mediante Iru                                                                                                                                                                                                                                                                                 |                              365                             |
| [AppConfig:StaticValidation:EnableCertificateStorage](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enablecertificatestorage) (opcional) | Almacena los certificados solicitados en Storage Account para que aparezcan en SCEPman Certificate Master                                                                                                                                                                                                                                           | ***true*** para habilitarla, ***false** para deshabilitarla* |
|                                                                                                             {% endtab %}                                                                                                            |                                                                                                                                                                                                                                                                                                                                                     |                                                              |
|                                                                                                            {% endtabs %}                                                                                                            |                                                                                                                                                                                                                                                                                                                                                     |                                                              |

</details>

{% hint style="warning" %}
Después de agregar o editar los parámetros de configuración de SCEPman, debes reiniciar App Service.
{% endhint %}
{% endstep %}

{% step %}

### Implementar el certificado raíz de SCEPman

Como primer paso, debes implementar el certificado raíz de SCEPman. Descarga este certificado de CA desde el sitio web de SCEPman:

![Sitio web de SCEPman](https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-9170eb0435726398eb43f6fac8abd0d5f35e8cc4%2FSCEPmanHomePage%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(2\)%20\(1\)%20\(2\).png?alt=media)

En Iru, ve a **Biblioteca** en la barra de navegación de la izquierda y agrega un **elemento de biblioteca de certificados** a tu Blueprint.

<figure><img src="https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FfToUgpoUeZOiYNe2xkzi%2F2023-03-09%2012_51_21-Window.png?alt=media&amp;token=df6f66fb-369b-4adf-ab9d-70757354f2f7" alt=""><figcaption><p>Configurar una carga de certificado</p></figcaption></figure>

Para cargar el certificado, primero selecciona **certificado con formato PKCS #1** en **Tipo de certificado**, luego proporciona un nombre opcional, carga el certificado de CA de SCEPman y, por último, guárdalo.

<figure><img src="https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FL8NyfsJR7x2v0j6ybS6g%2F2023-03-09%2014_21_12-KandjiSCEPmanRootCA.png?alt=media&amp;token=a70ff955-bbe2-4b49-9cf4-245964838675" alt=""><figcaption><p>Agregar el certificado de la CA raíz de SCEPman</p></figcaption></figure>
{% endstep %}

{% step %}

### Crear el perfil SCEP

El segundo paso consiste en agregar un **perfil SCEP** a tu **Blueprint**. Por lo tanto, agrega un nuevo **elemento de biblioteca SCEP** y configúralo de la siguiente manera:

* **URL**: Usa el endpoint SCEP que coincida con el método de validación seleccionado. Usa `/static/aad` para la validación Static-AAD, o `/static` para la validación Static.
* **Nombre:** Un atributo SAN opcional
* **Desafío**: Es necesario para autenticar las solicitudes CSR. Debe coincidir con la contraseña de solicitud configurada para [Validación estática de AAD](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-requestpassword) o [Validación estática](https://docs.scepman.com/es/configuracion-de-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-requestpassword).
* **Huella digital:** Huella digital de la CA opcional. Se recomienda encarecidamente configurar este valor, ya que proporciona un nivel adicional de seguridad. Puedes encontrarlo en el sitio web de SCEPman como **Huella digital de la CA**.
* **Asunto:** Nombre de asunto opcional. **CN=$PROFILE\_UUID** se agregará automáticamente desde Iru como nombre común predeterminado. Iru permite agregar varios CN.

{% hint style="info" %}
La validación Static-AAD requiere que el asunto del certificado incluya un ID de dispositivo de Entra, o que su SAN incluya el UPN de un usuario.
{% endhint %}

{% hint style="warning" %}
En ocasiones, macOS e iOS tenían problemas para seleccionar automáticamente certificados de cliente para la autenticación de red cuando se agregaban más de dos CN.
{% endhint %}

* **Tamaño de clave:** 2048
* **Uso de clave:** Firma y cifrado

Para obtener más información, consulta [la documentación de Iru](https://support.kandji.io/support/solutions/articles/72000559782-scep-profile).

<figure><img src="https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FS84P4c40cLu5H5NCeley%2F2023-03-09%2014_43_19-Kandji.png?alt=media&amp;token=45fdf5b6-6a31-4879-ba87-a7070e76e0c5" alt=""><figcaption><p>Agregar un perfil SCEP</p></figcaption></figure>

<figure><img src="https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FhnTLPcfOXlMpBNOh5Nph%2F2023-03-09%2014_50_23-Kandji.png?alt=media&amp;token=1ed96cb6-861a-4cb7-8511-22e1b0b48763" alt=""><figcaption><p>Configuración del perfil SCEP</p></figcaption></figure>

<figure><img src="https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FbZiDYnqsvxgh8a36zPl3%2F2023-03-09%2014_51_22-Kandji.png?alt=media&amp;token=d2e681dd-f50d-4043-a85a-46bd7396d810" alt=""><figcaption><p>Configuración del perfil SCEP</p></figcaption></figure>

<figure><img src="https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FuiSTD2BxR4utzJ0YACZS%2F2023-03-09%2014_52_52-Kandji.png?alt=media&amp;token=84aa9c64-7b38-4829-b337-cdde8549ab98" alt=""><figcaption><p>Configuración del perfil SCEP</p></figcaption></figure>
{% endstep %}

{% step %}

### Comprobar el estado de implementación

Después de guardar el certificado o el perfil SCEP, cambia a **Estado** para comprobar el estado de implementación en los dispositivos asignados a **Blueprints** .

<figure><img src="https://4115997120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FjchSJJzjqEDQxfX8K40s%2F2023-03-09%2015_12_40-Kandji.png?alt=media&amp;token=5b316771-d526-45cc-8ee5-dba4d751e39f" alt=""><figcaption><p>Estado de implementación</p></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# 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/administracion-de-certificados/static-certificates/kandji-1.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.
