> 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/addigy.md).

# Addigy

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

O SCEPman pode ser integrado com [Addigy](https://addigy.com/) como uma Autoridade de Certificação (CA) externa. Com uma palavra-passe de desafio configurada, os dispositivos inscritos podem solicitar e obter 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 Addigy

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

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

Utilize a validação estática apenas quando a sincronização com o Entra não estiver disponível. Configure o endpoint 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 serviço de aplicações do SCEPman do Certificate Master procurando o serviço de aplicações **sem** o "-cm" no nome
{% endhint %}

<details>

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

Utilize estas definições quando a sincronização Addigy 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>

Utilize estas definições quando a sincronização Addigy 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 certificados enviados ao SCEPman 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)       | Validade, em dias, dos certificados emitidos através do Addigy                                                                                                                                                                                                                                                                               |                         365                        |
| [AppConfig\_\_StaticValidation\_\_EnableCertificateStorage](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enablecertificatestorage) (opcional) | Armazenar os certificados solicitados na Storage Account, para os apresentar 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 certificados enviados ao SCEPman 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)       | Validade, em dias, dos certificados emitidos através do Addigy                                                                                                                                                                                                                                                                               |                         365                        |
| [AppConfig:StaticValidation:EnableCertificateStorage](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enablecertificatestorage) (opcional) | Armazenar os certificados solicitados na Storage Account, para os apresentar no SCEPman Certificate Master                                                                                                                                                                                                                                   | ***true*** para ativar, ***false** para desativar* |
|                                                                                                            {% endtab %}                                                                                                            |                                                                                                                                                                                                                                                                                                                                              |                                                    |
|                                                                                                            {% endtabs %}                                                                                                           |                                                                                                                                                                                                                                                                                                                                              |                                                    |

</details>

{% hint style="warning" %}
Depois de adicionar ou editar 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, é necessário implementar o certificado raiz do SCEPman. Para isso, transfira o certificado RootCA 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)

Agora, converta o certificado raiz .cer para o formato PEM para o poder carregar no Addigy. Pode utilizar o seguinte comando OpenSSL para o fazer:

```
openssl x509 -inform der -in scepman-root.cer -out SCEPman-Root-Certificate.pem
```

No Addigy, navegue até **Perfis** e criar um novo perfil MDM, escolha **Certificados - (PKCS12)** como Tipo de perfil para carregar o SCEPman RootCA e carregue o ficheiro no formato PEM.

<figure><img src="https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FRAcvBOaWt0V089lb96aP%2Fimage.png?alt=media&amp;token=187ce30f-6f6f-4ae0-9b97-cb21713b585b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Criar o perfil SCEP

O segundo passo consiste em criar um novo **Perfil SCEP** para implementar certificados de dispositivo, conforme apresentado abaixo:

* **Nome do payload:** Escolha um nome para o perfil; este será apresentado no cliente como um perfil de certificado.
* **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. Pode copiar o URL da página inicial do SCEPman.

<figure><img src="https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FZHNTUBLUO3y3BHH0R37X%2Fimage.png?alt=media&amp;token=a4b0d735-167d-41ea-aa32-2c445325a42b" alt=""><figcaption></figcaption></figure>

* **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).

{% 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 %}

* Ative a **"Pedidos SCEP por proxy"** opção
* Selecione «Assinatura e encriptação» para **Utilização da chave**
* Preencha os restantes campos conforme mostrado nas capturas de ecrã abaixo

<figure><img src="https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FIRC4uYWrileRNfteYpIV%2Fimage.png?alt=media&amp;token=4b0f0c81-2c16-4b69-9143-5aed25a87477" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FpKRdVeJYOPm1TUd6c2AY%2Fimage.png?alt=media&amp;token=3b474821-967f-4b6e-968e-812a66d9edde" alt=""><figcaption></figcaption></figure>

Depois de criar com êxito os perfis da AC raiz e do certificado do dispositivo, aplique-os à sua política para implementar a configuração nos dispositivos atribuídos.

Para obter mais informações, consulte [a documentação da Addigy.](https://support.addigy.com/hc/en-us/articles/4403542430739-Deploying-Certificates)
{% 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/addigy.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.
