자습서: 샘플 고객을 위해 포함 애플리케이션을 사용하여 Power BI 콘텐츠 포함

적용 대상: 앱 소유 데이터 사용자 소유 데이터

임베디드 분석 및 Power BI Embedded(Azure 제품)를 사용하여 보고서, 대시보드, 타일과 같은 Power BI 콘텐츠를 애플리케이션에 포함할 수 있습니다.

이 자습서에서는 다음을 하는 방법을 알아볼 수 있습니다.

• 포함된 환경을 설정합니다.
• ‘고객에 대한 콘텐츠 포함’(‘앱 소유 데이터’라고도 함) 애플리케이션 예제를 구성합니다.

애플리케이션을 사용하기 위해 사용자는 Power BI에 로그인하거나 Power BI 라이선스를 가질 필요가 없습니다.

타사용 애플리케이션을 만들려는 ISV(독립 소프트웨어 공급업체) 또는 개발자인 경우에는 ‘고객에 대한 콘텐츠 포함’ 방법을 사용하여 Power BI 콘텐츠를 포함하는 것이 좋습니다.

Important

국가/지역 클라우드의 콘텐츠를 포함하는 경우 이 자습서의 처음 몇 단계가 다릅니다. 자세한 내용은 임베디드 국가/지역 클라우드 콘텐츠를 참조하세요.

코드 샘플 사양

이 자습서에는 다음 프레임워크 중 하나로 ‘고객에 대한 콘텐츠 포함’ 샘플 애플리케이션을 구성하기 위한 지침이 포함되어 있습니다.

• .NET Framework
• .NET Core
• Java
• Node JS
• Python

코드 샘플은 다음 브라우저를 지원합니다.

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

필수 조건

이 자습서를 시작하기 전에 다음의 Power BI 및 코드 종속성이 모두 있는지 확인합니다.

• Power BI 종속성

  • 사용자 고유의 Microsoft Entra 테넌트입니다.

  • Power BI에 대해 앱을 인증하려면 다음 중 하나가 필요합니다.

    • 서비스 주체 - Microsoft Entra ID가 앱을 인증할 수 있도록 허용하는 Microsoft Entra 서비스 주체 개체입니다.

    • Power BI Pro 라이선스 - 마스터 사용자이며 앱이 이 라이선스를 사용하여 Power BI에 대해 인증합니다.

    • Power BI PPU(사용자 단위 Premium) 라이선스 - 마스터 사용자이며 앱이 이 라이선스를 사용하여 Power BI에 대해 인증합니다.

    참고 항목

    프로덕션으로 이동하려면 용량이 필요합니다.

• 코드 종속성

.NET Core

• .NET Core 3.1 SDK(이상)

• IDE(통합 개발 환경). 다음 환경 중 하나를 사용하는 것이 좋습니다.

  • Visual Studio

  • Visual Studio Code

.NET Framework

• .NET Framework 4.8

• Visual Studio

Java

• JDK(또는 JRE)

• Eclipse IDE - Java EE용 Eclipse 개발자(Enterprise Edition)가 있는지 확인합니다.

• Apache Tomcat 이진 배포

Node JS

• Node.JS

• IDE(통합 개발 환경). 다음 환경 중 하나를 사용하는 것이 좋습니다.

  • Visual Studio

  • Visual Studio Code

Python

• Python 3(이상)

  참고 항목

  • Python을 처음 설치하는 경우 PATH에 Python 추가 옵션을 선택하여 설치를 PATH 변수에 추가합니다.
  • Python이 이미 설치된 경우 해당 설치 경로가 PATH 변수에 포함되어 있는지 확인합니다. 자세한 내용은 부록: 환경 변수 설정 Python 설명서(이 링크는 Python 3를 참조함)를 참조하세요.

• IDE(통합 개발 환경). 다음 환경 중 하나를 사용하는 것이 좋습니다.

  • Visual Studio

  • Visual Studio Code

메서드

‘고객에 대한 콘텐츠 포함’ 샘플 앱을 만들려면 다음 단계를 수행합니다.

1. 인증 방법을 선택합니다.

2. Microsoft Entra 애플리케이션 등록.

