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

# Iru (ehemals Kandji)

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

SCEPman kann verbunden werden mit [Iru](https://www.iru.com/) als externe CA mit einem Challenge-Kennwort, sodass registrierte Geräte Zertifikate erhalten können.

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

### Iru-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 Iru-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 können den SCEPman App Service und den Certificate Master unterscheiden, indem Sie nach dem App Service suchen, dessen Name **nicht** „-cm“ enthält.
{% endhint %}

<details>

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

Verwenden Sie diese Einstellungen, wenn die Iru-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 Iru-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> |     *generieren Sie ein 32 Zeichen langes Kennwort*     |
|       [AppConfig\_\_StaticValidation\_\_ValidityPeriodDays](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-validityperioddays) (optional)       | Anzahl der Tage, für die über Iru ausgestellte Zertifikate gültig sind                                                                                                                                                                                                                                                                               |                           365                           |
| [AppConfig\_\_StaticValidation\_\_EnableCertificateStorage](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enablecertificatestorage) (optional) | Angeforderte Zertifikate im Storage Account speichern, damit sie im SCEPman Certificate Master angezeigt werden können                                                                                                                                                                                                                               | ***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> |     *generieren Sie ein 32 Zeichen langes Kennwort*     |
|       [AppConfig:StaticValidation:ValidityPeriodDays](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-validityperioddays) (optional)       | Anzahl der Tage, für die über Iru ausgestellte Zertifikate gültig sind                                                                                                                                                                                                                                                                               |                           365                           |
| [AppConfig:StaticValidation:EnableCertificateStorage](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/static-validation.md#appconfig-staticvalidation-enablecertificatestorage) (optional) | Angeforderte Zertifikate im Storage Account speichern, damit sie im SCEPman Certificate Master angezeigt werden können                                                                                                                                                                                                                               | ***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

Im ersten Schritt müssen Sie das SCEPman-Stammzertifikat bereitstellen. Laden Sie dieses CA-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)

Navigieren Sie in Iru zu **Library** in der linken Navigationsleiste und fügen Sie ein **Certificate Library Item** zu Ihrem Blueprint hinzu.

<figure><img src="https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FfToUgpoUeZOiYNe2xkzi%2F2023-03-09%2012_51_21-Window.png?alt=media&amp;token=df6f66fb-369b-4adf-ab9d-70757354f2f7" alt=""><figcaption><p>Zertifikatnutzlast konfigurieren</p></figcaption></figure>

Um das Zertifikat hochzuladen, wählen Sie zunächst **Zertifikat im PKCS-#1-Format** unter **Zertifikattyp**aus. Geben Sie anschließend optional einen Namen ein, laden Sie Ihr SCEPman-CA-Zertifikat hoch und speichern Sie es.

<figure><img src="https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FL8NyfsJR7x2v0j6ybS6g%2F2023-03-09%2014_21_12-KandjiSCEPmanRootCA.png?alt=media&amp;token=a70ff955-bbe2-4b49-9cf4-245964838675" alt=""><figcaption><p>SCEPman-Root-CA-Zertifikat hinzufügen</p></figcaption></figure>
{% endstep %}

{% step %}

### SCEP-Profil erstellen

Im zweiten Schritt fügen Sie ein **SCEP-Profil** zu Ihrem **Blueprint**hinzu. Fügen Sie daher ein neues **SCEP-Bibliothekselement** hinzu und konfigurieren Sie es wie folgt:

* **URL**: Verwenden Sie den SCEP-Endpunkt, der Ihrer ausgewählten Validierungsmethode entspricht. Verwenden Sie `/static/aad` für die Static-AAD-Validierung oder `/static` für die Static-Validierung.
* **Name:** Ein optionales SAN-Attribut
* **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).
* **Fingerabdruck:** Optionaler CA-Fingerabdruck. Es wird dringend empfohlen, diesen Wert zu konfigurieren, da er ein zusätzliches Maß an Sicherheit bietet. Sie finden ihn auf Ihrer SCEPman-Website unter **CA-Thumbprint**.
* **Betreff:** Optionaler Betreffname. **CN=$PROFILE\_UUID** wird von Iru automatisch als Standard-CN hinzugefügt. Iru ermöglicht das Hinzufügen mehrerer CNs.

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

{% hint style="warning" %}
Gelegentlich gab es bei macOS und iOS Probleme mit der automatischen Auswahl von Clientzertifikaten für die Netzwerkauthentifizierung, wenn mehr als zwei CNs hinzugefügt wurden.
{% endhint %}

* **Schlüsselgröße:** 2048
* **Schlüsselverwendung:** Signierung und Verschlüsselung

Weitere Informationen finden Sie in [der Dokumentation von Iru](https://support.kandji.io/support/solutions/articles/72000559782-scep-profile).

<figure><img src="https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FS84P4c40cLu5H5NCeley%2F2023-03-09%2014_43_19-Kandji.png?alt=media&amp;token=45fdf5b6-6a31-4879-ba87-a7070e76e0c5" alt=""><figcaption><p>SCEP-Profil hinzufügen</p></figcaption></figure>

<figure><img src="https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FhnTLPcfOXlMpBNOh5Nph%2F2023-03-09%2014_50_23-Kandji.png?alt=media&amp;token=1ed96cb6-861a-4cb7-8511-22e1b0b48763" alt=""><figcaption><p>SCEP-Profilkonfiguration</p></figcaption></figure>

<figure><img src="https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FbZiDYnqsvxgh8a36zPl3%2F2023-03-09%2014_51_22-Kandji.png?alt=media&amp;token=d2e681dd-f50d-4043-a85a-46bd7396d810" alt=""><figcaption><p>SCEP-Profilkonfiguration</p></figcaption></figure>

<figure><img src="https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FuiSTD2BxR4utzJ0YACZS%2F2023-03-09%2014_52_52-Kandji.png?alt=media&amp;token=84aa9c64-7b38-4829-b337-cdde8549ab98" alt=""><figcaption><p>SCEP-Profilkonfiguration</p></figcaption></figure>
{% endstep %}

{% step %}

### Bereitstellungsstatus überprüfen

Wechseln Sie nach dem Speichern des Zertifikats oder des SCEP-Profils zu **Status** , um den Bereitstellungsstatus der zugewiesenen Geräte in **Blueprints** zu überprüfen.

<figure><img src="https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FjchSJJzjqEDQxfX8K40s%2F2023-03-09%2015_12_40-Kandji.png?alt=media&amp;token=5b316771-d526-45cc-8ee5-dba4d751e39f" alt=""><figcaption><p>Bereitstellungsstatus</p></figcaption></figure>
{% 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/kandji-1.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.
