빠른 시작: .NET Core를 사용하여 관리 그룹 만들기

아티클
10/16/2024

관리 그룹은 여러 구독에서 액세스, 정책 및 규정 준수를 관리하는 데 도움이 되는 컨테이너입니다. 이러한 컨테이너를 만들어 Azure 정책 및 Azure 역할 기반 액세스 제어와 함께 사용할 수 있는 효과적이고 효율적인 계층을 구축합니다. 관리 그룹에 대한 자세한 내용은 Azure 관리 그룹으로 리소스 구성을 참조하세요.

디렉터리에서 만드는 첫 번째 관리 그룹을 완료하려면 최대 15분이 소요될 수 있습니다. 디렉터리에 대해 Azure 내의 관리 그룹 서비스를 설정하기 위해 처음으로 실행되는 프로세스가 있습니다. 프로세스가 완료되면 알림이 수신됩니다. 자세한 내용은 관리 그룹의 초기 설정을 참조하세요.

필수 조건

Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
clientId 및 clientSecret을 포함하는 Azure 서비스 주체. Azure Policy에 사용할 서비스 주체가 없거나 새로 만들려면 .NET 인증을 위한 Azure 관리 라이브러리를 참조하세요. .NET Core 패키지를 설치하는 단계는 건너뜁니다. 다음 단계에서 수행할 것입니다.
계층 보호가 사용하도록 설정되지 않은 경우 테넌트의 모든 Microsoft Entra ID 사용자는 해당 사용자에게 할당된 관리 그룹 쓰기 권한 없이 관리 그룹을 만들 수 있습니다. 이 새 관리 그룹은 루트 관리 그룹 또는 기본 관리 그룹의 자식이 되고 작성자는 소유자 역할을 할당 받습니다. 관리 그룹 서비스는 이 기능을 허용하므로 루트 수준에서 역할 할당이 필요하지 않습니다. 루트 관리 그룹이 생성되면 사용자는 해당 그룹에 액세스할 수 없습니다. 관리 그룹 사용을 시작하려면 서비스를 통해 루트 수준에서 초기 관리 그룹을 만들 수 있습니다. 자세한 내용은 각 디렉터리의 루트 관리 그룹을 참조하세요.

Azure Cloud Shell

Azure는 브라우저를 통해 사용할 수 있는 대화형 셸 환경인 Azure Cloud Shell을 호스트합니다. Cloud Shell에서 Bash 또는 PowerShell을 사용하여 Azure 서비스 작업을 수행할 수 있습니다. 로컬 환경에 아무 것도 설치할 필요 없이 Azure Cloud Shell의 미리 설치된 명령을 사용하여 이 문서의 코드를 실행할 수 있습니다.

Azure Cloud Shell을 시작하려면 다음을 수행합니다.

옵션	예제/링크
코드 또는 명령 블록의 오른쪽 상단에서 시도를 선택합니다. 시도를 선택해도 코드 또는 명령이 Cloud Shell에 자동으로 복사되지 않습니다.
https://shell.azure.com으로 이동하거나 Cloud Shell 시작 단추를 선택하여 브라우저에서 Cloud Shell을 엽니다.
Azure Portal의 오른쪽 위에 있는 메뉴 모음에서 Cloud Shell 단추를 선택합니다.

Azure Cloud Shell을 사용하려면:

Cloud Shell을 시작합니다.
코드 블록(또는 명령 블록)에서 복사 단추를 선택하여 코드 또는 명령을 복사합니다.
Windows 및 Linux에서 Ctrl+Shift+V를 선택하거나 macOS에서 Cmd+Shift+V를 선택하여 코드 또는 명령을 Cloud Shell 세션에 붙여넣습니다.
Enter를 선택하여 코드 또는 명령을 실행합니다.

애플리케이션 설정

.NET Core를 사용하여 관리 그룹을 관리하려면 새 콘솔 애플리케이션을 만들고 필요한 패키지를 설치합니다.

최신 .NET Core가 설치되었는지 확인합니다(3.1.8 이상). 아직 설치되지 않았으면 dotnet.microsoft.com에서 다운로드합니다.
다음과 같이 "mgCreate"라는 새 .NET Core 콘솔 애플리케이션을 초기화합니다.
```
dotnet new console --name "mgCreate"
```

디렉터리를 새 프로젝트 폴더로 변경하고 Azure Policy에 필요한 패키지를 설치합니다.

# Add the Azure Policy package for .NET Core
dotnet add package Microsoft.Azure.Management.ManagementGroups --version 1.1.1-preview

# Add the Azure app auth package for .NET Core
dotnet add package Microsoft.Azure.Services.AppAuthentication --version 1.6.1

기본 program.cs를 다음 코드로 바꾸고 업데이트된 파일을 저장합니다.

using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Microsoft.IdentityModel.Clients.ActiveDirectory;
using Microsoft.Rest;
using Microsoft.Azure.Management.ManagementGroups;
using Microsoft.Azure.Management.ManagementGroups.Models;

namespace mgCreate
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string strTenant = args[0];
            string strClientId = args[1];
            string strClientSecret = args[2];
            string strGroupId = args[3];
            string strDisplayName = args[4];

            var authContext = new AuthenticationContext($"https://login.microsoftonline.com/{strTenant}");
            var authResult = await authContext.AcquireTokenAsync(
                   "https://management.core.windows.net",
                   new ClientCredential(strClientId, strClientSecret));

            using (var client = new ManagementGroupsAPIClient(new TokenCredentials(authResult.AccessToken)))
            {
                var mgRequest = new CreateManagementGroupRequest
                {
                    DisplayName = strDisplayName
                };
                var response = await client.ManagementGroups.CreateOrUpdateAsync(strGroupId, mgRequest);
            }
        }
    }
}

mgCreate 콘솔 애플리케이션을 빌드하고 게시합니다.
```
dotnet build
dotnet publish -o {run-folder}
```

관리 그룹 만들기

이 빠른 시작에서는 루트 관리 그룹에 새 관리 그룹을 만듭니다.

디렉터리를 이전에 dotnet publish 명령을 사용하여 정의한 {run-folder}로 변경합니다.

터미널에서 다음 명령을 입력합니다.

mgCreate.exe `
   "{tenantId}" `
   "{clientId}" `
   "{clientSecret}" `
   "{groupID}" `
   "{displayName}"

이 명령은 다음 정보를 사용합니다.

{tenantId} - 테넌트 ID로 대체
{clientId} - 서비스 주체의 클라이언트 ID로 대체
{clientSecret} - 서비스 주체의 클라이언트 암호로 대체
{groupID} - 사용자의 새 관리 그룹 ID로 바꾸기
{displayName} - 사용자의 새 관리 그룹 식별 이름으로 바꾸기

결과적으로 루트 관리 그룹에 새 관리 그룹이 생성됩니다.

리소스 정리

포털을 통해 새 관리 그룹을 삭제합니다.
.NET Core 콘솔 애플리케이션 및 설치된 패키지를 제거하려면 mgCreate 프로젝트 폴더를 삭제합니다.

다음 단계

이 빠른 시작에서는 리소스 계층 구조를 구성하기 위한 관리 그룹을 만들었습니다. 관리 그룹은 구독 또는 기타 관리 그룹을 포함할 수 있습니다.

관리 그룹 및 리소스 계층 구조를 관리하는 방법에 대해 자세히 알아보려면 다음을 계속 진행하세요.

관리 그룹으로 리소스 관리

다음을 통해 공유