3. Power BI 작업 영역을 만듭니다.

4. Power BI 보고서를 만들고 게시합니다.

5. 포함하는 매개 변수 값을 가져옵니다.

6. 서비스 주체 API 액세스

7. 작업 영역 액세스를 사용하도록 설정합니다.

8. 콘텐츠를 포함합니다.

1단계 - 인증 방법 선택

임베디드된 솔루션은 선택한 인증 방법에 따라 달라집니다. 따라서 인증 방법 간의 차이점을 이해하고 솔루션에 가장 적합한 방법을 결정하는 것이 중요합니다.

다음 테이블에서는 서비스 주체 인증 방법과 마스터 사용자 인증 방법 간의 몇 가지 주요 차이점을 설명합니다.

고려 사항	서비스 사용자	마스터 사용자
메커니즘	Microsoft Entra 앱의 서비스 주체 개체를 통해 Microsoft Entra ID가 Power BI에 대해 임베디드된 솔루션 앱을 인증할 수 있습니다.	Microsoft Entra 앱은 Power BI 사용자의 자격 증명(사용자 이름 및 암호)을 사용하여 Power BI에 대해 인증합니다.
보안	서비스 주체는 Microsoft Entra ID 권장 권한 부여 방법입니다. 서비스 주체를 사용하는 경우 애플리케이션 비밀 또는 인증서를 사용하여 인증할 수 있습니다. 이 자습서는 애플리케이션 비밀에서 서비스 주체를 사용하는 경우에 대해서만 설명합니다. ‘서비스 주체’ 및 ‘인증서’를 사용하여 포함하려면 서비스 주체 및 인증서 문서를 참조하세요.	이 인증 방법은 서비스 주체처럼 안전하지는 않습니다. 마스터 사용자 자격 증명(사용자 이름 및 암호)을 사용할 때는 주의해야 합니다. 예를 들어 포함하는 애플리케이션에 자격 증명을 노출하지 말고 암호를 자주 변경해야 합니다.
Microsoft Entra ID 위임 권한	필수 아님.	‘마스터 사용자’ 또는 관리자는 앱이 Power BI REST API 권한(범위라고도 함)에 액세스할 수 있게 동의해야 합니다. 예를 들어 Report.ReadWrite.All입니다.
Power BI 서비스 액세스	‘서비스 주체’를 사용하여 Power BI 서비스에 액세스할 수 없습니다.	‘마스터 사용자’ 자격 증명을 사용하여 Power BI 서비스에 액세스할 수 있습니다.
라이선스	Pro 라이선스가 필요하지 않습니다. 멤버 또는 관리자로 속해 있는 모든 작업 영역의 콘텐츠를 사용할 수 있습니다.	Power BI Pro 또는 PPU(사용자 단위 Premium) 라이선스가 필요합니다.

2단계 - Microsoft Entra 애플리케이션 등록

Microsoft Entra ID를 사용하여 애플리케이션을 등록하면 다음을 수행할 수 있습니다.

• 앱에 대한 ID 설정
• 앱이 Power BI REST API에 액세스하도록 허용
• ‘마스터 사용자’를 사용하는 경우 - 앱의 Power BI REST 권한 지정

Microsoft Entra ID로 애플리케이션을 등록하려면 애플리케이션 등록의 지침을 따릅니다.

참고 항목

애플리케이션을 등록하기 전에 사용할 인증 방법, ‘서비스 주체’ 또는 ‘마스터 사용자’를 결정해야 합니다.

3단계 - Power BI 작업 영역 만들기

Microsoft Fabric은 보고서, 대시보드 및 타일을 작업 영역에 보관합니다. 이러한 항목을 포함하려면 항목을 만들고 작업 영역에 업로드해야 합니다.

팁

작업 영역이 이미 있는 경우 이 단계를 건너뛸 수 있습니다.

작업 영역을 만들려면 다음을 수행합니다.

1. Fabric에 로그인합니다.

2. 작업 영역을 선택합니다.

3. + 새 작업 영역을 선택합니다.

4. 작업 영역 이름을 지정하고 저장을 선택합니다.

4단계 - Power BI 보고서 만들기 및 게시

