Azure Data Explorer 클러스터에 대한 관리 ID 구성

Azure Portal을 사용하여 시스템 할당 ID 추가

Azure Portal에 로그인합니다.

새 Azure Data Explorer 클러스터

1. Azure Data Explorer 클러스터 만들기

2. 보안 탭 >시스템 할당 ID에서 켜기를 선택합니다. 시스템 할당 ID를 제거하려면 끄기를 선택합니다.

3. 다음: 태그> 또는 검토 및 만들기를 선택하여 클러스터를 만드십시오.

   

기존 Azure Data Explorer 클러스터

1. 기존 Azure Data Explorer 클러스터를 엽니다.

2. 포털의 왼쪽 창에서 설정>ID 를 선택합니다.

3. Identity 패널의 >시스템 할당 탭:

   1. 상태 슬라이더를 켜기로 이동합니다.
   2. 저장을 선택합니다.
   3. 팝업 창에서 예를 선택합니다.

   

4. 몇 분 후 화면에 다음이 표시됩니다.

   • 개체 ID - 고객 관리형 키에 사용
   • 사용 권한 - 관련 역할 할당 선택

   

C를 사용하여 시스템 할당 ID 추가#

필수 조건

Azure Data Explorer C# 클라이언트를 사용하여 관리 ID를 설정하려면 다음을 수행합니다.

• Azure Data Explorer NuGet 패키지를 설치합니다.
• 인증을 위해 Microsoft.Identity.Client NuGet 패키지를 설치합니다.
• 인증을 위해 Microsoft.Rest.ClientRuntime NuGet 패키지를 설치합니다.
• 리소스에 액세스할 수 있는 Azure AD 애플리케이션 및 서비스 주체를 만듭니다. 구독 범위에서 역할 할당을 추가하고 필요한 Directory (tenant) ID, Application ID 및 Client Secret을 가져옵니다.

클러스터 만들기 또는 업데이트

1. 속성을 사용하여 클러스터를 만들거나 업데이트합니다.Identity

   var tenantId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Directory (tenant) ID
   var clientId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Application ID
   var clientSecret = "PlaceholderClientSecret"; //Client Secret
   var subscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
   
   var authClient = ConfidentialClientApplicationBuilder.Create(clientId)
       .WithAuthority($"https://login.microsoftonline.com/{tenantId}")
       .WithClientSecret(clientSecret)
       .Build();
   var result = authClient.AcquireTokenForClient(new[] { "https://management.core.windows.net/" }).ExecuteAsync().Result;
   var credentials = new TokenCredentials(result.AccessToken, result.TokenType);
   var kustoManagementClient = new KustoManagementClient(credentials) { SubscriptionId = subscriptionId };
   var resourceGroupName = "testrg";
   var clusterName = "mykustocluster";
   var clusterData = new Cluster(
       location: "Central US",
       sku: new AzureSku("Standard_E8ads_v5", "Standard", 5),
       identity: new Identity(IdentityType.SystemAssigned)
   );
   
   await kustoManagementClient.Clusters.CreateOrUpdateAsync(resourceGroupName, clusterName, clusterData);
   

2. 다음 명령을 실행하여 클러스터가 ID로 성공적으로 생성되거나 업데이트되었는지 확인합니다.

   clusterData = await kustoManagementClient.Clusters.GetAsync(resourceGroupName, clusterName);
   

   결과에 값이 ProvisioningStateSucceeded 포함된 경우 클러스터가 만들어지거나 업데이트되었으며 다음 속성이 있어야 합니다.

   var principalGuid = clusterData.Identity.PrincipalId;
   var tenantGuid = clusterData.Identity.TenantId;
   

PrincipalId 및 TenantId가 각각 GUID로 대체됩니다. 이 속성은 TenantId ID가 속한 Azure AD 테넌트를 식별합니다. 클러스터 PrincipalId 의 새 ID에 대한 고유 식별자입니다. Azure AD 내에서 서비스 주체는 App Service 또는 Azure Functions 인스턴스에 지정한 이름과 동일합니다.

Azure Resource Manager 템플릿을 사용하여 시스템 할당 ID 추가

Azure Resource Manager 템플릿을 사용하여 Azure 리소스 배포를 자동화할 수 있습니다. Azure Data Explorer에 배포하는 방법에 대한 자세한 내용은 Azure Resource Manager 템플릿을 사용하여 Azure Data Explorer 클러스터 및 데이터베이스 만들기를 참조하세요.

시스템 할당 형식을 추가하면 Azure에서 클러스터의 ID를 만들고 관리하도록 지시합니다. 모든 Microsoft.Kusto/clusters 유형의 리소스는 ID를 사용하여 리소스 정의에 다음 속성을 포함하는 방법으로 만들 수 있습니다.

