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

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

이 자습서에서는 다음과 같은 작업을 수행하는 방법을 알아봅니다.

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

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

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

중요

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

코드 샘플 사양

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

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

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

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox

필수 구성 요소

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

메서드

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

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

  2. Azure AD 애플리케이션을 등록합니다.

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

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

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

  6. 서비스 주체 API 액세스

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

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

1단계 - 인증 방법 선택

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

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

고려 사항 서비스 사용자 마스터 사용자
메커니즘 Azure AD 앱의 서비스 주체 개체를 통해 Azure AD가 Power BI에 대해 포함된 솔루션 앱을 인증할 수 있습니다. Azure AD 앱은 Power BI 사용자의 자격 증명(사용자 이름 및 암호)을 사용하여 Power BI에 대해 인증합니다.
보안 ‘서비스 주체’는 Azure AD 권장 권한 부여 방법입니다. 서비스 주체를 사용하는 경우 애플리케이션 비밀 또는 인증서를 사용하여 인증할 수 있습니다.

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

2단계 - Azure AD 애플리케이션 등록

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

애플리케이션을 Azure AD에 등록하려면 애플리케이션 등록의 지침을 따르세요.

참고

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

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

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

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

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

  1. Power BI에 로그인합니다.

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

  3. 작업 영역 만들기를 선택합니다.

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

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

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

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

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

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

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

    Power BI Desktop 샘플 GitHub의 ZIP 다운로드 옵션을 보여 주는 스크린샷

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

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

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

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

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

매개 변수 서비스 사용자 마스터 사용자
클라이언트 ID 적용 대상 적용 대상
작업 영역 ID 적용 대상 적용 대상
보고서 ID 적용 대상 적용 대상
클라이언트 암호 적용 대상 미적용 대상
테넌트 ID 적용 대상 미적용 대상
Power BI 사용자 이름 미적용 대상 적용 대상
Power BI 암호 미적용 대상 적용 대상

클라이언트 ID

적용 대상: 적용됨.서비스 주체 적용됨.마스터 사용자

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

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

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

  3. Power BI 콘텐츠를 포함하는 데 사용하는 Azure AD 앱을 선택합니다.

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

작업 영역 ID

적용 대상: 적용됨.서비스 주체 적용됨.마스터 사용자

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

  1. Power BI 서비스에 로그인합니다.

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

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

    Power BI 서비스 URL의 작업 영역 ID GUID를 보여 주는 스크린샷

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

작업 영역 ID를 관리자 설정에서 찾는 방법을 보여 주는 스크린샷.

보고서 ID

적용 대상: 적용됨.서비스 주체 적용됨.마스터 사용자

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

  1. Power BI 서비스에 로그인합니다.

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

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

    Power BI 서비스 URL의 보고서 ID GUID를 보여 주는 스크린샷

클라이언트 암호

적용 대상:적용됨.서비스 주체 적용되지 않음.마스터 사용자

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

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

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

  3. Power BI 콘텐츠를 포함하는 데 사용하는 Azure AD 앱을 선택합니다.

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

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

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

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

참고

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

테넌트 ID

적용 대상:적용됨.서비스 주체 적용되지 않음.마스터 사용자

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

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

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

  3. Power BI 콘텐츠를 포함하는 데 사용하는 Azure AD 앱을 선택합니다.

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

Power BI 사용자 이름 및 암호

적용 대상:적용되지 않음.서비스 주체 적용됨.마스터 사용자

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

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

적용 대상:적용됨.서비스 주체 적용되지 않음.마스터 사용자

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

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

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

    Power BI 서비스 설정 메뉴의 관리 설정 메뉴 옵션을 보여 주는 스크린샷.

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

  3. 서비스 주체가 Power BI API를 사용하도록 허용을 확장하고 이 옵션을 사용하도록 설정합니다.

    Power BI 서비스에서 테넌트 설정 메뉴 옵션의 개발자 설정 옵션을 사용하도록 설정하는 방법을 보여 주는 스크린샷.

참고

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

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

Azure AD 앱이 Power BI 서비스의 보고서, 대시보드, 데이터 세트와 같은 개체에 액세스할 수 있도록 하려면 서비스 주체 또는 마스터 사용자를 작업 영역에 멤버 또는 관리자로 추가합니다.

  1. Power BI 서비스에 로그인합니다.

  2. 액세스를 사용하도록 설정할 작업 영역으로 스크롤한 다음 자세히 메뉴에서 작업 영역 액세스를 선택합니다.

    Power BI 작업 영역의 추가 메뉴에 있는 작업 영역 액세스 단추를 보여 주는 스크린샷.

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

    참고

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

  4. 추가를 선택합니다.

8단계 - 콘텐츠 포함

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

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

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

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

    Power BI 개발자 샘플 GitHub의 ZIP 다운로드 옵션을 보여 주는 스크린샷

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

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

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

    참고

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

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

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

  2. appsettings.json을 엽니다.

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

    매개 변수 서비스 사용자 마스터 사용자
    AuthenticationMode ServicePrincipal MasterUser
    ClientId Azure AD 앱 클라이언트 ID Azure AD 앱 클라이언트 ID
    TenantId Azure AD 테넌트 ID 해당 없음
    PbiUsername 해당 없음 ‘마스터 사용자’ 이름(Power BI 사용자 이름 및 암호 참조)
    PbiPassword 해당 없음 ‘마스터 사용자’ 암호(Power BI 사용자 이름 및 암호 참조)
    ClientSecret Azure AD 클라이언트 암호 해당 없음
    WorkspaceId 포함된 보고서가 있는 작업 영역의 ID(작업 영역 ID 참조) 포함된 보고서가 있는 작업 영역의 ID(작업 영역 ID 참조)
    ReportId 포함하는 보고서의 ID(보고서 ID 참조) 포함하는 보고서의 ID(보고서 ID 참조)
  4. 적절한 옵션을 선택하여 프로젝트를 실행합니다.

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

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

애플리케이션 배포

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

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

중요

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

다음 단계