다음 단계는 보고서를 만들어 작업 영역에 업로드하는 것입니다. Power BI Desktop을 사용하여 고유한 보고서를 만든 후 작업 영역에 게시할 수 있습니다. 또는 작업 영역에 샘플 보고서를 업로드할 수 있습니다.

팁

보고서가 포함된 작업 영역이 이미 있는 경우 이 단계를 건너뛸 수 있습니다.

샘플 보고서를 다운로드하고 작업 영역에 게시하려면 다음 단계를 수행합니다.

1. GitHub Power BI Desktop 샘플 폴더를 엽니다.

2. Code(코드)를 선택하고 Download zip(ZIP 다운로드)을 선택합니다.

   

3. 다운로드한 ZIP의 압축을 풀고 Samples Reports 폴더로 이동합니다.

4. 포함할 보고서를 선택하고 작업 영역에 게시합니다.

5단계 - 포함하는 매개 변수 값 가져오기

콘텐츠를 포함하려면 특정 매개 변수 값을 가져와야 합니다. 다음 표에서는 필요한 값을 보여 주고 서비스 주체 인증 방법, 마스터 사용자 인증 방법 또는 두 가지 모두에 적용할 수 있는지를 나타냅니다.

콘텐츠를 포함하기 전에 아래에 나열된 모든 값이 있는지 확인합니다. 일부 값은 사용하는 인증 방법에 따라 다릅니다.

매개 변수	서비스 사용자	마스터 사용자
클라이언트 ID
작업 영역 ID
보고서 ID
클라이언트 암호
테넌트 ID		Node JS에만 필요
Power BI 사용자 이름
Power BI 암호

클라이언트 ID

팁

적용 사항: 서비스 주체 마스터 사용자

클라이언트 ID GUID(‘애플리케이션 ID’라고도 함)를 가져오려면 다음 단계를 수행합니다.

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

2. 앱 등록을 검색하고 앱 등록 링크를 선택합니다.

3. Power BI 콘텐츠를 포함하는 데 사용 중인 Microsoft Entra 앱을 선택합니다.

4. 개요 섹션에서 애플리케이션(클라이언트) ID GUID를 복사합니다.

작업 영역 ID

팁

적용 사항: 서비스 주체 마스터 사용자

작업 영역 ID GUID를 가져오려면 다음 단계를 수행합니다.

1. Power BI 서비스에 로그인.

2. 포함하려는 보고서를 엽니다.

3. URL에서 GUID를 복사합니다. GUID는 /groups/와 /reports/ 사이의 숫자입니다.

   

또는 작업 영역 이름 옆에 있는 세부 정보를 선택하여 관리자 포털 설정에서 작업 영역 ID를 찾을 수 있습니다.

보고서 ID

팁

적용 사항: 서비스 주체 마스터 사용자

보고서 ID GUID를 가져오려면 다음 단계를 수행합니다.

1. Power BI 서비스에 로그인.

2. 포함하려는 보고서를 엽니다.

3. URL에서 GUID를 복사합니다. GUID는 /reports/와 /ReportSection 사이의 숫자입니다.

   

클라이언트 암호

팁

적용 사항: 서비스 주체 마스터 사용자

클라이언트 암호를 가져오려면 다음 단계를 수행합니다.

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

2. 앱 등록을 검색하고 앱 등록 링크를 선택합니다.

3. Power BI 콘텐츠를 포함하는 데 사용 중인 Microsoft Entra 앱을 선택합니다.

4. 관리에서 인증서 및 비밀을 선택합니다.

5. 클라이언트 암호 아래에서 새 클라이언트 암호를 선택합니다.

6. 클라이언트 암호 추가 팝업 창에서 애플리케이션 암호에 대한 설명을 제공하고 애플리케이션 암호가 만료되는 경우를 선택하고 추가를 선택합니다.

7. 클라이언트 암호 섹션에서 새로 만든 애플리케이션 암호의 값 열에 문자열을 복사합니다. 클라이언트 암호 값은 ‘클라이언트 ID’입니다.

참고 항목

