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

# General Configuration

Connect Jamf Pro to SCEPman as an external certificate authority.

Connect Jamf Pro to SCEPman as an external CA. Jamf Pro proxies SCEP requests from enrolled users and devices to SCEPman's dedicated `/jamf` endpoint.

{% stepper %}
{% step %}

### Enable the Jamf endpoint

Set these application settings on the **SCEPman App Service**. Do not set them on Certificate Master.

Use the setting names for your App Service operating system.

{% tabs %}
{% tab title="Linux" %}
Linux App Services use double underscores (`__`) instead of colons.

| Setting                                                                                                                                                                                                                       | Description                                                                                                                                                                                                                                                                            | Example                     |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| [AppConfig\_\_JamfValidation\_\_Enabled](https://docs.scepman.com/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-enabled)                                              | Do you want to use SCEPman with Jamf?                                                                                                                                                                                                                                                  | true                        |
| [AppConfig\_\_JamfValidation\_\_RequestPassword](https://docs.scepman.com/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-requestpassword)                              | <p>Jamf authenticates its certificate requests at SCEPman with this secure password.</p><p>Consider adding this as a secret in your SCEPman <a href="https://docs.scepman.com/scepman-configuration/application-settings.md#secure-configuration-in-azure-key-vault">KeyVault</a>.</p> | max *32 character password* |
| [AppConfig\_\_JamfValidation\_\_ValidityPeriodDays](https://docs.scepman.com/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-validityperioddays) (optional)             | How many days shall certificates issued via Jamf be valid at most?                                                                                                                                                                                                                     | 365                         |
| [AppConfig\_\_JamfValidation\_\_EnableCertificateStorage](https://docs.scepman.com/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-enablecertificatestorage) (optional) | Enable this setting to save Jamf certificates in Certificate Master                                                                                                                                                                                                                    | true or false (default)     |
| {% endtab %}                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                        |                             |

{% tab title="Windows" %}
Windows App Services use colons (`:`) in setting names.

| Setting                                                                                                                                                                                                                 | Description                                                                                                                                                                                                                                                                            | Example                     |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| [AppConfig:JamfValidation:Enabled](https://docs.scepman.com/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-enabled)                                              | Do you want to use SCEPman with Jamf?                                                                                                                                                                                                                                                  | true                        |
| [AppConfig:JamfValidation:RequestPassword](https://docs.scepman.com/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-requestpassword)                              | <p>Jamf authenticates its certificate requests at SCEPman with this secure password.</p><p>Consider adding this as a secret in your SCEPman <a href="https://docs.scepman.com/scepman-configuration/application-settings.md#secure-configuration-in-azure-key-vault">KeyVault</a>.</p> | max *32 character password* |
| [AppConfig:JamfValidation:ValidityPeriodDays](https://docs.scepman.com/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-validityperioddays) (optional)             | How many days shall certificates issued via Jamf be valid at most?                                                                                                                                                                                                                     | 365                         |
| [AppConfig:JamfValidation:EnableCertificateStorage](https://docs.scepman.com/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-enablecertificatestorage) (optional) | Enable this setting to save Jamf certificates in Certificate Master                                                                                                                                                                                                                    | true or false (default)     |
| {% endtab %}                                                                                                                                                                                                            |                                                                                                                                                                                                                                                                                        |                             |
| {% endtabs %}                                                                                                                                                                                                           |                                                                                                                                                                                                                                                                                        |                             |
| {% endstep %}                                                                                                                                                                                                           |                                                                                                                                                                                                                                                                                        |                             |

{% step %}

### Configure the Jamf API connection

SCEPman uses the Jamf API to check enrolled-client status. This enables revocation when Jamf objects are deleted.

[Refer to the Jamf documentation](https://learn.jamf.com/en-US/bundle/jamf-pro-documentation-current/page/API_Roles_and_Clients.html) on how to create an API role and API client. The API client must have a role with these permissions:

* Read Mobile Devices
* Read Computers
* Read User

Set these application settings on the **SCEPman App Service**:

{% tabs %}
{% tab title="Linux" %}
Linux App Services use double underscores (`__`) instead of colons.

| Setting                                                                                                                                                                                    | Description                                                                                                                                                                                                                                                    | Example                                                                                                                                    |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| [AppConfig\_\_JamfValidation\_\_URL](https://docs.scepman.com/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-url)                   | The URL of your Jamf instance                                                                                                                                                                                                                                  | `https://contoso.jamfcloud.com`                                                                                                            |
| [AppConfig\_\_JamfValidation\_\_ClientID](https://docs.scepman.com/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-clientid)         | The identifier of the Jamf API client                                                                                                                                                                                                                          | See [Jamf ClientId](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/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-clientsecret) | <p>The Client Secret value for the API Client configuration.</p><p>Consider adding this as a secret in your SCEPman <a href="https://docs.scepman.com/scepman-configuration/application-settings.md#secure-configuration-in-azure-key-vault">KeyVault</a>.</p> | See [Jamf Client Secret](https://learn.jamf.com/en-US/bundle/jamf-pro-documentation-current/page/API_Roles_and_Clients.html#ariaid-title4) |
| {% endtab %}                                                                                                                                                                               |                                                                                                                                                                                                                                                                |                                                                                                                                            |

{% tab title="Windows" %}
Windows App Services use colons (`:`) in setting names.

| Setting                                                                                                                                                                              | Description                                                                                                                                                                                                                                                    | Example                                                                                                                                    |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| [AppConfig:JamfValidation:URL](https://docs.scepman.com/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-url)                   | The URL of your Jamf instance                                                                                                                                                                                                                                  | `https://contoso.jamfcloud.com`                                                                                                            |
| [AppConfig:JamfValidation:ClientID](https://docs.scepman.com/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-clientid)         | The identifier of the Jamf API client                                                                                                                                                                                                                          | See [Jamf ClientId](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/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-clientsecret) | <p>The Client Secret value for the API Client configuration.</p><p>Consider adding this as a secret in your SCEPman <a href="https://docs.scepman.com/scepman-configuration/application-settings.md#secure-configuration-in-azure-key-vault">KeyVault</a>.</p> | See [Jamf Client Secret](https://learn.jamf.com/en-US/bundle/jamf-pro-documentation-current/page/API_Roles_and_Clients.html#ariaid-title4) |
| {% endtab %}                                                                                                                                                                         |                                                                                                                                                                                                                                                                |                                                                                                                                            |
| {% endtabs %}                                                                                                                                                                        |                                                                                                                                                                                                                                                                |                                                                                                                                            |

{% hint style="info" %}
Use an API client with `ClientID` and `ClientSecret`. Legacy API username and password settings remain available for compatible deployments.
{% endhint %}
{% endstep %}

{% step %}

### Connect the External CA

In Jamf Pro, open **Settings → Global Management → PKI Certificates**.

![](https://2535731700-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)

Open **Management Certificate Template → External CA** and enable **SCEP Proxy for configuration profiles**.

![](https://2535731700-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)

Complete the following fields, then save the configuration:

| Field                    | Description                                            | Example/Value                                                                                                                                                                                |
| ------------------------ | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **URL**                  | SCEPman URL. Include the `/jamf` path.                 | <https://scepman.contoso.com/jamf>                                                                                                                                                           |
| **Name**                 | name of instance                                       | SCEPman Contoso                                                                                                                                                                              |
| **Subject**              | entities following X.500 standard                      | O=Contoso                                                                                                                                                                                    |
| **Challenge Type**       | challenge type for verification of certificate issuing | Static                                                                                                                                                                                       |
| **(Verify) Challenge**   | pre-shared secret (challenge)                          | defined in SCEPman via [AppConfig](https://docs.scepman.com/scepman-configuration/application-settings/scep-endpoints/jamf-validation.md#appconfig-jamfvalidation-requestpassword) parameter |
| Key Size                 | key size in bits                                       | 2048                                                                                                                                                                                         |
| Use as digital signature |                                                        | Yes (if needed)                                                                                                                                                                              |
| Use for key encipherment |                                                        | Yes (if needed)                                                                                                                                                                              |
| Fingerprint              | Thumbprint of SCEPman CA-Cert (SHA-1)                  | visible via SCEPman dashboard ("CA Thumbprint")                                                                                                                                              |

![](https://2535731700-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 %}

### Upload signing and CA certificates

Jamf requires a signing certificate and the SCEPman CA certificate. Jamf signs requests with the signing certificate. SCEPman validates the configured challenge password.

{% 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
# Remove temporary files
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 %}

Select **Change Signing and CA Certificates** in the Jamf external CA configuration.

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

In the wizard, upload the signing-certificate PFX file. Enter its password and confirm the signing certificate. Under **Upload CA Certificate**, upload the SCEPman CA certificate. Download it with **Get CA Certificate** on the SCEPman homepage. Confirm the changes.
{% 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/certificate-management/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.
