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

# Configuração geral

Ligue o Jamf Pro ao SCEPman como autoridade de certificação externa.

Ligue o Jamf Pro ao SCEPman como CA externa. O Jamf Pro encaminha os pedidos SCEP dos utilizadores e dispositivos inscritos para o endpoint dedicado do SCEPman `/jamf` .

{% stepper %}
{% step %}

### Ativar o endpoint do Jamf

Defina estas definições da aplicação no **SCEPman App Service**. Não as defina no Certificate Master.

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

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

| Definição                                                                                                                                                                                                                          | Descrição                                                                                                                                                                                                                                                                                        | Exemplo                               |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------- |
| [AppConfig\_\_JamfValidation\_\_Enabled](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-enabled)                                              | Quer utilizar o SCEPman com o Jamf?                                                                                                                                                                                                                                                              | true                                  |
| [AppConfig\_\_JamfValidation\_\_RequestPassword](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-requestpassword)                              | <p>O Jamf autentica os pedidos de certificados no SCEPman com esta palavra-passe segura.</p><p>Considere adicioná-la como segredo no seu SCEPman <a href="https://docs.scepman.com/pt/configuracao-do-scepman/application-settings.md#secure-configuration-in-azure-key-vault">KeyVault</a>.</p> | máx. *palavra-passe de 32 caracteres* |
| [AppConfig\_\_JamfValidation\_\_ValidityPeriodDays](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-validityperioddays) (opcional)             | Durante, no máximo, quantos dias devem ser válidos os certificados emitidos através do Jamf?                                                                                                                                                                                                     | 365                                   |
| [AppConfig\_\_JamfValidation\_\_EnableCertificateStorage](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-enablecertificatestorage) (opcional) | Ative esta definição para guardar certificados do Jamf no Certificate Master                                                                                                                                                                                                                     | true ou false (predefinição)          |
| {% endtab %}                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                  |                                       |

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

| Definição                                                                                                                                                                                                                    | Descrição                                                                                                                                                                                                                                                                                        | Exemplo                               |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------- |
| [AppConfig:JamfValidation:Enabled](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-enabled)                                              | Quer utilizar o SCEPman com o Jamf?                                                                                                                                                                                                                                                              | true                                  |
| [AppConfig:JamfValidation:RequestPassword](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-requestpassword)                              | <p>O Jamf autentica os pedidos de certificados no SCEPman com esta palavra-passe segura.</p><p>Considere adicioná-la como segredo no seu SCEPman <a href="https://docs.scepman.com/pt/configuracao-do-scepman/application-settings.md#secure-configuration-in-azure-key-vault">KeyVault</a>.</p> | máx. *palavra-passe de 32 caracteres* |
| [AppConfig:JamfValidation:ValidityPeriodDays](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-validityperioddays) (opcional)             | Durante, no máximo, quantos dias devem ser válidos os certificados emitidos através do Jamf?                                                                                                                                                                                                     | 365                                   |
| [AppConfig:JamfValidation:EnableCertificateStorage](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-enablecertificatestorage) (opcional) | Ative esta definição para guardar certificados do Jamf no Certificate Master                                                                                                                                                                                                                     | true ou false (predefinição)          |
| {% endtab %}                                                                                                                                                                                                                 |                                                                                                                                                                                                                                                                                                  |                                       |
| {% endtabs %}                                                                                                                                                                                                                |                                                                                                                                                                                                                                                                                                  |                                       |
| {% endstep %}                                                                                                                                                                                                                |                                                                                                                                                                                                                                                                                                  |                                       |

{% step %}

### Configurar a ligação à API do Jamf

O SCEPman utiliza a API do Jamf para verificar o estado dos clientes inscritos. Isto permite a revogação quando os objetos do Jamf são eliminados.