처음 표시될 때 클라이언트 암호 값을 복사해야 합니다. 이 페이지를 벗어나면 클라이언트 암호가 숨겨지고 해당 값을 검색할 수 없습니다.

테넌트 ID

팁

적용 사항: 서비스 주체 마스터 사용자

테넌트 ID GUID를 가져오려면 다음 단계를 수행합니다.

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

2. 앱 등록을 검색하고 앱 등록 링크를 선택합니다.

3. Power BI 콘텐츠를 포함하는 데 사용 중인 Microsoft Entra 앱을 선택합니다.

4. 개요 섹션에서 디렉터리(테넌트) ID GUID를 복사합니다.

Power BI 사용자 이름 및 암호

팁

적용 사항: 서비스 주체 마스터 사용자

마스터 사용자로 사용 중인 Power BI 사용자의 ‘사용자 이름’ 및 ‘암호’를 가져옵니다. Power BI 서비스에서 작업 영역을 만들고 해당 작업 영역에 보고서를 업로드하는 데 사용한 것과 동일한 사용자입니다.

6단계 - 서비스 주체 API 액세스

팁

적용 사항: 서비스 주체 마스터 사용자

이 단계는 ‘서비스 주체’ 인증 방법을 사용하는 경우에만 해당됩니다. ‘마스터 사용자’를 사용하는 경우에는 이 단계를 건너뛰고 7단계 - 작업 영역 액세스 사용으로 진행하세요.

Microsoft Entra 앱이 Power BI 콘텐츠 및 API에 액세스할 수 있도록 Power BI 관리자는 Power BI 관리 포털에서 서비스 사용자 액세스를 사용하도록 설정해야 합니다. 테넌트 관리자가 아닌 경우 테넌트 관리자에게 ‘테넌트 설정’을 사용하도록 설정해 달라고 요청하세요.

1. ‘Power BI 서비스’에서 설정>설정>관리 포털을 선택합니다.

   

2. 테넌트 설정을 선택한 다음 개발자 설정 섹션으로 스크롤합니다.

3. 서비스 주체가 Fabric API를 사용할 수 있음을 확장하고 이 옵션을 활성화합니다.

   

참고 항목

‘서비스 주체’를 사용하는 경우 ‘보안 그룹’을 사용하여 테넌트 설정에 대한 액세스를 제한하는 것이 좋습니다. 이 기능에 대한 자세한 내용은 서비스 주체 문서에서 다음 섹션을 참조하세요.

• Microsoft Entra 보안 그룹 만들기
• Power BI 서비스 관리자 설정 사용

7단계 - 작업 영역 액세스 사용

Microsoft Entra 앱이 Power BI 서비스의 보고서, 대시보드, 의미 체계 모델과 같은 개체에 액세스할 수 있도록 하려면 서비스 주체 또는 마스터 사용자를 작업 영역에 구성원 또는 관리자로 추가합니다.

1. Fabric에 로그인합니다.

2. 액세스를 허용하려는 작업 영역으로 스크롤한 후 액세스 관리를 선택합니다.

   

3. 액세스 창에서 사용하는 인증 방법에 따라 ‘서비스 주체’ 또는 ‘마스터 사용자’를 메일 주소 입력 텍스트 상자에 복사합니다.

   참고 항목

   서비스 주체를 사용하는 경우 해당 이름은 Microsoft Entra 앱에 제공한 이름입니다.

4. 추가를 선택합니다.

8단계 - 콘텐츠 포함

Power BI Embedded 애플리케이션 예제를 사용하여 ‘고객에 대한 콘텐츠 포함’ Power BI 앱을 만들 수 있습니다.

Power BI 보고서를 포함하도록 ‘고객에 대한 콘텐츠 포함’ 애플리케이션 예제를 수정하려면 다음 단계를 따르세요.

1. Power BI 개발자 샘플 폴더를 엽니다.

2. Code(코드)를 선택하고 Download zip(ZIP 다운로드)을 선택합니다.

   

3. 다운로드한 ZIP의 압축을 풀고 PowerBI-Developer-Samples-master 폴더로 이동합니다.

