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

# Iru (anteriormente Kandji)

Emita certificados no Iru ligando o SCEPman como uma CA externa.

O SCEPman pode ser ligado ao [Iru](https://www.iru.com/) como uma CA externa com uma palavra-passe de desafio, permitindo que os dispositivos inscritos obtenham certificados.

Para obter informações mais gerais sobre outras soluções MDM e a integração com o SCEPman, consulte [aqui](https://docs.scepman.com/pt/gestao-de-certificados/static-certificates.md).

{% stepper %}
{% step %}

### Ativar a integração com o Iru

A integração do SCEPman pode ser facilmente ativada através das seguintes variáveis de ambiente no App Service do SCEPman:

{% hint style="success" %}
Se a sincronização do Iru com o Entra estiver ativada, use [Validação estática-AAD](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/staticaad-validation.md). Associa os certificados a objetos do Entra e suporta a revogação automática quando esses objetos são desativados ou eliminados.

Use a validação estática apenas quando a sincronização com o Entra não estiver disponível. Configure o ponto final selecionado em [Outras soluções MDM](https://docs.scepman.com/pt/gestao-de-certificados/static-certificates.md#choose-an-endpoint).
{% endhint %}

{% hint style="info" %}
Pode distinguir o App Service do SCEPman do Certificate Master procurando o App Service **sem** o «-cm» no nome
{% endhint %}

<details>

<summary>Validação Static-AAD</summary>

Use estas definições quando a sincronização do Iru com o Entra estiver ativada.

Utilize os nomes das definições correspondentes ao sistema operativo do seu App Service.

{% tabs %}
{% tab title="Linux" %}
Os App Services do Linux utilizam dois sublinhados (`__`) em vez de dois-pontos.

| Definição                                                                                                                                                                                                                                         | Descrição                                                                    | Valor                                          |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------- |
| [AppConfig\_\_StaticAADValidation\_\_Enabled](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-enabled)                                              | Ativar a validação associada ao Entra                                        | **true** para ativar, **false** para desativar |
| [AppConfig\_\_StaticAADValidation\_\_RequestPassword](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-requestpassword)                              | Autentica pedidos de certificados. Armazene este segredo no Azure Key Vault. | Gere uma palavra-passe de 32 caracteres        |
| [AppConfig\_\_StaticAADValidation\_\_ValidityPeriodDays](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-validityperioddays) (opcional)             | Validade do certificado em dias                                              | 365                                            |
| [AppConfig\_\_StaticAADValidation\_\_EnableCertificateStorage](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-enablecertificatestorage) (opcional) | Armazene os certificados emitidos e ative a revogação automática             | **true**                                       |
| {% endtab %}                                                                                                                                                                                                                                      |                                                                              |                                                |

{% tab title="Windows" %}
Os App Services do Windows utilizam dois-pontos (`:`) nos nomes das definições.

| Definição                                                                                                                                                                                                                                   | Descrição                                                                    | Valor                                          |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ---------------------------------------------- |
| [AppConfig:StaticAADValidation:Enabled](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-enabled)                                              | Ativar a validação associada ao Entra                                        | **true** para ativar, **false** para desativar |
| [AppConfig:StaticAADValidation:RequestPassword](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-requestpassword)                              | Autentica pedidos de certificados. Armazene este segredo no Azure Key Vault. | Gere uma palavra-passe de 32 caracteres        |
| [AppConfig:StaticAADValidation:ValidityPeriodDays](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-validityperioddays) (opcional)             | Validade do certificado em dias                                              | 365                                            |
| [AppConfig:StaticAADValidation:EnableCertificateStorage](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-enablecertificatestorage) (opcional) | Armazene os certificados emitidos e ative a revogação automática             | **true**                                       |
| {% endtab %}                                                                                                                                                                                                                                |                                                                              |                                                |
| {% endtabs %}                                                                                                                                                                                                                               |                                                                              |                                                |

</details>

<details>

<summary>Validação Static</summary>

Use estas definições quando a sincronização do Iru com o Entra não estiver disponível.

Utilize os nomes de definição correspondentes ao sistema operativo do seu Serviço de Aplicações.

{% tabs %}
{% tab title="Linux" %}
Os Serviços de Aplicações Linux utilizam dois sinais de sublinhado (`__`) em vez de dois pontos.

|                                                                                                                 Definição                                                                                                                | Descrição                                                                                                                                                                                                                                                                                                                                                   |                        Valor                       |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------: |
|                        [AppConfig\_\_StaticValidation\_\_Enabled](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enabled)                       | Ativar validação de terceiros                                                                                                                                                                                                                                                                                                                               | ***true*** para ativar, ***false*** para desativar |
|                [AppConfig\_\_StaticValidation\_\_RequestPassword](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-requestpassword)               | <p>Os pedidos de assinatura de certificado enviados ao SCEPman para assinatura são autenticados com esta palavra-passe estática segura<br><br><strong>Recomendação</strong>: Armazene este segredo no <a href="https://docs.scepman.com/pt/configuracao-do-scepman/application-settings.md#secure-configuration-in-azure-key-vault">Azure KeyVault</a>.</p> |      *gere uma palavra-passe de 32 caracteres*     |
|       [AppConfig\_\_StaticValidation\_\_ValidityPeriodDays](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-validityperioddays) (opcional)       | Número de dias de validade dos certificados emitidos através do Iru                                                                                                                                                                                                                                                                                         |                         365                        |
| [AppConfig\_\_StaticValidation\_\_EnableCertificateStorage](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enablecertificatestorage) (opcional) | Armazene os certificados pedidos na Storage Account para que sejam apresentados no SCEPman Certificate Master                                                                                                                                                                                                                                               | ***true*** para ativar, ***false** para desativar* |
|                                                                                                               {% endtab %}                                                                                                               |                                                                                                                                                                                                                                                                                                                                                             |                                                    |

{% tab title="Windows" %}
Os Serviços de Aplicações Windows utilizam dois pontos (`:`) nos nomes das definições.

|                                                                                                              Definição                                                                                                             | Descrição                                                                                                                                                                                                                                                                                                                                                   |                        Valor                       |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------: |
|                        [AppConfig:StaticValidation:Enabled](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enabled)                       | Ativar validação de terceiros                                                                                                                                                                                                                                                                                                                               | ***true*** para ativar, ***false*** para desativar |
|                [AppConfig:StaticValidation:RequestPassword](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-requestpassword)               | <p>Os pedidos de assinatura de certificado enviados ao SCEPman para assinatura são autenticados com esta palavra-passe estática segura<br><br><strong>Recomendação</strong>: Armazene este segredo no <a href="https://docs.scepman.com/pt/configuracao-do-scepman/application-settings.md#secure-configuration-in-azure-key-vault">Azure KeyVault</a>.</p> |      *gere uma palavra-passe de 32 caracteres*     |
|       [AppConfig:StaticValidation:ValidityPeriodDays](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-validityperioddays) (opcional)       | Número de dias de validade dos certificados emitidos através do Iru                                                                                                                                                                                                                                                                                         |                         365                        |
| [AppConfig:StaticValidation:EnableCertificateStorage](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enablecertificatestorage) (opcional) | Armazene os certificados pedidos na Storage Account para que sejam apresentados no SCEPman Certificate Master                                                                                                                                                                                                                                               | ***true*** para ativar, ***false** para desativar* |
|                                                                                                            {% endtab %}                                                                                                            |                                                                                                                                                                                                                                                                                                                                                             |                                                    |
|                                                                                                            {% endtabs %}                                                                                                           |                                                                                                                                                                                                                                                                                                                                                             |                                                    |

</details>

{% hint style="warning" %}
Depois de adicionar ou editar os parâmetros de configuração do SCEPman, tem de reiniciar o App Service.
{% endhint %}
{% endstep %}

{% step %}

### Implementar o certificado raiz do SCEPman

Como primeiro passo, tem de implementar o certificado raiz do SCEPman. Transfira este certificado de CA através do site do SCEPman:

![Site do SCEPman](https://3802289327-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)

No Iru, aceda a **Biblioteca** na barra de navegação à esquerda e adicione um **item da biblioteca de certificados** ao seu Blueprint.

<figure><img src="https://3802289327-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 um payload de certificado</p></figcaption></figure>

Para carregar o certificado, primeiro selecione **certificado formatado em PKCS #1** em **Tipo de certificado**, depois forneça um nome opcional, carregue o certificado de CA do SCEPman e, por fim, guarde-o.

<figure><img src="https://3802289327-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>Adicionar o certificado da CA raiz do SCEPman</p></figcaption></figure>
{% endstep %}

{% step %}

### Criar o perfil SCEP

O segundo passo consiste em adicionar um **Perfil SCEP** ao seu **Blueprint**. Por isso, adicione um novo **Item da biblioteca SCEP** e configure-o conforme indicado abaixo:

* **URL**: utilize o endpoint SCEP correspondente ao método de validação selecionado. Utilize `/static/aad` para a validação Static-AAD ou `/static` para a validação Static.
* **Nome:** Um atributo SAN opcional
* **Desafio**: é necessário para autenticar pedidos CSR. Tem de corresponder à palavra-passe do pedido configurada para [Validação estática-AAD](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-requestpassword) ou [Validação estática](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-requestpassword).
* **Impressão digital:** Impressão digital opcional da CA. Recomendamos vivamente que configure este valor, pois proporciona um nível adicional de segurança. Pode encontrá-lo no seu site SCEPman como **Impressão digital da CA**.
* **Assunto:** Nome do assunto opcional. **CN=$PROFILE\_UUID** será adicionado automaticamente pelo Iru como nome comum predefinido. O Iru permite adicionar vários CNs.

{% hint style="info" %}
A validação Static-AAD requer que o assunto do certificado inclua um ID de dispositivo Entra ou que o respetivo SAN inclua o UPN de um utilizador.
{% endhint %}

{% hint style="warning" %}
Ocasionalmente, o macOS e o iOS apresentavam problemas na seleção automática de certificados de cliente para autenticação de rede quando eram adicionados mais de dois CNs.
{% endhint %}

* **Tamanho da chave:** 2048
* **Utilização da chave:** Assinatura e encriptação

Para obter mais informações, consulte [a documentação do Iru](https://support.kandji.io/support/solutions/articles/72000559782-scep-profile).

<figure><img src="https://3802289327-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>Adicionar um perfil SCEP</p></figcaption></figure>

<figure><img src="https://3802289327-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>Configuração do perfil SCEP</p></figcaption></figure>

<figure><img src="https://3802289327-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>Configuração do perfil SCEP</p></figcaption></figure>

<figure><img src="https://3802289327-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>Configuração do perfil SCEP</p></figcaption></figure>
{% endstep %}

{% step %}

### Verificar o estado da implementação

Depois de guardar o certificado ou o perfil SCEP, aceda a **Estado** para verificar o estado da implementação nos **Blueprints** dispositivos atribuídos.

<figure><img src="https://3802289327-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 da implementação</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/pt/gestao-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.
