Samouczek: przypisanie roli Czytelnika katalogu do grupy Microsoft Entra oraz zarządzanie nimi

Dotyczy:Azure SQL DatabaseAzure 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

Przypisywanie roli Czytelnika katalogów przy użyciu Azure Portal

Tworzenie nowej grupy i przypisywanie właścicieli i roli

  1. Użytkownik z uprawnieniami administratora ról uprzywilejowanych jest wymagany do tej wstępnej konfiguracji.
  2. Zaloguj się do portalu Azure jako uprzywilejowany użytkownik.
  3. Przejdź do zasobu Microsoft Entra ID . W obszarze Zarządzanie przejdź do pozycji Grupy. Wybierz pozycję Nowa grupa , aby utworzyć nową grupę.
  4. 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.
  5. 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.
  6. 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.

Zrzut ekranu przedstawiający okienko Grupa z linkami, które otwierają menu Ustawienia dla ról: Członkowie, Właściciele i Przypisane, które są wyróżnione.

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.

  1. 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.

  2. Znajdź nazwę zasobu wystąpienia zarządzanego SQL w witrynie Azure Portal.

    Zrzut ekranu przedstawiający ekran zarządzanych wystąpień SQL z nazwą wystąpienia SQL ssomitest i nazwą podsieci ManagedInstance.

    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.

    Zrzut ekranu przedstawiający stronę aplikacji dla przedsiębiorstw zasobu Microsoft Entra ID z wyróżnionym Identyfikatorem obiektu zarządzanego wystąpienia SQL.

  3. 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.

  1. 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.Authentication
    
  2. Połącz się ze swoim kontem dzierżawy Microsoft Entra.

    Connect-MgGraph
    
  3. Utwórz grupę zabezpieczeń, aby przypisać rolę Czytelnicy katalogu.

    • DirectoryReaderGroup, Directory Reader Groupi DirRead można zmienić zgodnie z preferencjami.
    $group = New-MgGroup -DisplayName "DirectoryReaderGroup" -Description "Directory Reader Group" -SecurityEnabled:$true -IsAssignableToRole:$true -MailEnabled:$false -MailNickname "DirRead"
    $group
    
  4. 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
    $roleAssignment
    
  5. Przypisz 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.Id
    

    Możesz również zweryfikować właścicieli grupy w witrynie Azure Portal. Wykonaj kroki opisane w artykule Sprawdzanie utworzonej grupy.

Przypisywanie jednostki usługi jako członka grupy

W kolejnych krokach użytkownik administrator ról uprzywilejowanych nie jest już potrzebny.

  1. 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-MgGraph
    
  2. Przypisz jednostkę usługi jako członka utworzonej 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.Id
    

    Nastę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)'"
    

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.