[Consulte a documentação do Jamf](https://learn.jamf.com/en-US/bundle/jamf-pro-documentation-current/page/API_Roles_and_Clients.html) para saber como criar uma função e um cliente de API. O cliente de API tem de ter uma função com estas permissões:

* Ler dispositivos móveis
* Ler computadores
* Ler utilizador

Defina estas definições da aplicação no **SCEPman App Service**:

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

| Definição                                                                                                                                                                                       | Descrição                                                                                                                                                                                                                                                                       | Exemplo                                                                                                                                              |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| [AppConfig\_\_JamfValidation\_\_URL](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-url)                   | O URL da sua instância do Jamf                                                                                                                                                                                                                                                  | `https://contoso.jamfcloud.com`                                                                                                                      |
| [AppConfig\_\_JamfValidation\_\_ClientID](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-clientid)         | O identificador do cliente da API Jamf                                                                                                                                                                                                                                          | Consulte [ID de cliente Jamf](https://learn.jamf.com/en-US/bundle/jamf-pro-documentation-current/page/API_Roles_and_Clients.html#ariaid-title3)      |
| [AppConfig\_\_JamfValidation\_\_ClientSecret](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-clientsecret) | <p>O valor do segredo do cliente para a configuração do cliente da API.</p><p>Considere adicioná-la como segredo no seu SCEPman <a href="https://docs.scepman.com/pt/configuracao-do-scepman/application-settings.md#secure-configuration-in-azure-key-vault">KeyVault</a>.</p> | Consulte [Segredo do cliente Jamf](https://learn.jamf.com/en-US/bundle/jamf-pro-documentation-current/page/API_Roles_and_Clients.html#ariaid-title4) |
| {% endtab %}                                                                                                                                                                                    |                                                                                                                                                                                                                                                                                 |                                                                                                                                                      |

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

| Definição                                                                                                                                                                                 | Descrição                                                                                                                                                                                                                                                                       | Exemplo                                                                                                                                              |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| [AppConfig:JamfValidation:URL](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-url)                   | O URL da sua instância do Jamf                                                                                                                                                                                                                                                  | `https://contoso.jamfcloud.com`                                                                                                                      |
| [AppConfig:JamfValidation:ClientID](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-clientid)         | O identificador do cliente da API Jamf                                                                                                                                                                                                                                          | Consulte [ID de cliente Jamf](https://learn.jamf.com/en-US/bundle/jamf-pro-documentation-current/page/API_Roles_and_Clients.html#ariaid-title3)      |
| [AppConfig:JamfValidation:ClientSecret](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-clientsecret) | <p>O valor do segredo do cliente para a configuração do cliente da API.</p><p>Considere adicioná-la como segredo no seu SCEPman <a href="https://docs.scepman.com/pt/configuracao-do-scepman/application-settings.md#secure-configuration-in-azure-key-vault">KeyVault</a>.</p> | Consulte [Segredo do cliente Jamf](https://learn.jamf.com/en-US/bundle/jamf-pro-documentation-current/page/API_Roles_and_Clients.html#ariaid-title4) |
| {% endtab %}                                                                                                                                                                              |                                                                                                                                                                                                                                                                                 |                                                                                                                                                      |
| {% endtabs %}                                                                                                                                                                             |                                                                                                                                                                                                                                                                                 |                                                                                                                                                      |

{% hint style="info" %}
Utilize um cliente da API com `ClientID` e `ClientSecret`. As definições legadas de nome de utilizador e palavra-passe da API continuam disponíveis para implementações compatíveis.
{% endhint %}
{% endstep %}

{% step %}

### Ligar a AC externa

No Jamf Pro, abra **Definições → Gestão global → Certificados PKI**.

![](https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-ba2b5fe78590c9c592ef0d65cdf14fe238acda0a%2Fimage%20\(23\).png?alt=media)

Abra **Modelo de certificado de gestão → AC externa** e ative **Proxy SCEP para perfis de configuração**.

![](https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-c9a89bf1790dfb161703eaf77a5afcb9b33bcd8b%2Fimage%20\(26\).png?alt=media)

Preencha os seguintes campos e guarde a configuração:

| Campo                            | Descrição                                                   | Exemplo/Valor                                                                                                                                                                                             |
| -------------------------------- | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **URL**                          | URL do SCEPman. Inclua o caminho `/jamf` .                  | <https://scepman.contoso.com/jamf>                                                                                                                                                                        |
| **Nome**                         | nome da instância                                           | SCEPman Contoso                                                                                                                                                                                           |
| **Assunto**                      | entidades em conformidade com a norma X.500                 | O=Contoso                                                                                                                                                                                                 |
| **Tipo de desafio**              | tipo de desafio para verificação da emissão de certificados | Estático                                                                                                                                                                                                  |
| **Desafio (verificar)**          | segredo previamente partilhado (desafio)                    | definido no SCEPman através do [AppConfig](https://docs.scepman.com/pt/configuracao-do-scepman/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-requestpassword) parâmetro |
| Tamanho da chave                 | tamanho da chave em bits                                    | 2048                                                                                                                                                                                                      |
| Utilizar como assinatura digital |                                                             | Sim (se necessário)                                                                                                                                                                                       |
| Utilizar para cifragem de chaves |                                                             | Sim (se necessário)                                                                                                                                                                                       |
| Impressão digital                | Impressão digital do certificado da AC do SCEPman (SHA-1)   | visível no painel do SCEPman ("Impressão digital da AC")                                                                                                                                                  |

![](https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-706cea0b6e3d717ff4d599d924edd31a98ff407b%2F2021-10-21%2020_37_05-Edit%20PKI%20Certificates%20PKI%20Certificates_%20and%201%20more%20page%20-%20Work%20-%20Microsoft%E2%80%8B%20Edge.png?alt=media)
{% endstep %}

{% step %}

### Carregar certificados de assinatura e da AC

O Jamf requer um certificado de assinatura e o certificado da AC do SCEPman. O Jamf assina os pedidos com o certificado de assinatura. O SCEPman valida a palavra-passe de desafio configurada.

{% tabs %}
{% tab title="OpenSSL" %}

```shellscript
openssl req -x509 -newkey rsa:4096 -keyout tempKey.key -out tempCert.pem -sha256 -days 3650 -nodes -subj "/CN=JAMF Signer Certificate for SCEPman"
openssl pkcs12 -export -out SigningCert.pfx -inkey ./tempKey.key -in ./tempCert.pem -passout pass:password
# Remover ficheiros temporários
rm tempKey.key
rm tempCert.pem
```

{% endtab %}

{% tab title="PowerShell" %}

```powershell
$cert = New-SelfSignedCertificate -Subject "CN=JAMF Signer Certificate for SCEPman" -CertStoreLocation "Cert:\CurrentUser\My" -NotAfter (Get-Date).AddYears(10)
$pfxBytes = $cert.Export([System.Security.Cryptography.X509Certificates.X509ContentType]::Pfx, "password")
[System.IO.File]::WriteAllBytes("c:\temp\jamf.pfx", $pfxBytes)
```

{% endtab %}
{% endtabs %}

Selecione **Alterar certificados de assinatura e da AC** na configuração da AC externa do Jamf.

![](https://3802289327-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-4c7abd11c59ea4578210eff6b229c0b610bd5f08%2Fjamfsigningcertificate.png?alt=media)

No assistente, carregue o ficheiro PFX do certificado de assinatura. Introduza a respetiva palavra-passe e confirme o certificado de assinatura. Em **Carregar certificado da AC**, carregue o certificado da AC do SCEPman. Transfira-o através de **Obter certificado da AC** na página inicial do SCEPman. Confirme as alterações.
{% 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/jamf/general.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.
