Tutorial: Zuweisen der Rolle „Verzeichnisleseberechtigte“ zu einer Microsoft Entra-Gruppe und Verwalten von Rollenzuweisungen

Gilt für:Azure SQL-DatenbankAzure SQL Managed Instance

In diesem Artikel erfahren Sie, wie Sie eine Gruppe in Microsoft Entra ID (früher Azure Active Directory) erstellen und dieser Gruppe die Rolle Verzeichnisleseberechtigte zuweisen. Die Verzeichnisleser-Berechtigungen erlauben es den Gruppeneigentümern, weitere Mitglieder zur Gruppe hinzuzufügen, wie etwa eine verwaltete Identität der Azure SQL-Datenbank und Azure SQL Managed Instance. Dadurch wird die Notwendigkeit umgangen, dass ein Administrator mit privilegierter Rolle die Rolle "Verzeichnisleser" direkt für jede logische Serveridentität im Mandanten zuweist.

Hinweis

Microsoft Entra ID war zuvor als Azure Active Directory (Azure AD) bekannt.

Dieses Tutorial verwendet das Feature, das in Verwenden von Microsoft Entra-Gruppen zum Verwalten von Rollenzuweisungen eingeführt wurde.

Weitere Informationen zu den Vorteilen, die das Zuweisen der Rolle „Verzeichnisleseberechtigte“ zu einer Microsoft Entra-Gruppe für Azure SQL mit sich bringt, finden Sie unter Rolle „Verzeichnisleseberechtigte“ in Microsoft Entra ID für Azure SQL.

Hinweis

Bei Microsoft Graph-Unterstützung für Azure SQL kann die Rolle „Verzeichnisleseberechtigte“ durch die Verwendung von Berechtigungen auf niedrigerer Ebene ersetzt werden. Weitere Informationen finden Sie unter Verwaltete Identitäten in Microsoft Entra für Azure SQL.

Voraussetzungen

Zuweisen der Rolle „Verzeichnisleseberechtigte“ über das Azure-Portal

Erstellen einer neuen Gruppe und Zuweisen von Besitzern und Rolle

  1. Ein Benutzer mit Berechtigungen für privilegierte Rollenadministratoren ist für diese ersteinrichtung erforderlich.
  2. Bitten Sie den privilegierten Benutzer, sich beim Azure-Portal anzumelden.
  3. Gehen Sie zur Microsoft Entra ID-Ressource. Wechseln Sie unter "Verwalten" zu "Gruppen". Wählen Sie Neue Gruppe aus, um eine neue Gruppe zu erstellen.
  4. Wählen Sie als Gruppentyp die Option Sicherheit aus, und füllen Sie die restlichen Felder aus. Achten Sie darauf, dass die Einstellung Microsoft Entra-Rollen können der Gruppe zugewiesen werden auf Ja festgelegt ist. Weisen Sie der Gruppe als Nächstes die Microsoft Entra ID-Rolle Verzeichnisleseberechtigte zu.
  5. Weise Microsoft Entra-Nutzer der von dir erstellten Gruppe als Besitzer zu. Ein Gruppenbesitzer kann ein regulärer AD-Benutzer ohne Microsoft Entra-Administratorrolle sein. Der Besitzer sollte ein Benutzer sein, der deine SQL-Datenbank oder SQL Managed Instance verwaltet.
  6. Wählen Sie Erstellen aus

Überprüfen Sie die Gruppe, die erstellt wurde

Hinweis

Vergewissern Sie sich, dass der Gruppentyp auf Sicherheit festgelegt ist. Microsoft 365-Gruppen werden für Azure SQL nicht unterstützt.

Navigieren Sie zum Überprüfen und Verwalten der erstellten Gruppe im Azure-Portal wieder zum Bereich Gruppen, und suchen Sie nach dem Gruppennamen. Weitere Besitzer und Mitglieder können nach dem Auswählen der Gruppe unter der Einstellung Verwalten über das Menü Besitzer bzw. Mitglieder hinzugefügt werden. Unter Zugewiesene Rollen können Sie außerdem die zugewiesenen Rollen der Gruppe überprüfen.

