> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/de/authentifizierung/azure-auth.md).

# Entra ID (Azure AD) zur Authentifizierung verwenden

Schritt-für-Schritt-Anleitung zur Konfiguration von Microsoft Entra ID (Azure AD) als OAuth2-Autorisierungsquelle in VergeOS, einschließlich App-Registrierung, Gruppenintegration und Benutzerbereitstellung.

VergeOS kann so konfiguriert werden, dass Benutzer sich mit ihren Unternehmensanmeldedaten von Azure authentifizieren können. Diese Seite führt Sie durch den Konfigurationsprozess.

## Eine Autorisierungsquelle für Entra ID konfigurieren

1. In Azure-Diensten: Registrieren Sie eine Single-Tenant-Webanwendung und setzen Sie die ***Umleitungs-URI*** auf die URL des VergeOS-Systems und erstellen Sie ein neues Client-Secret. **Azure Active Directory > App-Registrierungen > Neue Registrierung** ![azurereg1.png](https://1073138757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-bb5217dce60d2b5fbc13525b6c4d55fde916fd24%2Fazurereg1.png?alt=media)

   ![azurereg2.png](https://1073138757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-b0d802ab9f75bd8da9c880b685efdbf1c08482cb%2Fazurereg2.png?alt=media)
2. Erstellen Sie ein neues Client-Secret. **App-Registrierungen > Anmeldeinformationen des Clients > Zertifikat oder Geheimnis hinzufügen. Klicken Sie auf +Neues Client-Secret.**

   * Geben Sie eine **Beschreibung und ein Ablaufdatum** für das neue Client-Secret ein.
   * **Beschaffen Sie die folgenden Daten aus Azure** zur Verwendung bei der Konfiguration der Autorisierungsquelle innerhalb von VergeOS:
     * **Mandanten-ID** - **Hinweis:&#x20;*****Alle Dienste > Azure Active Directory > Übersicht.*****&#x20;Die Mandanten-ID ist unter Basisinformationen aufgeführt.**
     * **Client-ID** - **Hinweis:&#x20;*****Azure-App-Registrierungen > Konfiguriertes Element > Anmeldeinformationen des Clients***
     * **Client-Secret** - **Hinweis:&#x20;*****Azure-App-Registrierungen > Konfiguriertes Element > Anmeldeinformationen des Clients*****&#x20;Verwenden Sie das Feld „VALUE“.**

   ![azureclientsecretadd.png](https://1073138757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-c610e7f4a2b6df1024f288adee4abc9a8b7e2645%2Fazureclientsecretadd.png?alt=media) ![azureclientsecret2.png](https://1073138757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-0984cccf8b287e22110087cb9a1a6dd3480b234b%2Fazureclientsecret2.png?alt=media)
3. Klicken Sie auf **System** im oberen Menü.
4. Wählen Sie **Authentifizierungsquellen**.
5. Klicken Sie auf **Neu** im linken Menü.
6. Geben Sie eine ***Name*** für die Quelle (z. B. „Azure“). Dieser Name wird auf der Anmelde-Schaltfläche der VergeOS-Anmeldeseite angezeigt. ![azureauthform.png](https://1073138757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-e9db0034056da44a679926f7e04c71f9a7a4ecfa%2Fazureauthform.png?alt=media)
7. Im ***Treiber*** Feld (Dropdown-Liste) wählen Sie **Azure AD**.
8. Geben Sie die ***Mandanten-ID*** im vorherigen Schritt ermittelt wurden.
9. Die ***Umleitungs-URI*** sollte die URL Ihres VergeOS-Systems sein (z. B.: https\:/\[]/verge.io.mycompanyabc.com)
10. Geben Sie ein ***Endpunkt-URL für den Benutzer zum Abmelden des Sitzungstokens*** (https\:/\[]/login.microsoftonline.com/***TENANTID***/oauth2/v2.0/logout)
11. ***Scope*** sollte in der Regel auf dem Standardwert „OpenID profile email“ belassen werden.
12. ***Gruppen-Scope*** muss festgelegt werden, wenn Benutzer basierend auf der Gruppenmitgliedschaft automatisch erstellt werden sollen; in der Regel wird hierfür das Wort „groups“ ohne Satzzeichen verwendet.
13. Geben Sie die ***Client-ID*** im vorherigen Schritt ermittelt wurden.
14. Geben Sie die ***Client-Secret*** im vorherigen Schritt ermittelt wurden.
15. ***Felder für Remote-Benutzer*** definiert die Liste der Felder, die verwendet werden, um den Azure-Benutzer zunächst zu finden; dieses Feld wird automatisch mit (sub,preferred\_username,email nickname) ausgefüllt, einer Standardliste, die in der Regel für die meisten Implementierungen funktioniert. **Hinweis: Aus Sicherheitsgründen wird nicht empfohlen, Remote-Benutzer anhand von Feldern zu ermitteln, die vom Endbenutzer auf dem Remotesystem geändert werden können.**
16. Um Gruppenmitgliedschaften von Azure nach VergeOS zu übernehmen, aktivieren Sie das ***Gruppenmitgliedschaft aktualisieren*** Kontrollkästchen. Gruppen müssen in VergeOS anhand der folgenden Anweisungen erstellt werden.
17. **Funktionen zur automatischen Benutzererstellung (optional)**: Benutzer können bei der ersten Anmeldung bei VergeOS automatisch erstellt werden; dies kann für alle Entra-ID-Benutzer ausgewählt werden – ODER – auf Benutzer in bestimmten Entra-ID-Gruppen beschränkt werden.
    * ***Benutzer automatisch erstellen*** - Wenn alle Benutzer automatisch erstellt werden sollen, geben Sie `.*` hier ein.
    * ***Benutzer in Gruppe automatisch erstellen*** - Um nur Benutzer automatisch zu erstellen, die Mitglieder bestimmter Entra-ID-Gruppen sind, geben Sie die Gruppenobjekt-ID(s) in Form eines regulären Ausdrucks (Regex) ein.

{% hint style="info" %}
**Benutzer in Gruppen automatisch erstellen**

* Die **Gruppen-Scope** muss definiert sein. (Das oben definierte Feld Gruppen-Scope)
* **Token-Konfiguration** muss in Entra ID eingerichtet werden (Anweisungen unten).
* Entra ID **Gruppen** für die automatische Erstellung angegeben **müssen auf der VergeOS-Seite erstellt werden** (Anweisungen unten).
* Um die automatische Erstellung basierend auf einer Gruppe durchzuführen, muss das ***Feld Benutzer automatisch erstellen*** **leer sein**
* Mehrere bestimmte Gruppen-IDs können im Format: (ID)|(ID)|(ID) eingegeben werden
  {% endhint %}

18. **Optionen (empfohlen aktiviert):**

* ***Remote-Benutzer aktualisieren:*** - sobald der Benutzer in Entra ID gefunden wurde, aktualisieren Sie den VergeOS-Benutzer *Remote-Benutzername* Feld auf die entsprechende Azure-eindeutige ID.

{% hint style="success" %}
**Durch Aktivieren von „Remote-Benutzer aktualisieren“ kann das VergeOS-System die eindeutige Azure-ID im VergeOS-Benutzerdatensatz speichern (nachdem der Entra-ID-Benutzer zunächst mit den in „Felder für Remote-Benutzer“ definierten Feldern gefunden wurde), sodass der eindeutige Bezeichner anschließend zum Auffinden des Entra-ID-Benutzers verwendet werden kann; dies wird in der Regel empfohlen, da Felder wie die E-Mail-Adresse geändert werden können.**
{% endhint %}

* ***E-Mail-Adresse des Benutzers aktualisieren:*** - Aktualisieren Sie die E-Mail-Adresse des VergeOS-Benutzers, damit sie mit der E-Mail-Adresse in Entra ID übereinstimmt.
* ***Anzeigenamen des Benutzers aktualisieren:*** - Aktualisieren Sie den Anzeigenamen des VergeOS-Benutzers, damit er mit dem Anzeigenamen in Entra ID übereinstimmt.
* ***Gruppenmitgliedschaft aktualisieren:*** - Aktualisieren Sie die Gruppen, denen ein VergeOS-Benutzer angehört. (Damit dies funktioniert, ist ein Gruppen-Scope erforderlich.)

19. **Zusätzliche optionale Felder:** Siehe [**Autorisierungsquellen (Allgemein)**](https://docs.verge.io/run-the-platform/de/authentifizierung/auth-sources-general.md) für Informationen zu zusätzlichen optionalen Feldern.

## Azure-Gruppen zu VergeOS hinzufügen

Die Anbindung an Azure-Gruppen erfordert ein Token in der Entra-ID-App-Registrierung sowie das Erstellen von Gruppen in VergeOS:

### Richten Sie eine Token-Konfiguration in Entra ID ein

1. Navigieren Sie zur **Seite für App-Registrierungen** für die oben erstellte App.
2. Klicken Sie auf **Token-Konfiguration** im linken Menü und klicken Sie auf **+ Gruppen-Claim hinzufügen**.
3. Aktivieren Sie die entsprechenden **Gruppentypen**.
4. Setzen Sie die **ID, Access und SAML auf sAMAccountName**.

![azure-editgroupsclaim.pn](https://1073138757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-24b1f0220d3e8fb693bfde10d1a6b8bc186f1012%2Fazure-editgroupsclaim.png?alt=media)

### Schritte zum Hinzufügen von Azure-Gruppen

1. Navigieren Sie zu **System > Gruppen.**
2. Klicken Sie auf **Neu** im linken Menü.
3. Geben Sie die Gruppe ***Name*** ein, damit sie mit dem Gruppennamen in Entra ID übereinstimmt.
4. Optional kann eine ***E-Mail*** für die Gruppe eingetragen werden. Diese E-Mail-Adresse wird zum Senden von Abonnementbenachrichtigungen und/oder Berichten verwendet, die der Gruppe zugewiesen sind.
5. Kopieren Sie die zugehörige **Objekt-ID** von der Seite Gruppen/Alle Gruppen in Entra ID in das ***Kennung*** Feld.
6. Klicken Sie auf **Absenden** (am unteren Rand der Seite), um die neue Gruppe zu speichern.

![azure-groupspage.png](https://1073138757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-82bed5065e0cf17ab7b46e6fd3b73037e16cfc40%2Fazure-groupspage.png?alt=media)

![azure-creategroup.png](https://1073138757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-df56aab13c11b1297fa9c58d855f1404cd45c165%2Fazure-creategroup.png?alt=media)

## Benutzer manuell aus Azure hinzufügen

Nachdem die Azure-Authentifizierungsquelle erstellt wurde, können Benutzer in VergeOS manuell erstellt werden, um die Autorisierungsquelle für die Anmeldeauthentifizierung zu verwenden. Das manuelle Erstellen von Benutzern ist nur erforderlich, wenn Benutzer nicht für die automatische Erstellung konfiguriert sind.

### VergeOS-Benutzer hinzufügen, die Entra-ID-Authentifizierung verwenden

Verwenden Sie beim Erstellen des neuen Benutzers die folgende Konfiguration:

* ***Autorisierungsquelle:*** Wählen Sie die Entra-ID-Quelle aus der Dropdown-Liste aus
* ***Benutzername:*** eindeutiger Name innerhalb des VergeOS-Systems; in der Regel wird empfohlen, den Azure-Prinzipalnamen zu verwenden.
* ***Remote-Benutzername:*** verwenden Sie den Wert eines der Felder, die definiert sind als *Felder für Remote-Benutzer* dies sind Felder, in denen in Azure gesucht wird (z. B. Benutzername, E-Mail)
* ***Anzeigename:*** (optional) Wenn *Anzeigenamen des Benutzers aktualisieren* in der Entra-ID-Authentifizierungsquelle aktiviert ist, wird der Anzeigename automatisch mit Entra ID synchronisiert.
* ***E-Mail-Adresse:*** (optional) Wenn *E-Mail-Adresse des Benutzers aktualisieren* in der Entra-ID-Authentifizierungsquelle aktiviert ist, wird die E-Mail-Adresse automatisch mit Entra ID synchronisiert.

![azure-newuser.png](https://1073138757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-542e4c78a054f2f87e170465de77547161eb9ae2%2Fazure-newuser.png?alt=media)


---

# 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.verge.io/run-the-platform/de/authentifizierung/azure-auth.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.
