> For the complete documentation index, see [llms.txt](https://docs.blockbrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockbrain.ai/de/for-admins/classic-microsoft-integrations/entra-id-integration.md). # Entra-ID-Integration Dieser Leitfaden bietet eine Schritt-für-Schritt-Anleitung zur Integration von Microsoft Azure Active Directory (AD) als Identitätsanbieter mit Blockbrain Auth und vereinfacht so die Registrierung und Anmeldung. ## 1. Azure AD-Konfiguration Sie benötigen Zugriff auf einen Azure AD-Mandanten. Falls Sie noch keinen haben, folgen Sie [dieser Anleitung von Microsoft](https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-create-new-tenant) um kostenlos einen zu erstellen. ## 2. Einen neuen Client registrieren 1. Navigieren Sie zu den [Dialog zum Erstellen einer App-Registrierung](https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/CreateApplicationBlade/quickStartType~/null/isMSAApp~/false) um eine neue App zu erstellen. 2. Geben Sie der Anwendung einen Namen und wählen Sie aus, wer sich anmelden können soll (Single-Tenant, Multi-Tenant, Persönliche Konten usw.). Diese Einstellung hat auch Einfluss darauf, wie der Anbieter später in Blockbrain Auth konfiguriert wird. 3. Wählen Sie im Feld für die Redirect-URI „Web“ aus und fügen Sie die URL hinzu: `https://auth.theblockbrain.ai/ui/login/login/externalidp/callback`

4. Speichern Sie die **`Anwendungs-(Client-)ID`** und die **`Verzeichnis-(Mandanten-)ID`** von der Detailseite.

## 3. Ein neues Client-Geheimnis generieren 1. Klicken Sie auf der Detailseite der Anwendung auf Client-Anmeldeinformationen oder verwenden Sie das Menü **`Zertifikate & Geheimnisse`** 2. Klicken Sie auf **`+ Neues Client-Geheimnis`** und geben Sie eine Beschreibung sowie ein Ablaufdatum ein, fügen Sie anschließend das Geheimnis hinzu 3. Kopieren Sie den **Wert des Geheimnisses** und bewahren Sie ihn an einem sicheren Ort (Passwort-Manager) für die spätere Verwendung auf. > Sie werden den Wert in Zukunft in Azure nicht erneut sehen können. \ > Wenn Sie Ihr Geheimnis verlieren oder das Geheimnis abläuft, müssen Sie ein neues Geheimnis erstellen.

## 4. Das Auth-Token konfigurieren 1. Klicken Sie auf **`Token-Konfiguration`** im Seitenmenü 2. Klicken Sie auf **`+ Optionalen Anspruch hinzufügen`** 3. Hinzufügen **`E-Mail`**, **`Nachname`**, **`Vorname`** und **`Bevorzugter Benutzername`** zum **`ID`** Token

## 5. API-Berechtigungen festlegen 1. Gehen Sie zu **`API-Berechtigungen`** im Seitenmenü 2. Stellen Sie sicher, dass die Berechtigungen „Microsoft Graph“ enthalten: **`E-Mail`**, **`Profil`** und **`User.Read`**

## 6. Entra-ID in Blockbrain einrichten 1. Gehen Sie zum **`Integrations`** Bereich in den **`Admin`** Einstellungen.

2. Klicken Sie auf den **`Verbinden`** Schaltfläche für EntraId mit den folgenden Einstellungen.

## 7. Weitere gewährte Berechtigungen hinzufügen OpenID-Autorisierung ist essenziell, um das OpenID-Connect-Protokoll zu aktivieren. Dieses Protokoll ist besonders wichtig für die Verwaltung von Benutzeranmeldungen und das Ausstellen von ID-Tokens in Anwendungen. > Im Kontext der App-Registrierung beziehen sich „weitere Berechtigungen“ auf die spezifischen Zugriffsrechte oder „Scopes“, die von einer Anwendung benötigt werden. Diese Scopes bestimmen, auf welche Daten und Funktionen die Anwendung im Namen des Benutzers zugreifen kann. 1. Benutzerzustimmung: Bei der ersten Anmeldung des Benutzers werden diese aufgefordert, diese Berechtigungen zu erteilen. Dieser Schritt ist entscheidend, um die Zustimmung des Benutzers und die Sicherheitsanforderungen zu gewährleisten. \ **Je nach Ihrer Organisationskonfiguration ist möglicherweise eine Administrationszustimmung erforderlich**.

Azure-Berechtigungszustimmungsbildschirm

2. Nachdem die Zustimmung erteilt wurde, werden die Berechtigungen aktiv und in der App-Registrierung aufgeführt - die Anmeldung ist nun möglich, die Anwendung verfügt über die erforderlichen Zugriffsrechte. 1. Unter „Andere gewährte Berechtigungen“ sollte „Microsoft Graph: **`openid`**"

--- # 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.blockbrain.ai/de/for-admins/classic-microsoft-integrations/entra-id-integration.md?ask=&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.