Screenshot des Gruppenbereichs mit den Links, über die die Menüs „Einstellungen“ für die hervorgehobenen Rollen „Mitglieder“, „Besitzer“ und „Zugewiesene Rollen“ geöffnet werden

Hinzufügen einer verwalteten Azure SQL-Identität zur Gruppe

Hinweis

Dieser Artikel verwendet SQL Managed Instance als Beispiel, aber Sie können ähnliche Schritte für SQL Database anwenden, um die gleichen Ergebnisse zu erzielen.

Für nachfolgende Schritte ist der Benutzer des Privilegierten Rollenadministrators nicht mehr erforderlich.

  1. Melden Sie sich beim Azure-Portal als der Benutzer an, der die SQL Managed Instance verwaltet und Eigentümer der zuvor erstellten Gruppe ist.

  2. Suchen Sie im Azure-Portal nach dem Namen Ihrer Ressource vom Typ SQL Managed Instance.

    Screenshot des Bildschirms der SQL-verwalteten Instanzen mit dem SQL-Instanznamen

    Während der Bereitstellung von SQL Managed Instance wird eine Microsoft Entra-Identität für Ihre Instanz erstellt und als Microsoft Entra-Anwendung registriert. Die Identität hat den gleichen Namen wie das Präfix Ihres SQL Managed Instance-Namens. Sie finden die Identität (auch als „Dienstprinzipal“ bezeichnet) für Ihre SQL Managed Instance wie folgt:

    • Gehen Sie zur Microsoft Entra ID-Ressource. Wählen Sie unter der Einstellung Verwalten die Option Unternehmensanwendungen aus. Die Objekt-ID ist die Identität der Instanz.

    Screenshot: Seite „Unternehmensanwendungen“ für eine Microsoft Entra ID-Ressource mit hervorgehobener Objekt-ID der verwalteten SQL-Instanz.

  3. Gehen Sie zur Microsoft Entra ID-Ressource. Wechseln Sie unter "Verwalten" zu "Gruppen". Wählen Sie die von Ihnen erstellte Gruppe aus. Wählen Sie unter der Einstellung "Verwalten" Ihrer Gruppe "Mitglieder" aus. Wählen Sie Mitglieder hinzufügen aus, und fügen Sie Ihren SQL Managed Instance-Dienstprinzipal als Gruppenmitglied hinzu, indem Sie nach dem oben gefundenen Namen suchen.

Hinweis

Es kann einige Minuten dauern, bis die Dienstprinzipalberechtigungen über das Azure-System verteilt und der Zugriff auf Microsoft Graph ermöglicht wird. Möglicherweise müssen Sie einige Minuten warten, bevor Sie einen Microsoft Entra-Administrator für die verwaltete SQL-Instanz bereitstellen.

Hinweise

Für die SQL-Datenbank erstelle die Serveridentität während der Erstellung des logischen Servers oder nachdem du den Server erstellt hast. Weitere Informationen zum Erstellen oder Festlegen der Serveridentität in der SQL-Datenbank finden Sie unter Aktivieren von Dienstprinzipalen zum Erstellen von Microsoft Entra-Benutzern.

Bei SQL Managed Instance muss die Rolle Verzeichnisleseberechtigte der Identität der verwalteten Instanz zugewiesen werden, damit Sie einen Microsoft Entra-Administrator für die verwaltete Instanz einrichten können.

Sie müssen die Rolle Verzeichnisleser nicht der Serveridentität für SQL Database zuweisen, wenn Sie einen Microsoft Entra-Administrator für den logischen Server einrichten. Um jedoch die Erstellung von Microsoft Entra-Objekten in SQL-Datenbank im Auftrag einer Microsoft Entra-Anwendung zu ermöglichen, ist die Rolle Verzeichnisleser (oder niedrigere Berechtigungen, die in Verwaltete Identitäten in Microsoft Entra für Azure SQL besprochen werden) erforderlich. Wenn du die Rolle nicht der logischen Server-Identität zuweist, schlägt das Erstellen von Microsoft Entra-Benutzern in Azure SQL fehl. Weitere Informationen finden Sie unter Microsoft Entra-Dienstprinzipale mit Azure SQL.

Zuweisen der Rolle „Verzeichnisleseberechtigte“ mithilfe von PowerShell

