관리 ID를 사용하여 Azure Stream Analytics 작업을 Power BI에 인증시키기

Power BI 출력에 대한 관리 ID 인증을 사용하면 Stream Analytics 작업이 Power BI 계정 내의 작업 영역에 직접 액세스할 수 있습니다. 이 기능을 사용하면 사용자가 더 이상 Azure 포털을 통해 Power BI 위해 대화형으로 로그인할 필요가 없으므로 Stream Analytics 작업의 배포를 완전히 자동화할 수 있습니다. 또한 작업을 주기적으로 다시 인증할 필요가 없으므로 Power BI 쓰는 장기 실행 작업이 더 잘 지원됩니다.

이 문서에서는 Azure 포털 및 Azure Resource Manager 배포를 통해 Stream Analytics 작업의 Power BI 출력에 대해 관리 ID를 사용하도록 설정하는 방법을 보여 줍니다.

필수 조건

이 기능을 사용하려면 다음 필수 구성 요소가 필요합니다.

• Pro 라이선스 있는 Power BI 계정입니다.
• Power BI 계정 내에서 업그레이드된 작업 영역입니다. 자세한 내용은 Power BI 공지 참조하세요.

Azure 포털을 사용하여 Stream Analytics 작업 만들기

1. 새 Stream Analytics 작업을 만들거나 Azure 포털에서 기존 작업을 엽니다.

2. 화면 왼쪽의 메뉴 모음에서 설정에서 관리 ID를 선택합니다.

   

3. ID 선택에서 시스템 할당 ID를 선택합니다. 그런 다음 저장을 선택합니다.

   

4. 관리 ID에서 Stream Analytics 작업에 할당된 보안 주체 ID 및 보안 주체 이름이 표시되는지 확인합니다. 보안 주체 이름은 Stream Analytics 작업 이름과 동일해야 합니다.

5. 출력을 구성하기 전에 이 문서의 Stream Analytics 작업이 Power BI 작업 영역에 액세스 권한을 부여하기 섹션에 나와 있는 지침을 따라 Stream Analytics 작업이 Power BI 작업 영역에 액세스할 수 있도록 하십시오.

6. Stream Analytics 작업의 Outputs 섹션으로 이동하여 + 추가 선택한 다음, Power BI 선택합니다. 그런 다음 Authorize 단추를 선택하고 Power BI 계정으로 로그인합니다.

   

7. 권한이 부여되면 사용 가능한 모든 작업 영역이 드롭다운 목록에 표시됩니다. 이전 단계에서 승인한 작업 영역을 선택합니다. 그런 다음, 인증 모드로 관리 ID를 선택합니다. 마지막으로 저장 단추를 선택합니다.

   

Azure Resource Manager 배포

Azure Resource Manager 사용하면 Stream Analytics 작업의 배포를 완전히 자동화할 수 있습니다. Azure PowerShell 또는 Azure CLI 사용하여 Resource Manager 템플릿을 배포할 수 있습니다. 다음 예제에서는 Azure CLI 사용합니다.

1. Microsoft.StreamAnalytics/streamingjobs 리소스를 생성하려면 Resource Manager 템플릿의 리소스 섹션에 다음 속성을 포함시키고, 관리 ID을 설정합니다.

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

   이 속성을 통해 Azure Resource Manager에서 Stream Analytics 작업에 대한 ID를 만들고 관리합니다. 다음 예제에서는 관리 ID를 사용하도록 설정된 Stream Analytics 작업과 관리 ID를 사용하는 Power BI 출력 싱크를 배포하는 Resource Manager 템플릿을 보여 줍니다.

   {
       "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
       "contentVersion": "1.0.0.0",
       "resources": [
           {
               "apiVersion": "2017-04-01-preview",
               "name": "pbi_managed_id",
               "location": "[resourceGroup().location]",
               "type": "Microsoft.StreamAnalytics/StreamingJobs",
               "identity": {
                   "type": "systemAssigned"
               },
               "properties": {
                   "sku": {
                       "name": "standard"
                   },
                   "outputs":[
                       {
                           "name":"output",
                           "properties":{
                               "datasource":{
                                   "type":"PowerBI",
                                   "properties":{
                                       "dataset": "dataset_name",
                                       "table": "table_name",
                                       "groupId": "01234567-89ab-cdef-0123-456789abcdef",
                                       "authenticationMode": "Msi"
                                   }
                               }
                           }
                       }
                   ]
               }
           }
       ]
   }
   

   다음 Azure CLI 명령을 사용하여 이전 작업을 리소스 그룹 ExampleGroup 배포합니다.

   az deployment group create --resource-group ExampleGroup -template-file StreamingJob.json
   