4. 앱에서 사용할 언어에 따라 다음 폴더 중 하나를 엽니다.

   • .NET Core
   • .NET Framework
   • Java
   • Node JS
   • Python

   참고 항목

   ‘고객에 대한 콘텐츠 포함’ 샘플 애플리케이션은 위에 나열된 프레임워크만 지원합니다. React 샘플 애플리케이션은 ‘조직에 대한 콘텐츠 포함’ 솔루션만 지원합니다.

5. 고객에 대한 콘텐츠 포함 폴더를 엽니다.

.NET Core

6. 다음 방법 중 하나를 사용하여 ‘고객에 대한 콘텐츠 포함 샘플 앱’을 엽니다.

   • Visual Studio를 사용하는 경우 AppOwnsData.sln 파일을 엽니다.

   • Visual Studio Code를 사용하는 경우 AppOwnsData 폴더를 엽니다.

7. appsettings.json을 엽니다.

8. 인증 방법에 따라 다음 매개 변수 값을 입력합니다.

   매개 변수	서비스 사용자	마스터 사용자
   AuthenticationMode	ServicePrincipal	MasterUser
   ClientId	Microsoft Entra 앱 클라이언트 ID	Microsoft Entra 앱 클라이언트 ID
   TenantId	Microsoft Entra 테넌트 ID	해당 없음
   PbiUsername	해당 없음	‘마스터 사용자’ 이름(Power BI 사용자 이름 및 암호 참조)
   PbiPassword	해당 없음	‘마스터 사용자’ 암호(Power BI 사용자 이름 및 암호 참조)
   ClientSecret	Microsoft Entra ID 클라이언트 암호	해당 없음
   WorkspaceId	포함된 보고서가 있는 작업 영역의 ID(작업 영역 ID 참조)	포함된 보고서가 있는 작업 영역의 ID(작업 영역 ID 참조)
   ReportId	포함하는 보고서의 ID(보고서 ID 참조)	포함하는 보고서의 ID(보고서 ID 참조)

9. 적절한 옵션을 선택하여 프로젝트를 실행합니다.

   • Visual Studio를 사용하는 경우 IIS Express(재생)를 선택합니다.

   • Visual Studio Code를 사용하는 경우 실행 > 디버깅 시작을 선택합니다.

.NET Framework

6. Visual Studio를 사용하여 AppOwnsData.sln 파일을 엽니다.

7. Web.config를 엽니다.

8. 인증 방법에 따라 다음 매개 변수 값을 입력합니다.

   매개 변수	서비스 사용자	마스터 사용자
   authenticationType	ServicePrincipal	MasterUser
   applicationId	Microsoft Entra 앱 클라이언트 ID	Microsoft Entra 앱 클라이언트 ID
   workspaceId	포함된 보고서가 있는 작업 영역의 ID(작업 영역 ID 참조)	포함된 보고서가 있는 작업 영역의 ID(작업 영역 ID 참조)
   reportId	포함하는 보고서의 ID(보고서 ID 참조)	포함하는 보고서의 ID(보고서 ID 참조)
   pbiUsername	해당 없음	‘마스터 사용자’ 이름(Power BI 사용자 이름 및 암호 참조)
   pbiPassword	해당 없음	‘마스터 사용자’ 암호(Power BI 사용자 이름 및 암호 참조)
   applicationSecret	Microsoft Entra ID 클라이언트 암호	해당 없음
   tenant	Microsoft Entra 테넌트 ID	해당 없음

9. IIS Express(재생)를 선택하여 프로젝트를 실행합니다.

Java

6. Eclipse를 열고 아래에 설명된 지침을 따릅니다.

   참고 항목

   ‘고객에 대한 콘텐츠 포함 샘플 앱’에 대한 지침은 Java EE용 Eclipse 개발자(Enterprise Edition)를 참조하세요. 다른 애플리케이션을 사용하는 경우에는 직접 설정해야 합니다.

