Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dotyczy:Azure SQL Database
Azure SQL Managed Instance
Ten artykuł poprowadzi Cię przez tworzenie grupy w usłudze Microsoft Entra ID (dawniej Azure Active Directory) i przypisywanie tej grupie roli Czytelnik katalogu. Uprawnienia Directory Readers pozwalają właścicielom grup na dodawanie kolejnych członków do grupy, takich jak zarządzana tożsamość usługi Azure SQL Database oraz Azure SQL Managed Instance. Pozwala to pominąć konieczność administrator ról uprzywilejowanych przypisać rolę Czytelnicy katalogu bezpośrednio dla każdej tożsamości serwera logicznego w dzierżawie.
Uwaga
Microsoft Entra ID był wcześniej znany jako Azure Active Directory (Azure AD).
W tym samouczku użyto funkcji wprowadzonej w Używanie grup Microsoft Entra do zarządzania rolami.
Aby uzyskać więcej informacji na temat korzyści związanych z przypisywaniem roli Czytelników katalogów do grupy Microsoft Entra dla usługi Azure SQL, zobacz Rola Czytelników katalogów w usłudze Microsoft Entra ID dla usługi Azure SQL.
Uwaga
Dzięki obsłudze programu Microsoft Graph dla usługi Azure SQL rola Czytelników katalogów może zostać zastąpiona przy użyciu uprawnień niższego poziomu. Aby uzyskać więcej informacji, zobacz Tożsamości zarządzane w usłudze Microsoft Entra dla Azure SQL.
Wymagania wstępne
- Dzierżawa Microsoft Entra. Więcej informacji można znaleźć w temacie Konfigurowanie uwierzytelniania usługi Microsoft Entra i zarządzanie nim za pomocą usługi Azure SQL.
- Baza danych Azure SQL lub wystąpienie zarządzane Azure SQL.
Przypisywanie roli Czytelnika katalogów przy użyciu Azure Portal
Tworzenie nowej grupy i przypisywanie właścicieli i roli
- Użytkownik z uprawnieniami administratora ról uprzywilejowanych jest wymagany do tej wstępnej konfiguracji.
- Zaloguj się do portalu Azure jako uprzywilejowany użytkownik.
- Przejdź do zasobu Microsoft Entra ID . W obszarze Zarządzanie przejdź do pozycji Grupy. Wybierz pozycję Nowa grupa , aby utworzyć nową grupę.
- Wybierz pozycję Zabezpieczenia jako typ grupy i wypełnij pozostałe pola. Upewnij się, że ustawienie Role Entra firmy Microsoft można przypisać do grupy jest ustawione na Tak. Następnie przypisz do grupy rolę czytelników katalogu Entra ID firmy Microsoft.
- Przypisz użytkowników Microsoft Entra jako właścicieli do grupy, którą stworzyłeś. Właściciel grupy może być zwykłym użytkownikiem usługi AD bez przypisanej żadnej roli administracyjnej firmy Microsoft Entra. Właścicielem powinien być użytkownik, który zarządza bazą danych SQL lub SQL Managed Instance.
- Wybierz pozycję Utwórz
Sprawdź utworzoną grupę
Uwaga
Upewnij się, że typ grupy to Zabezpieczenia. Grupy platformy Microsoft 365 nie są obsługiwane w przypadku usługi Azure SQL.
Aby sprawdzić utworzoną grupę i zarządzać nią, wróć do okienka Grupy w witrynie Azure Portal i wyszukaj nazwę grupy. Dodatkowi właściciele i członkowie mogą być dodani w menu Właściciele i Członkowie w ustawieniach Zarządzaj, po wybraniu grupy. Możesz również przejrzeć przypisane role dla grupy.
Dodaj tożsamość zarządzaną Azure SQL do grupy
Uwaga
W tym artykule używamy SQL Managed Instance jako przykładu, ale można zastosować podobne kroki dla SQL Database, aby uzyskać te same rezultaty.
W kolejnych krokach użytkownik administrator ról uprzywilejowanych nie jest już potrzebny.
Zaloguj się do portalu Azure jako użytkownik zarządzający usługą SQL Managed Instance, który jest właścicielem utworzonej wcześniej grupy.
Znajdź nazwę zasobu wystąpienia zarządzanego SQL w witrynie Azure Portal.
Podczas aprowizacji wystąpienia SQL Managed Instance tworzony jest identyfikator Microsoft Entra dla tego wystąpienia, co powoduje jego rejestrację jako aplikacji Microsoft Entra. Tożsamość ma taką samą nazwę jak prefiks nazwy wystąpienia zarządzanego SQL. Tożsamość (znaną również jako jednostka usługi) dla wystąpienia zarządzanego SQL można znaleźć, wykonując następujące kroki:
- Przejdź do zasobu Microsoft Entra ID . W obszarze Zarządzaj ustawienie wybierz pozycję Aplikacje dla przedsiębiorstw. Identyfikator obiektu to tożsamość wystąpienia.
Przejdź do zasobu Microsoft Entra ID . W obszarze Zarządzanie przejdź do pozycji Grupy. Wybierz utworzoną grupę. W obszarze Zarządzaj ustawieniem grupy wybierz pozycję Członkowie. Wybierz pozycję Dodaj członków i dodaj jednostkę usługi SQL Managed Instance jako członka grupy, wyszukując nazwę znalezioną powyżej.
Uwaga
Propagacja uprawnień jednostki usługi za pośrednictwem systemu Platformy Azure może potrwać kilka minut i zezwolić na dostęp do programu Microsoft Graph. Zanim aprowizujesz administratora usługi Microsoft Entra dla usługi SQL Managed Instance, może być konieczne odczekanie kilku minut.
Uwagi
W usłudze SQL Database utwórz tożsamość serwera podczas tworzenia logicznego serwera lub po jego utworzeniu. Więcej informacji o tworzeniu lub ustawianiu tożsamości serwera w SQL Database można znaleźć w artykule Włącz jednostki usługi, aby tworzyć użytkowników Microsoft Entra.
W przypadku usługi SQL Managed Instance rola Directory Readers musi być przypisana do tożsamości wystąpienia zarządzanego, zanim będzie można skonfigurować administratora Microsoft Entra dla wystąpienia zarządzanego.
Nie musisz przypisywać roli Directory Readers do tożsamości serwera używanej przez SQL Database podczas konfigurowania administratora Microsoft Entra dla serwera logicznego. Aby jednak umożliwić tworzenie obiektów Microsoft Entra w SQL Database w imieniu aplikacji Microsoft Entra, wymagana jest rola Directory Readers (lub uprawnienia niższego poziomu omówione w Managed identities in Microsoft Entra for Azure SQL). Jeśli nie przypiszesz roli do tożsamości serwera logicznego, tworzenie użytkowników Microsoft Entra w Azure SQL nie powiedzie się. Aby uzyskać więcej informacji, zobacz Microsoft Entra service principals with Azure SQL (Jednostki usługi Microsoft Entra w usłudze Azure SQL).
Przypisywanie roli Czytelników katalogów przy użyciu programu PowerShell
Ważne
Administrator ról uprzywilejowanych będzie musiał uruchomić te początkowe kroki. Oprócz programu PowerShell, Microsoft Entra ID oferuje interfejs API Microsoft Graph do utworzenia grupy z przypisywalnymi rolami w Microsoft Entra ID.
Pobierz moduł Programu PowerShell programu Microsoft Graph przy użyciu następujących poleceń. Może być konieczne uruchomienie programu PowerShell jako administrator.
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.AuthenticationPołącz się ze swoim kontem dzierżawy Microsoft Entra.
Connect-MgGraphUtwórz grupę zabezpieczeń, aby przypisać rolę Czytelnicy katalogu.
-
DirectoryReaderGroup,Directory Reader GroupiDirReadmożna zmienić zgodnie z preferencjami.
$group = New-MgGroup -DisplayName "DirectoryReaderGroup" -Description "Directory Reader Group" -SecurityEnabled:$true -IsAssignableToRole:$true -MailEnabled:$false -MailNickname "DirRead" $group-
Przypisz czytelnikom katalogów rolę do grupy.
# 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 $roleAssignmentPrzypisz właścicieli do grupy.
- Zastąp element
<username>użytkownikiem, którego chcesz, aby był właścicielem tej grupy. Kilka właścicieli można dodać, powtarzając te kroki.
$newGroupOwner = Get-MgUser -UserId "<username>" $newGroupOwner$GrOwner = New-MgGroupOwnerByRef -GroupId $group.Id -OdataId "https://graph.microsoft.com/v1.0/users/$($newGroupOwner.Id)"Sprawdź właścicieli grupy:
Get-MgGroupOwner -GroupId $group.IdMożesz również zweryfikować właścicieli grupy w witrynie Azure Portal. Wykonaj kroki opisane w artykule Sprawdzanie utworzonej grupy.
- Zastąp element
Przypisywanie jednostki usługi jako członka grupy
W kolejnych krokach użytkownik administrator ról uprzywilejowanych nie jest już potrzebny.
Aby połączyć się z Microsoft Entra ID, użyj właściciela grupy, który zarządza także zasobem Azure SQL, i uruchom następujące polecenie.
Connect-MgGraphPrzypisz jednostkę usługi jako członka utworzonej grupy.
- Zastąp
<ServerName>nazwą serwera logicznego lub wystąpienia zarządzanego. Aby uzyskać więcej informacji, zobacz sekcję Dodawanie tożsamości usługi Azure SQL do grupy
# 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.IdNastępujące polecenie zwróci identyfikator obiektu jednostki usługi wskazujący, że został dodany do grupy:
Get-MgGroupMember -GroupId $group.Id -Filter "Id eq '$($managedIdentity.Id)'"- Zastąp
Assign Directory Readers role in Azure Synapse Analytics
W przypadku Azure Synapse Analytics zobacz Samouczek: przypisywanie roli Czytelnicy katalogu do grupy Microsoft Entra i zarządzanie przypisaniami ról.