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

# Mosyle

Emita certificados no Mosyle ligando o SCEPman como uma AC externa. Os dispositivos poderão obter certificados usando a interface estática do SCEPman e uma palavra-passe de desafio inscrita.

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 Mosyle

A integração do Mosyle com o SCEPman pode ser facilmente ativada através das seguintes configurações da aplicação SCEPman:

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

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 a 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)          | Número de dias de validade dos certificados emitidos através do Mosyle                                                                                                                                                                                                                                                                       |                         365                        |
| [AppConfig\_\_StaticValidation\_\_EnableCertificateStorage](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-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 a 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)          | Número de dias de validade dos certificados emitidos através do Mosyle                                                                                                                                                                                                                                                                       |                         365                        |
| [AppConfig:StaticValidation:EnableCertificateStorage](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-enablecertificatestorage) (opcional) | Armazenar os certificados solicitados na Storage Account, para os apresentar no SCEPman Certificate Master                                                                                                                                                                                                                                   | ***true*** para ativar, ***false** para desativar* |
|                                                                                                               {% endtab %}                                                                                                               |                                                                                                                                                                                                                                                                                                                                              |                                                    |
|                                                                                                               {% endtabs %}                                                                                                              |                                                                                                                                                                                                                                                                                                                                              |                                                    |

{% hint style="info" %}
Depois de adicionar ou editar parâmetros de configuração do SCEPman, tem de reiniciar o serviço da aplicação.
{% endhint %}
{% endstep %}

{% step %}

### Implementar o certificado raiz do SCEPman

Como primeiro passo, tem de implementar o certificado raiz do SCEPman. Transfira este certificado de AC 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 Mosyle, aceda a Management e adicione "**Multi-Cert Profile**" como um novo tipo de perfil (se ainda não existir).

Agora **adicione um novo perfil,** escolha um nome para este perfil, por exemplo, SCEPman Root CA, e clique em **+ADD PROFILE** em Profile Name (veja a captura de ecrã abaixo)**,** e escolha «Add Certificate profile» na janela apresentada. Em seguida, selecione e carregue o certificado raiz do SCEPman que transferiu anteriormente, introduza SCEPman Root CA como Profile Name e clique em Save.

![Adicionar um perfil de AC raiz](https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-b1a87554a9fcd9fced251a856bd7976601fa834a%2F2022-07-25%2009_56_09-Glueckkanja%20GAB%20and%201%20more%20page%20-%20Work%20-%20Microsoft%E2%80%8B%20Edge.png?alt=media)

![Carregar AC raiz](https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-a87d5c4e48811609296cf9a99b2f5e43d9bd4c82%2F2022-07-25%2010_04_49-Window.png?alt=media)

Agora tem de atribuir este perfil aos seus dispositivos/utilizadores e, em seguida, clicar em Save

![Guardar o perfil da AC raiz](https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-9387a570f6fe9c4cd1447f31126b33ec41151706%2F2022-07-25%2010_07_23-Window.png?alt=media)

Depois de guardar, pode verificar o estado de conformidade clicando em «view details» no perfil

![Estado da distribuição do perfil](https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-ac4884821ea581415bcaea1afbffca4dc014c9ef%2F2022-07-25%2010_10_27-Window.png?alt=media)
{% endstep %}

{% step %}

### Implementar o certificado do dispositivo

Adicione um novo perfil e introduza um nome, por exemplo, SCEPman Device Certificate, **+ADD PROFILE,** agora escolha **SCEP Profile** e preencha os valores conforme indicado abaixo

![Configuração do perfil SCEP](https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-561c37170b07a41faf043cff9eded597746bd3ca%2F2022-07-25%2011_41_51.png?alt=media)

![Configuração do perfil SCEP](https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-ee60a06b623abe7b415b374fe4e8037db5900a20%2F2022-07-25%2011_29_43.png?alt=media)

**Profile Name:** escolha um nome para o seu perfil

**Server:** escolha URL

**URL:** cole o URL do SCEPman com **/static** no final, conforme indicado na captura de ecrã. Também pode copiar este valor da página inicial do SCEPman, junto a **Static MDM**

**Subject:** Cabe-lhe escolher as variáveis que pretende incluir no assunto. Pode escolher um ou vários nomes distintos relativos (RDN). NOTA: os RDN começam sempre com **/** por exemplo

`/CN=%DeviceName%` para o nome do dispositivo. No exemplo da captura de ecrã, adicionámos 3 RDN; também são permitidos vários CN. Pode consultar a lista de variáveis clicando em **View available variables** acima do campo.

**Nome alternativo do assunto** é opcional.

**Challenge:** adicione a palavra-passe de desafio com 32 caracteres configurada na configuração do SCEPman, [consulte «Ativar a integração com o Mosyle»](#enable-mosyle-integration)

**Key Size:** 2048

Ative as duas opções "**Usar para assinatura**" e "**Usar para encriptação**", e deixe todas as outras definições como predefinidas (como mostrado na captura de ecrã). Em seguida, **Guardar**

Agora, tem de atribuir este perfil aos seus dispositivos/utilizadores e, em seguida, **Guardar**.

Depois de guardar, pode verificar o estado de conformidade clicando em «view details» no perfil

![Estado da distribuição do perfil](https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-94ac69b5cffff379d7efdcfd91a35dae79d1a6b7%2F2022-07-25%2011_55_57-Window.png?alt=media)
{% 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/mosyle.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.