7. Eclipse에 Tomcat 서버를 추가합니다.

   a. 창>보기 표시>서버를 선택합니다.

   b. 서버 탭에서 No servers are available. Click this link to create new server(사용할 수 있는 서버가 없습니다. 새 서버를 만들려면 이 링크를 클릭합니다.)를 선택합니다.

   c. Define a New Server(새 서버 정의) 창에서 Apache를 확장하고 머신에서 실행 중인 Tomcat 서버를 선택합니다. 예를 들어 Tomcat v9.0 Server입니다.

   d. 다음을 선택합니다.

   e. Tomcat 서버 창에서 찾아보기를 선택하고 Tomcat 서버가 포함된 폴더로 이동합니다.

   f. Tomcat 서버 창에서 설치된 JRE를 선택합니다.

   g. 설치된 JRE 창에서 사용 가능한 jre를 선택하고 적용 및 닫기를 선택합니다.

   h. Tomcat 서버 창에서 마침을 선택합니다. 서버 탭에서 Tomcat 서버를 볼 수 있습니다.

8. Eclipse에서 프로젝트를 엽니다.

   Important

   경로 이름이 너무 길면 Eclipse에서 문제가 발생할 수도 있습니다. 이 문제를 방지하려면 샘플 앱의 폴더가 컴퓨터의 폴더 구조에 너무 깊이 중첩되지 않았는지 확인합니다.

   a. 파일을 선택한 다음 Open Projects from File System(파일 시스템에서 프로젝트 열기)을 선택합니다.

   b. 파일 시스템 또는 보관에서 프로젝트 가져오기 창에서 디렉터리를 선택하고 AppOwnsData 폴더를 엽니다.

   c. 마침을 선택합니다.

9. Tomcat 서버를 프로젝트에 추가합니다.

   a. 패키지 탐색기 창에서 AppOwnsData를 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다.

   b. AppOwnsData의 속성 창에서 대상 런타임을 선택한 다음 Apache Tomcat을 선택합니다. 이 선택 항목에는 사용하는 Apache Tomcat 버전(예: Apache Tomcat v9.0)이 포함됩니다.

   c. 적용 및 닫기를 선택합니다.

10. 필수 매개 변수를 입력합니다.

    a. 패키지 탐색기에서 AppOwnsData 프로젝트를 확장합니다.

    b. Java 리소스를 확장합니다.

    c. src를 확장합니다.

    d. com.embedsample.appoensdata.config를 확장합니다.

    e. Config.java를 엽니다.

    f. 인증 방법에 따라 다음 매개 변수 값을 입력합니다.

    매개 변수	서비스 사용자	마스터 사용자
    authenticationType	ServicePrincipal	MasterUser
    workspaceId	포함된 보고서가 있는 작업 영역의 ID(작업 영역 ID 참조)	포함된 보고서가 있는 작업 영역의 ID(작업 영역 ID 참조)
    reportId	포함하는 보고서의 ID(보고서 ID 참조)	포함하는 보고서의 ID(보고서 ID 참조)
    clientId	Microsoft Entra 앱 클라이언트 ID	Microsoft Entra 앱 클라이언트 ID
    pbiUsername	해당 없음	‘마스터 사용자’ 이름(Power BI 사용자 이름 및 암호 참조)
    pbiPassword	해당 없음	‘마스터 사용자’ 암호(Power BI 사용자 이름 및 암호 참조)
    tenantId	Microsoft Entra 테넌트 ID	해당 없음
    appSecret	Microsoft Entra ID 클라이언트 암호	해당 없음

11. 프로젝트 실행

    a. 패키지 탐색기에서 AppOwnesData를 마우스 오른쪽 단추로 클릭합니다.

    b. 다음 계정으로 실행>서버에서 실행을 선택합니다.

    c. 서버에서 실행 창에서 기존 서버 선택 및 Tomcat 서버를 선택합니다.

    d. 마침을 선택합니다.

Node JS

6. 선호하는 IDE를 사용하여 App Owns Data 폴더를 엽니다. 다음 중 하나를 사용하는 것이 좋습니다.

   • Visual Studio

   • Visual Studio Code

7. 터미널을 열고 npm install을 실행하여 필요한 종속성을 설치합니다.

8. Config 폴더를 확장하고 config.json을 엽니다.