2. 작업을 만든 후 Azure Resource Manager 사용하여 작업의 전체 정의를 검색합니다.

   az resource show --ids /subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.StreamAnalytics/StreamingJobs/<resource-name>
   

   앞의 명령은 다음과 같은 응답을 반환합니다.

   {
       "id": "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.StreamAnalytics/streamingjobs/<resource-name>",
       "identity": {
           "principalId": "<principal-id>",
           "tenantId": "<tenant-id>",
           "type": "SystemAssigned",
           "userAssignedIdentities": null
       },
       "kind": null,
       "location": "West US",
       "managedBy": null,
       "name": "<resource-name>",
       "plan": null,
       "properties": {
           "compatibilityLevel": "1.0",
           "createdDate": "2019-07-12T03:11:30.39Z",
           "dataLocale": "en-US",
           "eventsLateArrivalMaxDelayInSeconds": 5,
           "jobId": "<job-id>",
           "jobState": "Created",
           "jobStorageAccount": null,
           "jobType": "Cloud",
           "outputErrorPolicy": "Stop",
           "package": null,
           "provisioningState": "Succeeded",
           "sku": {
               "name": "Standard"
           }
       },
       "resourceGroup": "<resource-group>",
       "sku": null,
       "tags": null,
       "type": "Microsoft.StreamAnalytics/streamingjobs"
   }
   

   Power BI REST API를 사용하여 Stream Analytics 작업을 Power BI 작업 영역에 추가하려는 경우 반환된 principalId 기록해 둡니다.

3. 이제 작업이 생성되었으므로 이 문서의 Power BI 작업 영역에 대한 Stream Analytics 작업 액세스 섹션으로 계속 진행합니다.

Power BI 작업 영역에 대한 Stream Analytics 작업 액세스 권한 부여

Stream Analytics 작업을 만든 후 Power BI 작업 영역에 대한 액세스 권한을 부여합니다. 작업 액세스 권한을 부여한 후 ID가 전파되도록 몇 분 정도 허용합니다.

Power BI UI 사용

1. 작업 영역의 액세스 설정으로 이동합니다. 자세한 내용은 작업 영역에 대한 액세스 권한 부여를 참조하세요.

2. 텍스트 입력란에 Stream Analytics 작업 이름을 입력하고 액세스 수준으로 기여자를 선택합니다.

3. 추가를 선택하고 창을 닫습니다.

   

Power BI PowerShell cmdlet 사용

1. Power BI MicrosoftPowerBIMgmt PowerShell cmdlet을 설치합니다.

   중요합니다

   cmdlet 버전 1.0.821 이상을 사용하고 있는지 확인합니다.

   Install-Module -Name MicrosoftPowerBIMgmt
   

2. Power BI 로그인합니다.

   Login-PowerBI
   

3. Stream Analytics 작업을 작업 영역에 기여자로 추가합니다.

   Add-PowerBIWorkspaceUser -WorkspaceId <group-id> -PrincipalId <principal-id> -PrincipalType App -AccessRight Contributor
   

Power BI REST API 사용

"그룹 사용자 추가" REST API를 직접 사용하여 Stream Analytics 작업을 작업 영역에 기여자로 추가할 수 있습니다. 전체 설명서는 그룹 - 그룹 사용자 추가를 참조하세요.

샘플 요청

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users

요청 본문

{
    "groupUserAccessRight": "Contributor",
    "identifier": "<principal-id>",
    "principalType": "App"
}

서비스 프린시펄을 사용하여 ASA 작업의 관리 ID에 권한을 부여하세요.

자동화된 배포의 경우 대화형 로그인을 사용하여 Power BI 작업 영역에 대한 ASA 작업 액세스 권한을 부여할 수 없습니다. 서비스 주체를 사용하여 ASA 작업의 관리 ID에 대한 권한을 부여할 수 있습니다. 이 방법에는 PowerShell을 사용할 수 있습니다.

Connect-PowerBIServiceAccount -ServicePrincipal -TenantId "<tenant-id>" -CertificateThumbprint "<thumbprint>" -ApplicationId "<app-id>"
Add-PowerBIWorkspaceUser -WorkspaceId <group-id> -PrincipalId <principal-id> -PrincipalType App -AccessRight Contributor

관리 ID 제거

Stream Analytics 작업에 대해 만든 관리 ID는 작업을 삭제할 때만 삭제됩니다. 작업을 삭제하지 않고 관리 ID를 삭제할 수 있는 방법은 없습니다. 관리 ID를 더 이상 사용하지 않으려면 출력에 대한 인증 방법을 변경할 수 있습니다. 관리 ID는 작업을 삭제할 때까지 계속 존재합니다. 관리 ID 인증을 다시 사용하기로 결정한 경우 관리 ID가 사용됩니다.

Limitations

이 기능에는 다음과 같은 제한 사항이 있습니다.

• 클래식 Power BI 작업 영역은 지원되지 않습니다.

• Microsoft Entra ID 없는 Azure 계정은 지원되지 않습니다.

• 다중 테넌트 액세스는 지원되지 않습니다. 지정된 Stream Analytics 작업에 대해 만든 서비스 주체는 작업을 만든 동일한 Microsoft Entra 테넌트에 있어야 합니다. 다른 Microsoft Entra 테넌트에 있는 리소스에는 사용할 수 없습니다.

• 사용자 할당 ID 는 지원되지 않습니다. Stream Analytics 작업에서 사용할 고유한 서비스 주체를 입력할 수 없습니다. Azure Stream Analytics 서비스 주체를 생성해야 합니다.

다음 단계

• Tutorial: Stream Analytics를 사용하여 사기성 호출 데이터를 분석하고 Power BI 대시보드에서 결과를 시각화합니다

• Azure Stream Analytics의 출력 이해