{
   "identity": {
      "type": "SystemAssigned"
   }
}

다음은 그 예입니다.

{
    "apiVersion": "2019-09-07",
    "type": "Microsoft.Kusto/clusters",
    "name": "[variables('clusterName')]",
    "location": "[resourceGroup().location]",
    "identity": {
        "type": "SystemAssigned"
    }
}

클러스터를 만들 때 다음과 같은 추가 속성이 있습니다.

{
   "identity": {
      "type": "SystemAssigned",
      "tenantId": "<TENANTID>",
      "principalId": "<PRINCIPALID>"
   }
}

<TENANTID> 및 <PRINCIPALID>가 각각 GUID로 대체됩니다. 이 속성은 TenantId ID가 속한 Azure AD 테넌트를 식별합니다. 클러스터 PrincipalId 의 새 ID에 대한 고유 식별자입니다. Azure AD 내에서 서비스 주체는 App Service 또는 Azure Functions 인스턴스에 지정한 이름과 동일합니다.

Azure Portal을 사용하여 시스템 할당 ID 제거

1. Azure Portal에 로그인합니다.

2. 포털의 왼쪽 창에서 설정>ID 를 선택합니다.

3. Identity 패널의 >시스템 할당 탭:

   1. 상태 슬라이더를 꺼짐으로 이동하세요.
   2. 저장을 선택합니다.
   3. 팝업 창에서 예를 선택하여 시스템 할당 ID를 사용하지 않도록 설정합니다. ID 창은 시스템 할당 ID를 추가하기 전과 동일한 조건으로 되돌려 줍니다.

   

C를 사용하여 시스템 할당 ID 제거#

다음을 실행하여 시스템 할당 ID를 제거합니다.

var clusterPatch = new ClusterUpdate(identity: new Identity(IdentityType.None));
await kustoManagementClient.Clusters.UpdateAsync(resourceGroupName, clusterName, clusterPatch);

Azure Resource Manager 템플릿을 사용하여 시스템 할당 ID 제거

다음을 실행하여 시스템 할당 ID를 제거합니다.

{
   "identity": {
      "type": "None"
   }
}

Azure Portal을 사용하여 사용자 할당 ID 추가

1. Azure Portal에 로그인합니다.

2. 사용자 할당 관리 ID 리소스를 만듭니다.

3. 기존 Azure Data Explorer 클러스터를 엽니다.

4. 포털의 왼쪽 창에서 설정>ID 를 선택합니다.

5. 사용자 할당 탭에서 추가를 선택합니다.

6. 이전에 만든 ID를 검색하여 선택합니다. 추가를 선택합니다.

   

C를 사용하여 사용자 할당 ID 추가#

필수 조건

Azure Data Explorer C# 클라이언트를 사용하여 관리 ID를 설정하려면 다음을 수행합니다.

• Azure Data Explorer NuGet 패키지를 설치합니다.
• 인증을 위해 Microsoft.Identity.Client NuGet 패키지를 설치합니다.
• 인증을 위해 Microsoft.Rest.ClientRuntime NuGet 패키지를 설치합니다.
• 리소스에 액세스할 수 있는 Azure AD 애플리케이션 및 서비스 주체를 만듭니다. 구독 범위에서 역할 할당을 추가하고 필요한 Directory (tenant) ID, Application ID 및 Client Secret을 가져옵니다.

클러스터 만들기 또는 업데이트

1. 속성을 사용하여 클러스터를 만들거나 업데이트합니다.Identity

   var tenantId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Directory (tenant) ID
   var clientId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Application ID
   var clientSecret = "PlaceholderClientSecret"; //Client Secret
   var subscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
   var authClient = ConfidentialClientApplicationBuilder.Create(clientId)
       .WithAuthority($"https://login.microsoftonline.com/{tenantId}")
       .WithClientSecret(clientSecret)
       .Build();
   var result = authClient.AcquireTokenForClient(new[] { "https://management.core.windows.net/" }).ExecuteAsync().Result;
   var credentials = new TokenCredentials(result.AccessToken, result.TokenType);
   var kustoManagementClient = new KustoManagementClient(credentials) { SubscriptionId = subscriptionId };
   var resourceGroupName = "testrg";
   var clusterName = "mykustocluster";
   var userIdentityResourceId = $"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identityName>";
   var clusterData = new Cluster(
       location: "Central US",
       sku: new AzureSku("Standard_E8ads_v5", "Standard", 5),
       identity: new Identity(
           IdentityType.UserAssigned,
           userAssignedIdentities: new Dictionary<string, IdentityUserAssignedIdentitiesValue>(1)
           {
               { userIdentityResourceId, new IdentityUserAssignedIdentitiesValue() }
           }
       )
   );
   await kustoManagementClient.Clusters.CreateOrUpdateAsync(resourceGroupName, clusterName, clusterData);
   

