# Azure App-Registrierung

{% hint style="info" %}
Nur relevant für [Split-Tenancy](https://docs.scepman.com/de/azure-konfiguration/split-tenancy) -Setups.
{% endhint %}

SCEPman muss mit Ihren Endpunkten von Azure Active Directory und Intune interagieren, um die Zertifikats- und OCSP-Validierung von Benutzern und Geräten bereitzustellen. Um SCEPman die erforderlichen Berechtigungen zu geben, müssen Sie innerhalb Ihres Tenants eine App-Registrierung erstellen.

## App-Registrierung generieren (Anwendungs-ID abrufen)

1. Anmelden bei [Azure Portal](https://portal.azure.com)
2. Navigieren Sie zu **Azure Active Directory**
3. Klicken Sie auf **App registrations**

![](https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-a8211f3372358b01f2c1ff91c9a0ee59ebb5be32%2F2021-07-23-08_47_59-app-registrations-microsoft-azure-and-2-more-pages-c4a8-ehamed-microsoft-.png?alt=media)

4\. Klicken Sie auf **Neue Registrierung** und geben Sie einen **Namen**ein, z. B. SCEPman. Wählen Sie für den unterstützten Kontotyp **Konten in diesem Organisationsverzeichnis nur** und klicken Sie auf Registrieren.

![](https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-d81e9875a6fa2c82c5699da28eb304ed3474b23b%2F2021-07-23-08_49_37-register-an-application-microsoft-azure-and-2-more-pages-c4a8-ehamed-micro.png?alt=media)

5\. Sie können nun die **Anwendungs-(Client-)ID** kopieren. Die ID ist wichtig und wird später für die SCEPman-Bereitstellung benötigt.

![](https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-4cf962236038fceeb58fbdd74d99173f2c5fb851%2F2021-07-23-08_50_59-scepmanreg-microsoft-azure-and-2-more-pages-c4a8-ehamed-microsoft-edge.png?alt=media)

Erstellen Sie eine neue Umgebungsvariable in der SCEPman-App Service mit dem Namen [AppConfig:AuthConfig:ApplicationId](https://docs.scepman.com/de/scepman-konfiguration/application-settings/dependencies-azure-services/azure-ad#appconfig-authconfig-applicationid) und fügen Sie die kopierte Anwendungs-ID als Wert ein.

## Geheimnis generieren (Client Secret Value abrufen)

1\. Bleiben Sie in **App registrations** und klicken Sie auf **Certificates & secrets**

![](https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-9052dbda134bade7a7df444f27b509349ae5cd9f%2F2021-07-23-08_52_08-scepmanreg-microsoft-azure-and-2-more-pages-c4a8-ehamed-microsoft-edge.png?alt=media)

2\. Klicken Sie auf **Neues Client-Geheimnis**, fügen Sie eine Beschreibung hinzu und wählen Sie die Laufzeit. Wir empfehlen **24 Monate**, dies hilft, zwei Jahre lang einen laufenden Dienst bereitzustellen. Sie können ein Geheimnis jederzeit widerrufen. Klicken Sie auf **Hinzufügen**

![](https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-c0f38ab422f7bbf2eb2833fe7dcdcf2478a380d3%2F2021-07-23-09_06_11-azure-app-registration-scepman-docs-and-1-more-page-work-microsoft-edge.png?alt=media)

3\. **Kopieren Sie den Geheimniswert** und bewahren Sie ihn an einem sicheren Ort auf.

{% hint style="warning" %}
Bitte verwechseln Sie ihn nicht mit der "Client Secret **ID**". Wir benötigen hier den "Client Secret **Wert**".
{% endhint %}

{% hint style="warning" %}
Kopieren Sie den Client-Secret-Wert sofort. Sie können ihn nach Verlassen dieses Untermenüs nicht mehr abrufen.
{% endhint %}

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

4. Erstellen Sie die SCEPman-Einstellung [AppConfig:AuthConfig:ApplicationKey](https://docs.scepman.com/de/scepman-konfiguration/application-settings/dependencies-azure-services/azure-ad#appconfig-authconfig-applicationkey) mit dem Client-Secret-Wert.

## Berechtigungen konfigurieren

Bleiben Sie in **App Registrations** und klicken Sie auf **API-Berechtigungen**

1. **Entfernen Sie** die Standard- **Benutzer** **Lesen** -Berechtigung.

![](https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-933a5d5c8b03d177791b167d8b930da721afc276%2Fscreenshot-2020-02-03-at-10.54.48%20\(1\).png?alt=media)

2\. Klicken Sie auf **Eine Berechtigung hinzufügen** und wählen Sie **Microsoft Graph**. Wählen Sie anschließend **Anwendungsberechtigungen** und suchen Sie nach Verzeichnis. Fügen Sie **Directory.ReadAll** als Berechtigung hinzu.

![](https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-094488757869a78f699616a5b1863d36ae1ce657%2Fapp-permission-graph%20\(1\).png?alt=media)

![](https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-db95402d9089c53ce050e1cde83aaf6beea474e8%2Fapp-permission-directory-read%20\(1\)%20\(1\)%20\(1\).png?alt=media)

3\. Klicken Sie jetzt auf **Eine Berechtigung hinzufügen** und wählen Sie **Intune**. Wählen Sie anschließend **Anwendungsberechtigungen** und suchen Sie nach scep. Fügen Sie **scep\_challenge\_provider** als Berechtigung hinzu

![](https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-45b33cc616a68aedbb3cc63341c2405cabc8d206%2Fapp-permission-intune%20\(1\)%20\(1\).png?alt=media)

![](https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2Fgit-blob-46eb2ea92e7d1accaae30f634f98212f1cddc6c7%2Fapp-permission-scep%20\(1\).png?alt=media)

4. Suchen und fügen Sie außerdem die folgenden Graph-Berechtigungen hinzu: `DeviceManagementConfiguration.Read.All` und `DeviceManagementManagedDevices.Read.All`
5. Klicken Sie abschließend auf **Admin-Zustimmung erteilen** und **bestätigen Sie** die Zustimmung für die angegebene App-Registrierung.

<figure><img src="https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FBxwHTG0eXVTMLzESdIWH%2F2024-03-13%2012_10_27-SCEPman-api.png?alt=media&#x26;token=19ae6761-59f2-4fde-99f3-498bea4b2a9b" alt=""><figcaption></figcaption></figure>

6. Nachdem Sie die Berechtigungen erfolgreich erteilt haben, sollten Sie für jede Berechtigung einen grünen Status sehen.

<figure><img src="https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FPqHvqGEiBsnquNtgQifc%2F2024-03-13%2012_12_18-SCEPman-api.png?alt=media&#x26;token=dcf94b12-3800-42dc-832c-4c0882d40fa9" alt=""><figcaption></figcaption></figure>

Die App-Registrierung ist abgeschlossen.
