Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für:Azure SQL-Datenbank
Azure 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
- Ein Microsoft Entra-Mandant. Weitere Informationen finden Sie unter Konfigurieren und Verwalten der Microsoft Entra-Authentifizierung mit Azure SQL.
- Eine Azure SQL-Datenbank oder Azure SQL Managed Instance.
Zuweisen der Rolle „Verzeichnisleseberechtigte“ über das Azure-Portal
Erstellen einer neuen Gruppe und Zuweisen von Besitzern und Rolle
- Ein Benutzer mit Berechtigungen für privilegierte Rollenadministratoren ist für diese ersteinrichtung erforderlich.
- Bitten Sie den privilegierten Benutzer, sich beim Azure-Portal anzumelden.
- 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.
- 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.
- 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.
- 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.
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.
Melden Sie sich beim Azure-Portal als der Benutzer an, der die SQL Managed Instance verwaltet und Eigentümer der zuvor erstellten Gruppe ist.
Suchen Sie im Azure-Portal nach dem Namen Ihrer Ressource vom Typ SQL Managed Instance.
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.
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.
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.AuthenticationStellen Sie eine Verbindung zu Ihrem Microsoft Entra-Mandanten her.
Connect-MgGraphErstellen Sie eine Sicherheitsgruppe, um die Rolle Verzeichnisleseberechtigte zuzuweisen.
-
DirectoryReaderGroup,Directory Reader GroupundDirReadkönnen nach Belieben geändert werden.
$group = New-MgGroup -DisplayName "DirectoryReaderGroup" -Description "Directory Reader Group" -SecurityEnabled:$true -IsAssignableToRole:$true -MailEnabled:$false -MailNickname "DirRead" $group-
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 $roleAssignmentWeisen 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.IdDie Besitzer der Gruppe können auch im Azure-Portal überprüft werden. Gehen Sie dazu wie unter Überprüfen der erstellten Gruppe beschrieben vor.
- Ersetzen Sie
Weisen Sie den Service-Auftrag als Mitglied der Gruppe
Für nachfolgende Schritte ist der Benutzer des Privilegierten Rollenadministrators nicht mehr erforderlich.
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-MgGraphWeisen Sie den Dienstprinzipal als Mitglied der erstellten Gruppe zu.
- Ersetzen Sie
<ServerName>durch den Namen Ihres logischen Servers oder Ihrer verwalteten Instanz. Weitere Informationen finden Sie im Abschnitt Hinzufügen einer verwalteten Azure SQL-Identität zur Gruppe.
# 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.IdDer 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)'"- Ersetzen Sie
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.