Installation und Konfiguration
Microsoft Azure Principal Resolution Service

Einleitung

Mithilfe des Microsoft Azure Principal Resolution Service können Gruppen in Microsoft Azure aufgelöst werden. Diese Gruppen werden von vielen Microsoft Services verwendet, z.B. SharePoint Online, Teams oder Stream. Falls Sie einen Konnektor für eine dieser Datenquellen eingerichtet haben, sollten Sie auch den Microsoft Azure Principal Resolution Service verwenden.

Hinweis: Microsoft Entra ID (ME-ID) ist der neue Name für Microsoft Azure Active Directory (Azure AD). Die Verwaltung ihrer Microsoft Graph Instanz können Sie hier vornehmen: Microsoft Entra - Microsoft Entra admin center.

Für mehr Informationen, was Microsoft Entra ID ist oder welche Änderungen es bei Azure Active Directory zu beachten gibt, siehe What is Microsoft Entra ID? - Microsoft Entra | Microsoft Learn und New name for Azure Active Directory - Microsoft Entra | Microsoft Learn.

Voraussetzungen

Damit der Principal Resolution Service Gruppen von Microsoft Azure auflösen kann, wird eine neue oder bestehende Microsoft Azure Applikation benötigt, die Berechtigungen zum Auslesen von Microsoft Azure Gruppen hat.

Die Microsoft Azure Applikation muss folgende Voraussetzungen erfüllen:

• Verfügbares Secret
  • Eine Gültigkeitsdauer von 6 bis 12 Monaten wird empfohlen, damit das Secret regelmäßig gewechselt wird.
  • Achtung: Beachten Sie bei der Erzeugung des Client Secrets, dass das Secret in der Spalte „Value“ für die Erstellung des Credentials in Mindbreeze InSpire zwingend notwendig ist. Notieren Sie sich diesen Wert direkt nach der Erzeugung des Client Secrets, da der Wert beim Verlassen des Bereiches nicht mehr vollständig angezeigt wird.
• Erteilte Zugriffsrechte
  • Group.Read.All
  • User.Read.All

Die Erstellung einer neuen Applikation wird in Microsoft Entra - Microsoft Entra admin center durchgeführt. Für mehr Informationen, siehe folgende Links:

• Registrierung einer neuen Applikation: How to register an app in Microsoft Entra ID - Microsoft identity platform | Microsoft Learn
• Erzeugung eines Client Secret: Add and manage app credentials in Microsoft Entra ID - Microsoft identity platform | Microsoft Learn
• Vergabe der Zugriffsrechte: Web API app registration and API permissions - Microsoft identity platform | Microsoft Learn

Konfiguration

In diesem Kapitel wird die Konfiguration des notwendigen Principal Resolution Service in einem Schnellstart-Guide erklärt. Sollten Sie zusätzliche Informationen dazu benötigen, was ein Principal Resolution Service ist,  wie die grundlegende Konfigurieren des Cache ausgeführt wird und welche Konfigurationsoptionen es noch gibt, gehen Sie bitte zu Installation & Konfiguration - Caching Principal Resolution Service.

Schnellstart-Guide

Schritt 1: Erstellung des Principal Resolution Service

Im Tab „Indices“, nutzen Sie einen bestehenden Service oder erstellen Sie einen neuen Service mit den folgenden Einstellungen:

Schritt 2: Erstellung des Credentials

Als nächstes wird ein passendes Credential benötigt. Sollten Sie bereits ein Credential konfiguriert haben mit dem passenden „Access Token URL“, „Client ID“ und „Client Secret“, können Sie dieses Credential verwenden. Ist dies nicht der Fall, muss ein neues Credential im „Netzwerk“ Tab mit den folgenden Einstellungen erstellt werden:

Hinweis: Den „Access Token URL“ und die „Client ID“ finden Sie im Microsoft Entra admin center in ihrer erstellten Applikation. Klicken Sie auf „Overview“ in der Seitennavigation. Die Client ID finden Sie als „Application (client) ID“ im Bereich „Essentials“. Den Access Token URL finden Sie durch das Öffnen von „Endpoints“ als „OAuth 2.0 token endpoint (v2)“ (siehe Screenshot).

Schritt 3: Principal Resolution Service mit der erstellten Applikation und dem Credential verknüpfen

Nachdem das Credential erstellt wurde, gehen Sie zurück zu ihrem erstellten Service im „Indices“ Tab. Im Bereich „Connection Settings“ sind nun folgende Einstellungen notwendig:

Hinweis: Die „Tenant ID“ und „App ID“ können beide im „Overview“ ihrer Applikation gefunden werden. Im Bereich „Essentials“ ist die Tenant ID als „Directory (tenant) ID“ und die App ID als „Application (client) ID“ zu finden. Beachten Sie hierbei, dass die App ID in ihrem Service und die Client ID des erstellten Credentials identisch sein sollte.

Schritt 4: Index mit Principal Resolution Service verknüpfen

Abschließend muss der erstellte Principal Resolution Service nun mit dem gewünschten Index verbunden werden. Öffnen Sie dazu den Index und gehen Sie zum Abschnitt „Data Sources“. Stellen Sie folgendes ein:

Speichern Sie als letzten Schritt ihre durchgeführten Änderungen. Der Microsoft Azure Principal Resolution Service ist nun mit ihrer Applikation verbunden und vollständig konfiguriert.

Verfügbare Einstellungen

Bereich „Connection Settings“