9. 인증 방법에 따라 다음 매개 변수 값을 입력합니다.

   매개 변수	서비스 사용자	마스터 사용자
   authenticationMode	ServicePrincipal	MasterUser
   clientId	Microsoft Entra 앱 클라이언트 ID	Microsoft Entra 앱 클라이언트 ID
   workspaceId	포함된 보고서가 있는 작업 영역의 ID(작업 영역 ID 참조)	포함된 보고서가 있는 작업 영역의 ID(작업 영역 ID 참조)
   reportId	포함하는 보고서의 ID(보고서 ID 참조)	포함하는 보고서의 ID(보고서 ID 참조)
   pbiUsername	해당 없음	‘마스터 사용자’ 이름(Power BI 사용자 이름 및 암호 참조)
   pbiPassword	해당 없음	‘마스터 사용자’ 암호(Power BI 사용자 이름 및 암호 참조)
   clientSecret	Microsoft Entra ID 클라이언트 암호	해당 없음
   tenantId	Microsoft Entra 테넌트 ID	Microsoft Entra 테넌트 ID

10. 다음을 수행하여 프로젝트를 실행합니다.

    a. IDE 터미널에서 npm start를 실행합니다.

    b. 브라우저에서 새 탭을 열고http://localhost:5300(으)로 이동합니다.

Python

6. PowerShell 또는 명령 프롬프트를 엽니다.

7. Python>고객에 대한 콘텐츠 포함 폴더인지 그리고 폴더에 requirements.txt 파일이 있는지 확인하고 pip3 install -r requirements.txt를 실행합니다.

8. 선호하는 IDE를 사용하여 App Owns Data 폴더를 엽니다. 다음 환경 중 하나를 사용하는 것이 좋습니다.

   • Visual Studio

   • Visual Studio Code

9. config.py를 엽니다.

10. 인증 방법에 따라 다음 매개 변수 값을 입력합니다.

    매개 변수	서비스 사용자	마스터 사용자
    AUTHENTICATION_MODE	ServicePrincipal	MasterUser
    WORKSPACE_ID	포함된 보고서가 있는 작업 영역의 ID(작업 영역 ID 참조)	포함된 보고서가 있는 작업 영역의 ID(작업 영역 ID 참조)
    REPORT_ID	포함하는 보고서의 ID(보고서 ID 참조)	포함하는 보고서의 ID(보고서 ID 참조)
    TENANT_ID	Microsoft Entra 테넌트 ID	해당 없음
    CLIENT_ID	Microsoft Entra 앱 클라이언트 ID	Microsoft Entra 앱 클라이언트 ID
    CLIENT_SECRET	Microsoft Entra ID 클라이언트 암호	해당 없음
    POWER_BI_USER	해당 없음	‘마스터 사용자’ 이름(Power BI 사용자 이름 및 암호 참조)
    POWER_BI_PASS	해당 없음	‘마스터 사용자’ 암호(Power BI 사용자 이름 및 암호 참조)

11. 파일을 저장합니다.

12. 다음 단계를 수행하여 프로젝트를 실행합니다.

    a. PowerShell 또는 명령 프롬프트에서 Python>고객에 대한 콘텐츠 포함>AppOwnesData 폴더로 이동하고 flask run을 실행합니다.

    b. 브라우저에서 새 탭을 열고http://localhost:5000(으)로 이동합니다.

애플리케이션 개발

‘고객에 대한 콘텐츠 포함’ 애플리케이션 예제 구성하고 실행한 후에 애플리케이션 개발을 시작할 수 있습니다.

Power BI 임베디드 분석 플레이그라운드를 사용해 보고 개발을 시작하고 모든 새로운 Power BI Embedded 기능 및 업데이트를 확인하세요.

준비가 되면 프로덕션으로 이동 요구 사항을 검토하세요. 용량도 필요하므로 용량 계획 문서를 검토하여 요구 사항에 가장 잘 맞는 SKU가 무엇인지 확인하세요.

Important

개발을 위해 무료 평가판 포함 토큰을 사용한 경우 프로덕션용 용량을 구입해야 합니다. 용량을 구매할 때까지 평가판 버전 배너가 포함된 보고서의 맨 위에 계속 표시됩니다.

관련 콘텐츠

• 프로덕션으로 이동
• 조직에 포함
• 페이지를 매긴 보고서 포함

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