Wichtig

Ein Administrator für privilegierte Rollen muss diese ersten Schritte ausführen. Neben PowerShell bietet Microsoft Entra ID die Microsoft Graph-API zum Erstellen einer Gruppe, der Rollen zugewiesen werden können, in Microsoft Entra ID.

  1. Laden Sie das Microsoft Graph PowerShell-Modul mithilfe der folgenden Befehle herunter. Möglicherweise müssen Sie PowerShell als Administrator ausführen.

    Install-Module Microsoft.Graph.Authentication
    Import-Module Microsoft.Graph.Authentication
    # To verify that the module is ready to use, run the following command:
    Get-Module Microsoft.Graph.Authentication
    
  2. Stellen Sie eine Verbindung zu Ihrem Microsoft Entra-Mandanten her.

    Connect-MgGraph
    
  3. Erstellen Sie eine Sicherheitsgruppe, um die Rolle Verzeichnisleseberechtigte zuzuweisen.

    • DirectoryReaderGroup, Directory Reader Group und DirRead können nach Belieben geändert werden.
    $group = New-MgGroup -DisplayName "DirectoryReaderGroup" -Description "Directory Reader Group" -SecurityEnabled:$true -IsAssignableToRole:$true -MailEnabled:$false -MailNickname "DirRead"
    $group
    
  4. Weisen Sie der Gruppe die Rolle Verzeichnisleseberechtigte zu.

    # Displays the Directory Readers role information
    $roleDefinition = Get-MgRoleManagementDirectoryRoleDefinition -Filter "DisplayName eq 'Directory Readers'"
    $roleDefinition
    
    # Assigns the Directory Readers role to the group
    $roleAssignment = New-MgRoleManagementDirectoryRoleAssignment -DirectoryScopeId '/' -RoleDefinitionId $roleDefinition.Id -PrincipalId $group.Id
    $roleAssignment
    
  5. Weisen Sie der Gruppe Besitzende zu.

    • Ersetzen Sie <username> durch den Benutzer, der als Besitzer dieser Gruppe fungieren soll. Falls Sie mehrere Besitzer hinzufügen möchten, können Sie diese Schritte wiederholen.
    $newGroupOwner = Get-MgUser -UserId "<username>"
    $newGroupOwner
    
    $GrOwner = New-MgGroupOwnerByRef -GroupId $group.Id -OdataId "https://graph.microsoft.com/v1.0/users/$($newGroupOwner.Id)" 
    

    Überprüfen Sie die Besitzenden der Gruppe:

    Get-MgGroupOwner -GroupId $group.Id
    

    Die Besitzer der Gruppe können auch im Azure-Portal überprüft werden. Gehen Sie dazu wie unter Überprüfen der erstellten Gruppe beschrieben vor.

Weisen Sie den Service-Auftrag als Mitglied der Gruppe

Für nachfolgende Schritte ist der Benutzer des Privilegierten Rollenadministrators nicht mehr erforderlich.

  1. Führen Sie über ein Besitzerkonto der Gruppe, mit dem auch die Azure SQL-Ressource verwaltet wird, den folgenden Befehl aus, um eine Verbindung mit Ihrer Microsoft Entra ID-Instanz herzustellen.

    Connect-MgGraph
    
  2. Weisen Sie den Dienstprinzipal als Mitglied der erstellten Gruppe zu.

    # Returns the service principal of your Azure SQL resource
    $managedIdentity = Get-MgServicePrincipal -Filter "displayName eq '<ServerName>'"
    $managedIdentity
    
    # Adds the service principal to the group
    New-MgGroupMember -GroupId $group.Id -DirectoryObjectId $managedIdentity.Id
    

    Der folgende Befehl gibt die Objekt-ID des Dienstprinzipals zurück, was bedeutet, dass er der Gruppe hinzugefügt wurde:

    Get-MgGroupMember -GroupId $group.Id -Filter "Id eq '$($managedIdentity.Id)'"
    

Assign Directory Readers role in Azure Synapse Analytics

Für Azure Synapse Analytics siehe Tutorial: Assign Directory Readers role to a Microsoft Entra Group and manage role assignments.