2. 다음 명령을 실행하여 클러스터가 ID로 성공적으로 생성되거나 업데이트되었는지 확인합니다.

   clusterData = await kustoManagementClient.Clusters.GetAsync(resourceGroupName, clusterName);
   

   결과에 값이 ProvisioningStateSucceeded 포함된 경우 클러스터가 만들어지거나 업데이트되었으며 다음 속성이 있어야 합니다.

   var userIdentity = clusterData.Identity.UserAssignedIdentities[userIdentityResourceId];
   var principalGuid = userIdentity.PrincipalId;
   var clientGuid = userIdentity.ClientId;
   

   Azure PrincipalId AD 관리에 사용되는 ID의 고유 식별자입니다. 애플리케이션의 새로운 ID를 지정하기 위해 런타임 호출 중 사용할 ID를 결정하는 고유 식별자입니다.

Azure Resource Manager 템플릿을 사용하여 사용자 할당 ID 추가

Azure Resource Manager 템플릿을 사용하여 Azure 리소스 배포를 자동화할 수 있습니다. Azure Data Explorer에 배포하는 방법에 대한 자세한 내용은 Azure Resource Manager 템플릿을 사용하여 Azure Data Explorer 클러스터 및 데이터베이스 만들기를 참조하세요.

리소스 정의에 다음 속성을 포함하고, 원하는 ID의 사용자 할당 ID를 사용할 수 있도록 Microsoft.Kusto/clusters을 해당 리소스 ID로 대체하여 <RESOURCEID> 형식의 모든 리소스를 만들 수 있습니다.

{
   "identity": {
      "type": "UserAssigned",
      "userAssignedIdentities": {
         "<RESOURCEID>": {}
      }
   }
}

다음은 그 예입니다.

{
    "apiVersion": "2019-09-07",
    "type": "Microsoft.Kusto/clusters",
    "name": "[variables('clusterName')]",
    "location": "[resourceGroup().location]",
    "identity": {
        "type": "UserAssigned",
        "userAssignedIdentities": {
            "[resourceId('Microsoft.ManagedIdentity/userAssignedIdentities', variables('identityName'))]": {}
        }
    },
    "dependsOn": [
        "[resourceId('Microsoft.ManagedIdentity/userAssignedIdentities', variables('identityName'))]"
    ]
}

클러스터를 만들 때 다음과 같은 추가 속성이 있습니다.

{
   "identity": {
      "type": "UserAssigned",
      "userAssignedIdentities": {
         "<RESOURCEID>": {
            "principalId": "<PRINCIPALID>",
            "clientId": "<CLIENTID>"
         }
      }
   }
}

Azure PrincipalId AD 관리에 사용되는 ID의 고유 식별자입니다. ClientId는 애플리케이션의 새로운 ID에 대한 고유 식별자로, 런타임 호출 시 사용할 ID를 지정하는 데 사용됩니다.

Azure Portal을 사용하여 사용자 할당 관리 ID 제거

1. Azure Portal에 로그인합니다.

2. 포털의 왼쪽 창에서 설정>ID 를 선택합니다.

3. 사용자 할당 탭을 선택합니다.

4. 이전에 만든 ID를 검색하여 선택합니다. 선택 후제거.

   

5. 팝업 창에서 예를 선택하여 사용자 할당 ID를 제거합니다. ID 창은 사용자가 할당한 ID를 추가하기 전과 동일한 조건으로 되돌려 줍니다.

C를 사용하여 사용자 할당 ID 제거#

다음을 실행하여 사용자 할당 ID를 제거합니다.

var clusterUpdate = new ClusterUpdate(
    identity: new Identity(
        IdentityType.UserAssigned,
        userAssignedIdentities: new Dictionary<string, IdentityUserAssignedIdentitiesValue>(1)
        {
            { userIdentityResourceId, null }
        }
    )
);
await kustoManagementClient.Clusters.UpdateAsync(resourceGroupName, clusterName, clusterUpdate);

Azure Resource Manager 템플릿을 사용하여 사용자 할당 ID 제거

다음을 실행하여 사용자 할당 ID를 제거합니다.

{
   "identity": {
      "type": "UserAssigned",
      "userAssignedIdentities": {
         "<RESOURCEID>": null
      }
   }
}