> 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/de/zertifikatsverwaltung/static-certificates/addigy.md).

# Addigy

Stellen Sie Zertifikate in Addigy aus, indem Sie SCEPman als externe Zertifizierungsstelle anbinden.

SCEPman kann mit [Addigy](https://addigy.com/) als externe Zertifizierungsstelle (CA) integriert werden. Mit einem konfigurierten Challenge-Passwort können registrierte Geräte Zertifikate anfordern und erhalten.

Allgemeine Informationen zu anderen MDM-Lösungen und zur Integration von SCEPman finden Sie [hier](https://docs.scepman.com/de/zertifikatsverwaltung/static-certificates.md).

{% stepper %}
{% step %}

### Addigy-Integration aktivieren

Die Integration von SCEPman lässt sich ganz einfach über die folgenden Umgebungsvariablen im SCEPman App Service aktivieren:

{% hint style="success" %}
Wenn die Addigy-Entra-Synchronisierung aktiviert ist, verwenden Sie [Statische AAD-Validierung](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/staticaad-validation.md). Dadurch werden Zertifikate an Entra-Objekte gebunden und bei Deaktivierung oder Löschung dieser Objekte automatisch widerrufen.

Verwenden Sie die statische Validierung nur, wenn die Entra-Synchronisierung nicht verfügbar ist. Konfigurieren Sie den ausgewählten Endpunkt in [Andere MDM-Lösungen](https://docs.scepman.com/de/zertifikatsverwaltung/static-certificates.md#choose-an-endpoint).
{% endhint %}

{% hint style="info" %}
Sie erkennen den SCEPman-App-Service im Unterschied zum Certificate Master am App-Service **ohne** "-cm" im Namen
{% endhint %}

<details>

<summary>Static-AAD-Validierung</summary>

Verwenden Sie diese Einstellungen, wenn die Addigy-Entra-Synchronisierung aktiviert ist.

Verwenden Sie die Einstellungsnamen für das Betriebssystem Ihres App Service.

{% tabs %}
{% tab title="Linux" %}
Linux-App Services verwenden doppelte Unterstriche (`__`) anstelle von Doppelpunkten.

| Einstellung                                                                                                                                                                                                                                     | Beschreibung                                                                                 | Wert                                                |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| [AppConfig\_\_StaticAADValidation\_\_Enabled](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-enabled)                                              | Entra-gebundene Validierung aktivieren                                                       | **true** zum Aktivieren, **false** zum Deaktivieren |
| [AppConfig\_\_StaticAADValidation\_\_RequestPassword](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-requestpassword)                              | Authentifiziert Zertifikatsanforderungen. Speichern Sie dieses Geheimnis in Azure Key Vault. | Generieren Sie ein 32 Zeichen langes Kennwort       |
| [AppConfig\_\_StaticAADValidation\_\_ValidityPeriodDays](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-validityperioddays) (optional)             | Gültigkeitsdauer des Zertifikats in Tagen                                                    | 365                                                 |
| [AppConfig\_\_StaticAADValidation\_\_EnableCertificateStorage](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-enablecertificatestorage) (optional) | Ausgestellte Zertifikate speichern und automatische Sperrung aktivieren                      | **true**                                            |
| {% endtab %}                                                                                                                                                                                                                                    |                                                                                              |                                                     |

{% tab title="Windows" %}
Windows-App Services verwenden Doppelpunkte (`:`) in Einstellungsnamen.

| Einstellung                                                                                                                                                                                                                               | Beschreibung                                                                                 | Wert                                                |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| [AppConfig:StaticAADValidation:Enabled](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-enabled)                                              | Entra-gebundene Validierung aktivieren                                                       | **true** zum Aktivieren, **false** zum Deaktivieren |
| [AppConfig:StaticAADValidation:RequestPassword](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-requestpassword)                              | Authentifiziert Zertifikatsanforderungen. Speichern Sie dieses Geheimnis in Azure Key Vault. | Generieren Sie ein 32 Zeichen langes Kennwort       |
| [AppConfig:StaticAADValidation:ValidityPeriodDays](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-validityperioddays) (optional)             | Gültigkeitsdauer des Zertifikats in Tagen                                                    | 365                                                 |
| [AppConfig:StaticAADValidation:EnableCertificateStorage](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-enablecertificatestorage) (optional) | Ausgestellte Zertifikate speichern und automatische Sperrung aktivieren                      | **true**                                            |
| {% endtab %}                                                                                                                                                                                                                              |                                                                                              |                                                     |
| {% endtabs %}                                                                                                                                                                                                                             |                                                                                              |                                                     |

</details>

<details>

<summary>Static-Validierung</summary>

Verwenden Sie diese Einstellungen, wenn die Addigy-Entra-Synchronisierung nicht verfügbar ist.

Verwenden Sie die Einstellungsnamen für das Betriebssystem Ihres App Service.

{% tabs %}
{% tab title="Linux" %}
Linux-App Services verwenden doppelte Unterstriche (`__`) anstelle von Doppelpunkten.

|                                                                                                               Einstellung                                                                                                              | Beschreibung                                                                                                                                                                                                                                                                                                                                         |                           Wert                          |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-----------------------------------------------------: |
|                        [AppConfig\_\_StaticValidation\_\_Enabled](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enabled)                       | Validierung durch Drittanbieter aktivieren                                                                                                                                                                                                                                                                                                           | ***true*** zum Aktivieren, ***false*** zum Deaktivieren |
|                [AppConfig\_\_StaticValidation\_\_RequestPassword](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-requestpassword)               | <p>An SCEPman gesendete Zertifikatsignierungsanforderungen werden mit diesem sicheren statischen Kennwort authentifiziert.<br><br><strong>Empfehlung</strong>: Speichern Sie dieses Geheimnis in <a href="https://docs.scepman.com/de/scepman-konfiguration/application-settings.md#secure-configuration-in-azure-key-vault">Azure KeyVault</a>.</p> |       *ein 32 Zeichen langes Kennwort generieren*       |
|       [AppConfig\_\_StaticValidation\_\_ValidityPeriodDays](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-validityperioddays) (optional)       | Gültigkeitsdauer in Tagen für über Addigy ausgestellte Zertifikate                                                                                                                                                                                                                                                                                   |                           365                           |
| [AppConfig\_\_StaticValidation\_\_EnableCertificateStorage](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enablecertificatestorage) (optional) | Speichert angeforderte Zertifikate im Storage Account, damit sie im SCEPman Certificate Master angezeigt werden.                                                                                                                                                                                                                                     | ***true*** zum Aktivieren, ***false** zum Deaktivieren* |
|                                                                                                              {% endtab %}                                                                                                              |                                                                                                                                                                                                                                                                                                                                                      |                                                         |

{% tab title="Windows" %}
Windows-App Services verwenden Doppelpunkte (`:`) in Einstellungsnamen.

|                                                                                                            Einstellung                                                                                                           | Beschreibung                                                                                                                                                                                                                                                                                                                                         |                           Wert                          |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-----------------------------------------------------: |
|                        [AppConfig:StaticValidation:Enabled](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enabled)                       | Validierung durch Drittanbieter aktivieren                                                                                                                                                                                                                                                                                                           | ***true*** zum Aktivieren, ***false*** zum Deaktivieren |
|                [AppConfig:StaticValidation:RequestPassword](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-requestpassword)               | <p>An SCEPman gesendete Zertifikatsignierungsanforderungen werden mit diesem sicheren statischen Kennwort authentifiziert.<br><br><strong>Empfehlung</strong>: Speichern Sie dieses Geheimnis in <a href="https://docs.scepman.com/de/scepman-konfiguration/application-settings.md#secure-configuration-in-azure-key-vault">Azure KeyVault</a>.</p> |       *ein 32 Zeichen langes Kennwort generieren*       |
|       [AppConfig:StaticValidation:ValidityPeriodDays](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-validityperioddays) (optional)       | Gültigkeitsdauer in Tagen für über Addigy ausgestellte Zertifikate                                                                                                                                                                                                                                                                                   |                           365                           |
| [AppConfig:StaticValidation:EnableCertificateStorage](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enablecertificatestorage) (optional) | Speichert angeforderte Zertifikate im Storage Account, damit sie im SCEPman Certificate Master angezeigt werden.                                                                                                                                                                                                                                     | ***true*** zum Aktivieren, ***false** zum Deaktivieren* |
|                                                                                                           {% endtab %}                                                                                                           |                                                                                                                                                                                                                                                                                                                                                      |                                                         |
|                                                                                                           {% endtabs %}                                                                                                          |                                                                                                                                                                                                                                                                                                                                                      |                                                         |

</details>

{% hint style="warning" %}
Nach dem Hinzufügen oder Bearbeiten von SCEPman-Konfigurationsparametern müssen Sie den App Service neu starten.
{% endhint %}
{% endstep %}

{% step %}

### SCEPman-Stammzertifikat bereitstellen

Als ersten Schritt muss das SCEPman-Stammzertifikat bereitgestellt werden. Laden Sie dazu das RootCA-Zertifikat über die SCEPman-Website herunter:

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

Konvertieren Sie nun das .cer-Stammzertifikat in das PEM-Format, um es in Addigy hochzuladen. Dazu können Sie den folgenden OpenSSL-Befehl verwenden:

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

Navigieren Sie in Addigy zu **Profiles** und erstellen Sie ein neues MDM-Profil. Wählen Sie **Certificates - (PKCS12)** als Profiltyp aus, um das SCEPman-Root-CA-Zertifikat hochzuladen, und laden Sie die Datei im PEM-Format hoch.

<figure><img src="https://2075553437-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 %}

### SCEP-Profil erstellen

Im zweiten Schritt erstellen Sie ein neues **SCEP Profile** für die Bereitstellung von Gerätezertifikaten wie unten gezeigt:

* **Payload-Name:** Wählen Sie einen Namen für das Profil. Dieser wird auf dem Client als Zertifikatsprofil angezeigt.
* **URL**: Verwenden Sie den SCEP-Endpunkt, der der ausgewählten Validierungsmethode entspricht. Verwenden Sie `/static/aad` für die Static-AAD-Validierung oder `/static` für die Static-Validierung. Sie können die URL von der SCEPman-Startseite kopieren.

<figure><img src="https://2075553437-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>

* **Challenge**: Ist erforderlich, um CSR-Anforderungen zu authentifizieren. Sie muss mit dem Anforderungspasswort übereinstimmen, das für [Statische AAD-Validierung](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-requestpassword) oder [Statische Validierung](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-requestpassword).

{% hint style="info" %}
Bei der Static-AAD-Validierung muss der Zertifikatsbetreff eine Entra-Geräte-ID enthalten oder der SAN den UPN eines Benutzers.
{% endhint %}

* Aktivieren Sie **"SCEP-Anfragen über Proxy weiterleiten"** Option
* Wählen Sie „Signierung und Verschlüsselung“ für **Schlüsselverwendung**
* Füllen Sie die übrigen Felder wie in den Screenshots unten gezeigt aus

<figure><img src="https://2075553437-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://2075553437-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>

Nachdem Sie sowohl das Root-CA- als auch das Geräte-Zertifikatsprofil erfolgreich erstellt haben, wenden Sie sie auf Ihre Richtlinie an, um die Konfiguration auf den zugewiesenen Geräten bereitzustellen.

Weitere Informationen finden Sie in [der Addigy-Dokumentation.](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/de/zertifikatsverwaltung/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.
