자습서: 국가/지역 클라우드용 애플리케이션에 Power BI 콘텐츠 포함

국가/지역 클라우드용 비즈니스 프로세스 애플리케이션 내에 분석 콘텐츠를 포함하는 방법을 알아봅니다. Power BI JavaScript API와 함께 Power BI .NET SDK를 사용하여 보고서, 대시보드 또는 타일을 웹 애플리케이션에 포함할 수 있습니다.

Power BI 다음과 같은 국가/지역 클라우드를 지원합니다.

• 미국 GCC(정부 커뮤니티 클라우드)

• 미국 GCC High(정부 커뮤니티 클라우드 High)

• 미국 DoDCON(군용 계약업체)

• 미국 DoD(군대)

• 중국 클라우드용 Power BI

이 연습을 시작하려면 Power BI 계정이 필요합니다. 계정을 설정하지 않은 경우 정부 또는 국가/지역의 유형에 따라 적절한 국가/지역 클라우드를 선택할 수 있습니다. 미국 정부 Power BI 계정 또는 중국 클라우드용 Power BI 계정에 등록합니다.

참고 항목

대신 조직의 대시보드를 포함하려고 하시나요? 조직의 앱에 대시보드 통합을 참조하세요.

대시보드를 웹앱에 통합하려면 Power BI API와 Microsoft Entra 권한 부여 액세스 토큰을 사용하여 대시보드를 가져옵니다. 포함 토큰을 사용하여 대시보드를 로드합니다. Power BI API는 특정 Power BI 리소스에 대한 프로그래밍 방식 액세스를 제공합니다. 자세한 내용은 Power BI REST API, Power BI .NET SDK 및 Power BI JavaScript API를 참조하세요.

샘플 다운로드

이 문서는 GitHub의 앱 소유 데이터 샘플에 사용된 코드를 보여줍니다. 이 연습을 따라 하기 위해 샘플을 다운로드할 수 있습니다. .NET Framework/Embed for your customers 디렉터리를 사용하겠습니다.

Important

Microsoft 365 SKU를 사용하는 GCC(정부 커뮤니티 클라우드)의 Power BI 콘텐츠만 포함할 수 있습니다. 기타 국가/지역 클라우드 고객은 Microsoft 365 또는 Azure SKU를 사용할 수 있습니다.

• GCC(정부 커뮤니티 클라우드):

  1. Web.config 파일에서 applicationId(네이티브 앱 applicationId), workspaceId, 사용자 이름(마스터 사용자) 및 암호를 업데이트합니다.

  2. 다음으로 GCC 매개 변수를 다음과 같이 추가합니다.

     <add key="authorityUrl" value="https://login.microsoftonline.com/organizations/" />
     <add key="scopeBase" value="https://analysis.usgovcloudapi.net/powerbi/api/.default" />
     <add key="urlPowerBiServiceApiRoot" value="https://api.powerbigov.us/" />
     

• DoDCON(군용 계약업체):

  1. Web.config 파일에서 applicationId(네이티브 앱 applicationId), workspaceId, 사용자 이름(마스터 사용자) 및 암호를 업데이트합니다.

  2. 다음으로 DoDCON 매개 변수를 다음과 같이 추가합니다.

     <add key="authorityUrl" value="https://login.microsoftonline.us/organizations/" />
     <add key="scopeBase" value="https://high.analysis.usgovcloudapi.net/powerbi/api/.default" />
     <add key="urlPowerBiServiceApiRoot" value="https://api.high.powerbigov.us/" />
     

• DoD(군대):

  1. Web.config 파일에서 applicationId(네이티브 앱 applicationId), workspaceId, 사용자 이름(마스터 사용자) 및 암호를 업데이트합니다.

  2. 다음으로 DoDCON 매개 변수를 다음과 같이 추가합니다.

     <add key="authorityUrl" value="https://login.microsoftonline.us/organizations/" />
     <add key="scopeBase" value="https://mil.analysis.usgovcloudapi.net/powerbi/api/.default" />
     <add key="urlPowerBiServiceApiRoot" value="https://api.mil.powerbigov.us/" />
     

• 중국 클라우드용 Power BI 매개 변수

  1. Web.config 파일에서 applicationId(네이티브 앱 applicationId), workspaceId, 사용자 이름(마스터 사용자) 및 암호를 업데이트합니다.

  2. 다음으로, 다음과 같이 중국 클라우드 매개 변수에 대한 Power BI를 추가합니다.

     <add key="authorityUrl" value="https://login.chinacloudapi.cn/organizations/" />
     <add key="scopeBase" value="https://analysis.chinacloudapi.cn/powerbi/api/.default" />
     <add key="urlPowerBiServiceApiRoot" value="https://api.powerbi.cn/" />
     

1단계 - Microsoft Entra ID에 앱 등록

REST API를 호출하려면 Microsoft Entra ID로 애플리케이션을 등록합니다. 자세한 내용은 Power BI 콘텐츠를 포함하도록 Microsoft Entra 앱 등록을 참조하세요. 국가/지역 클라우드 소속이 서로 다르기 때문에 애플리케이션을 등록하기 위한 개별 URL이 있습니다.

• GCC(정부 커뮤니티 클라우드) - https://app.powerbigov.us/apps

• DoDCON(군용 계약업체) - https://app.high.powerbigov.us/apps

• DoD(군대) - https://app.mil.powerbigov.us/apps

• 중국 클라우드용 Power BI - https://app.powerbi.cn/apps

고객을 위한 포함 샘플을 다운로드한 경우 샘플이 Microsoft Entra ID에 대해 인증할 수 있도록 받은 applicationId를 사용합니다. 샘플을 구성하려면, web.config 파일에서 applicationId를 변경합니다.

2단계 - Microsoft Entra ID에서 액세스 토큰 가져오기

애플리케이션 내에서 Power BI REST API를 호출하려면 먼저 Microsoft Entra ID에서 액세스 토큰을 가져와야 합니다 자세한 내용은 사용자를 인증하고 Power BI 앱에 대한 Microsoft Entra 액세스 토큰 가져오기를 참조하세요. 국가/지역 클라우드 소속이 서로 다르기 때문에 애플리케이션에 대한 액세스 토큰을 가져오기 위한 개별 URL이 있습니다.

• GCC(정부 커뮤니티 클라우드) - https://login.microsoftonline.com

• DoDCON(군용 계약업체) - https://login.microsoftonline.us

• DoD(군대) - https://login.microsoftonline.us

• 중국 클라우드용 Power BI - https://login.chinacloudapi.cn

Controllers\HomeController.cs 파일의 각 콘텐츠 항목 작업 내에서 이러한 액세스 토큰 예제를 볼 수 있습니다.

3단계 - 콘텐츠 포함

이제 액세스 토큰이 생겼으므로 다른 플랫폼과 마찬가지로 포함을 계속할 수 있습니다.

• 고객용 콘텐츠 포함
• 조직용 콘텐츠 포함

관련 콘텐츠

• 고객에 대한 콘텐츠 포함 샘플
• Power BI JavaScript API

추가 질문이 있으신가요? Power BI 커뮤니티에 문의