# Zertifikatsbasierte Authentifizierung für Entra ID

Die zertifikatbasierte Authentifizierung bietet eine starke Sicherheitsalternative für den Zugriff auf Entra ID-Ressourcen. Dieser Artikel bietet eine Schritt-für-Schritt-Anleitung zur Konfiguration dieser Methode unter Verwendung von SCEPman als Zertifizierungsstelle, um die Zertifikatsverwaltung zu vereinfachen.

## SCEPman-CRL aktivieren

{% content-ref url="../../../zertifikatsverwaltung/manage-certificates/enabling-crl" %}
[enabling-crl](https://docs.scepman.com/de/zertifikatsverwaltung/manage-certificates/enabling-crl)
{% endcontent-ref %}

Entra ID benötigt eine CRL, um die Zertifikate zu validieren. Stellen Sie sicher, dass die folgenden Umgebungsvariablen in Ihrem App Service gesetzt sind, damit die CRL verfügbar ist:

[AppConfig:CRL:RequestToken](https://docs.scepman.com/scepman-configuration/application-settings/crl#appconfig-crl-requesttoken)

Setzen Sie dies auf einen benutzerdefinierten String, der in der URL verwendet wird, um den Download der CRL zu ermöglichen.

[AppConfig:CRL:Source](https://docs.scepman.com/scepman-configuration/application-settings/crl#appconfig-crl-source)

Dies ist die Quelle, aus der SCEPman die CRL erstellt. Stellen Sie sicher, dass dies auf `Storage`

## Einrichtung von Entra ID

{% stepper %}
{% step %}

### PKI im Entra Security Center erstellen

Navigieren Sie in Entra ID zu **Schutz** > **Security Center** > [**Public Key Infrastructure**](https://entra.microsoft.com/#view/Microsoft_AAD_IAM/SecurityMenuBlade/~/PublicKeyInfrastructure/menuId/SecurityCenter/fromNav/)**,** klicken Sie auf *Create PKI* und wählen Sie einen passenden Anzeigenamen aus.
{% endstep %}

{% step %}

### Zertifizierungsstelle hinzufügen

Navigieren Sie zur neu erstellten PKI und klicken Sie auf *Zertifizierungsstelle hinzufügen* um das CA-Zertifikat Ihrer SCEPman-Instanz hochzuladen. Dieses Zertifikat kann über die Startseite im Menü auf der rechten Seite abgerufen werden (*Get CA Certificate*).

Für die URL der Zertifikatswiderrufsliste können Sie die URL in folgendem Format eingeben:

```
https://scepman.contoso.com/crl/pem/{YourCrlRequestToken}
```

{% hint style="warning" %}
Stellen Sie sicher, dass Sie den `/pem/` Pfad in Ihrer URL angeben, da Entra möglicherweise Kompatibilitätsprobleme bei der Verwendung des standardmäßigen DER-Formats hat.
{% endhint %}

Damit sollten Sie nun eine Zertifizierungsstelle haben, die in etwa der folgenden entspricht:

<figure><img src="https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FJ8NIUb0d7eyJ6VLQboOr%2Fimage.png?alt=media&#x26;token=9db3a6e0-f62a-4b5d-9225-3fd9df3d00cd" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### CBA in Authentifizierungsmethoden aktivieren

Mit der vorhandenen CA können wir nun die zertifikatbasierte Authentifizierung in **Schutz** > **Authentifizierungsmethoden** > [**Richtlinien**](https://entra.microsoft.com/#view/Microsoft_AAD_IAM/AuthenticationMethodsMenuBlade/~/AdminAuthMethods/fromNav/)

Gehen Sie zu der *Zertifikatbasierte Authentifizierung* Richtlinie, aktivieren Sie sie und erlauben Sie entweder allen Benutzern oder bestimmten Gruppen, diese Methode zu verwenden:

![](https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FA5JQWoky2wn9xy7BK384%2Fimage.png?alt=media\&token=be93a02a-0a8d-4e54-a816-d003d6b05c41)
{% endstep %}

{% step %}

### Zertifikatbasierte Authentifizierung konfigurieren

Wechseln Sie zur Registerkarte *Konfigurieren* und gehen Sie die Optionen durch:

**CRL-Validierung erforderlich**: ✅

Dies ist ein wesentlicher Bestandteil der Sicherheit, die diese Methode bietet, da die CRL Entra ID mitteilt, welche Zertifikate widerrufen wurden und daher nicht für die Authentifizierung zugelassen werden dürfen.

**Issuer Hints** : ✅

Wenn die Ausstellerhinweise aktiviert sind, werden während der Authentifizierung nur Zertifikate angezeigt, die von der konfigurierten CA ausgestellt wurden.

Belassen Sie die Standardeinstellungen für die Authentifizierungsbindung und erstellen Sie dann eine Regel, um die zuvor erstellte Zertifizierungsstelle zuzulassen:

<figure><img src="https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FE8UtFEErL3Into71bGui%2Fimage.png?alt=media&#x26;token=17f860ed-2f4d-492d-b574-dd56f7cff9b4" alt=""><figcaption></figcaption></figure>

**Authentifizierungsstärke**:

Dies definiert das Gewicht der Authentifizierung mit dieser CA. Wenn Sie *Ein-Faktor-Authentifizierung*auswählen, kann je nach der aufzurufenden Anwendung eine weitere Authentifizierungsmethode erforderlich sein.

**Affinitätsbindung**:

Die Affinitätsbindung definiert die erforderlichen Details im Zertifikat, die mit den korrelierenden Daten im Benutzerobjekt übereinstimmen müssen, damit die Authentifizierung zugelassen wird. Da SCEPman derzeit keine Zertifikatsinformationen im Benutzerobjekt hinzufügen kann, empfehlen wir, dies auf **Low** zu setzen, sofern Sie die erforderlichen Informationen nicht manuell konfigurieren.

{% hint style="warning" %}
Die Einstellungen für Authentifizierungsstärke und Affinitätsbindung hängen stark vom jeweiligen Anwendungsfall und der Art der Konten ab, die Sie mit dieser Authentifizierungsmethode schützen möchten. Falls Sie besonders privilegierte Benutzer absichern möchten, sollten Sie in Erwägung ziehen, die Zertifikatsinformationen manuell in ihren Benutzerkonten zu hinterlegen, um eine hohe Affinität zu erreichen.
{% endhint %}
{% endstep %}
{% endstepper %}

## Verwendung

Wenn die Konfiguration abgeschlossen ist, kann ein Benutzer *Ein Zertifikat oder Smartcard verwenden*:

<figure><img src="https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FadOI8hZm2kOoKAOvi0vq%2Fimage.png?alt=media&#x26;token=bba5bfbd-6577-48b6-adc7-66a49edbdf35" alt=""><figcaption></figcaption></figure>

auswählen, woraufhin nach dem für die Authentifizierung zu verwendenden Zertifikat gefragt wird.

<figure><img src="https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FsNh5rtPY52gnNZCkq9X4%2Fimage.png?alt=media&#x26;token=85568bc1-3daa-4691-827d-f002b0701bf2" alt=""><figcaption></figcaption></figure>

## Zertifikatzuordnung manuell für hohe Affinitätsbindung hinzufügen

Falls Sie CBA nur mit hoher Affinitätsbindung aktivieren möchten, können Sie die Zertifikatsdetails manuell in den autorisierten Informationen des Benutzers eingeben.

Navigieren Sie zu den Eigenschaften der Benutzer in Entra ID, bearbeiten Sie sie und bearbeiten Sie nun die **Zertifikat-Benutzer-IDs**:

<figure><img src="https://2075553437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LoGejQeUQcw7lqnQ3WX%2Fuploads%2FyGzQlmHC4nv6yzEKBwZG%2Fimage.png?alt=media&#x26;token=9ab1a272-df75-46c0-b2ca-51c18420e823" alt=""><figcaption></figcaption></figure>

Das erforderliche Format dieser IDs hängt von den Feldern ab, die in der Benutzerbindung der Authentifizierungsmethoden konfiguriert wurden. Eine Liste der Formate finden Sie in der entsprechenden [Microsoft-Dokumentation](https://learn.microsoft.com/en-us/entra/identity/authentication/concept-certificate-based-authentication-certificateuserids#supported-patterns-for-certificate-user-ids).

Beispiel für die *SHA1PublicKey* Bindung:

```
X509:<SHA1-PUKEY>9600e49d740011187e5c734bab4a3d5d18d2a87a
```

Dabei wird der Fingerabdruck des Zertifikats verwendet, um die Identität des Benutzers eindeutig zuzuordnen.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.scepman.com/de/scepman-bereitstellung/deployment-guides/scenarios/certificate-based-authentication-for-entra-id.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
