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

# Mosyle

Stellen Sie in Mosyle Zertifikate aus, indem Sie SCEPman als externe CA verbinden. Geräte können Zertifikate über SCEPmans statische Schnittstelle und ein registriertes Challenge-Passwort erhalten.

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

{% stepper %}
{% step %}

### Mosyle-Integration aktivieren

Die Integration von Mosyle mit SCEPman lässt sich ganz einfach über die folgenden SCEPman-App-Konfigurationen aktivieren:

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

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)          | Wie viele Tage sollen Zertifikate gültig sein, die über Mosyle ausgestellt werden?                                                                                                                                                                                                                                                                   |                           365                           |
| [AppConfig\_\_StaticValidation\_\_EnableCertificateStorage](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-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)          | Wie viele Tage sollen Zertifikate gültig sein, die über Mosyle ausgestellt werden?                                                                                                                                                                                                                                                                   |                           365                           |
| [AppConfig:StaticValidation:EnableCertificateStorage](https://docs.scepman.com/de/scepman-konfiguration/application-settings/scep-endpoints/staticaad-validation.md#appconfig-staticaadvalidation-enablecertificatestorage) (optional) | Speichert angeforderte Zertifikate im Storage Account, damit sie im SCEPman Certificate Master angezeigt werden.                                                                                                                                                                                                                                     | ***true*** zum Aktivieren, ***false** zum Deaktivieren* |
|                                                                                                              {% endtab %}                                                                                                              |                                                                                                                                                                                                                                                                                                                                                      |                                                         |
|                                                                                                              {% endtabs %}                                                                                                             |                                                                                                                                                                                                                                                                                                                                                      |                                                         |

{% hint style="info" %}
Nachdem Sie SCEPman-Konfigurationsparameter hinzugefügt oder bearbeitet haben, müssen Sie den App-Dienst neu starten.
{% endhint %}
{% endstep %}

{% step %}

### SCEPman-Stammzertifikat bereitstellen

Als 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 Mosyle zu „Management“ und fügen Sie „**Multi-Cert Profile**“ als neuen Profiltyp hinzu (sofern er noch nicht vorhanden ist).

Klicken Sie nun auf „ **Add new profile,** wählen Sie einen Namen für dieses Profil, z. B. SCEPman Root CA, und klicken Sie dann auf „ **+ADD PROFILE** “ unter „Profile Name“ (siehe Screenshot unten)**,** und wählen Sie im angezeigten Fenster „Add Certificate profile“. Wählen Sie anschließend das bereits heruntergeladene SCEPman-Stammzertifikat aus und laden Sie es hoch, geben Sie „SCEPman Root CA“ als Profilnamen ein und klicken Sie auf „Save“.

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

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

Nun müssen Sie dieses Profil Ihren Geräten/Benutzern zuweisen und anschließend auf „Save“ klicken.

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

Nach dem Speichern können Sie den Compliance-Status überprüfen, indem Sie beim Profil auf „View details“ klicken.

![Status der Profilverteilung](https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-ac4884821ea581415bcaea1afbffca4dc014c9ef%2F2022-07-25%2010_10_27-Window.png?alt=media)
{% endstep %}

{% step %}

### Gerätezertifikat bereitstellen

Fügen Sie ein neues Profil hinzu, geben Sie einen Profilnamen ein, z. B. SCEPman Device Certificate, und klicken Sie auf „ **+ADD PROFILE,** wählen Sie nun „ **SCEP Profile** “ aus und tragen Sie die Werte wie unten gezeigt ein.

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

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

**Profilname:** Wählen Sie einen Namen für Ihr Profil aus.

**Server:** Wählen Sie „URL“ aus.

**URL:** Fügen Sie Ihre SCEPman-URL ein und setzen Sie **/static** wie im Screenshot gezeigt ans Ende. Sie können diesen Wert auch von der SCEPman-Startseite neben **Static MDM**

**kopieren. Betreff:** Sie können die Variablen für den Betreff frei wählen. Sie können einen oder mehrere Relative Distinguished Names (RDNs) auswählen. Beachten Sie, dass RDNs immer mit **/** beginnen, zum Beispiel

`/CN=%DeviceName%` für den Gerätenamen. In unserem Beispiel im Screenshot haben wir drei RDNs hinzugefügt; mehrere CNs sind ebenfalls zulässig. Die Variablenliste können Sie über „ **View available variables** “ oberhalb des Feldes anzeigen.

**Alternativer Antragstellername (Subject Alternative Name)** ist optional.

**Challenge:** Fügen Sie das in der SCEPman-Konfiguration festgelegte 32 Zeichen lange Challenge-Passwort hinzu; [siehe „Mosyle-Integration aktivieren“.](#enable-mosyle-integration)

**Schlüsselgröße:** 2048

Aktivieren Sie die beiden Optionen „**Use for signing**“ und „**Für die Verschlüsselung verwenden**“ und alle anderen Einstellungen auf den Standardwerten belassen (wie im Screenshot gezeigt), dann **Speichern**

Jetzt müssen Sie dieses Profil Ihren Geräten/Benutzern zuweisen, dann **Speichern**.

Nach dem Speichern können Sie den Compliance-Status überprüfen, indem Sie beim Profil auf „View details“ klicken.

![Status der Profilverteilung](https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-94ac69b5cffff379d7efdcfd91a35dae79d1a6b7%2F2022-07-25%2011_55_57-Window.png?alt=media)
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.scepman.com/de/zertifikatsverwaltung/static-certificates/mosyle.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
