Power BI 관리자 가이드

플랜: Free, Starter, Business, Education, Enterprise
사용자: 회사 관리자, 팀 관리자
플랫폼: 브라우저, 데스크톱

Power BI 통합을 통해 사용자는 Miro 보드에 Power BI 보고서와 대시보드를 임베드할 수 있습니다. 이 가이드는 통합을 평가하거나 구성하려는 관리자를 위해 설정, 기술적 구현, 보안 모델 및 데이터 처리 방식을 안내합니다.

주요 기능

• 라이브 임베드: 사용자는 Power BI 보고서나 대시보드를 Miro 보드에 라이브 iFrame으로 임베드할 수 있습니다.
• 보안: 모든 보드 방문자는 임베드된 콘텐츠를 보기 전에 iFrame에 로그인하라는 프롬프트가 표시됩니다.
• 표시 옵션: 사용자는 임베드된 콘텐츠를 라이브 임베드나 북마크로 표시하도록 선택할 수 있습니다.
• 집중 모드: 사용자는 라이브 임베드나 북마크를 확장해 집중 모드에서 방해 없이 볼 수 있습니다.
• 액션 바로가기: 사용자는 Power BI 링크를 임베드하기 위한 대화상자를 여는 액션 바로가기를 추가할 수 있습니다.
• 에셋 픽커: 사용자는 특정 보고서 비주얼을 보드에 정적 이미지로 추가해 공동 작업자가 소스 파일에 접근하지 않아도 해당 콘텐츠를 확인하고 참조할 수 있습니다.
• 관리자 제어: 관리자는 사용자가 에셋 픽커를 사용해 Power BI 콘텐츠를 정적 이미지로 추가하지 못하도록 차단할 수 있습니다.

요구 사항 및 제한

Power BI Cloud 구독이 필요합니다. 지원되는 구독:

• Power BI Premium per capacity SKU
• Fabric Capacity Reservation SKU

제한 사항:

• 데이터셋 링크 임베드는 지원되지 않습니다.
• "Dashboard" 유형의 임베드는 지원되지 않습니다.
• 공유 메뉴 링크는 보고서 비주얼에서만 지원됩니다.
• 에셋 선택기로 추가한 이미지는 새로 고침할 수 없습니다. 이 기능은 개발 중입니다.
• 공개 보드에는 임베드할 수 없습니다.

Power BI 통합 설정

사전 요구 사항

• 회사 관리자가 Miro 조직의 Power BI 통합을 승인했습니다.
• Microsoft 테넌트에서 통합을 승인하려면 Microsoft Entra 관리자 권한이 있어야 합니다.

Microsoft Entra에서 통합 승인

현재 버전의 Miro Power BI 앱은 고객의 Microsoft 테넌트에 설치하려면 관리자 동의가 필요합니다.

1. 관리자 권한으로 Microsoft Entra에 로그인한 후 엔터프라이즈 애플리케이션 > 동의 및 권한으로 이동합니다.
2. 다음 항목을 예로 설정합니다: 사용자가 동의할 수 없는 애플리케이션에 대해 관리자 동의를 요청할 수 있음.
3. 관리자 동의 요청을 검토할 수 있는 사람에서 이 요청을 검토할 사용자, 역할 또는 그룹을 선택합니다.
4. 구성이 완료되면 관리자가 아닌 사용자가 통합이 활성화된 팀의 Miro 보드에 Power BI 링크를 붙여넣어 승인 요청을 생성할 수 있습니다.
5. 3단계에서 선택한 관리자들은 엔터프라이즈 애플리케이션 > 관리자 승인 요청으로 이동해 요청을 검토하고 승인할 수 있습니다. 승인이 완료되면 통합은 테넌트의 모든 사용자가 개별적으로 권한을 부여할 수 있게 됩니다.

Miro에서 통합 설치 및 권한 부여

참고: 앱은 Miro 팀 관리자만 설치할 수 있습니다. Miro 조직에서 승인된 앱만 허용하는 경우 일반 사용자가 Power BI 링크를 붙여넣으면 해당 사용자는 대신 앱 설치 요청 대화상자를 보게 됩니다.

1. Power BI 리포트 또는 대시보드의 URL을 복사하세요.
2. URL을 Miro 보드에 붙여넣으세요.
3. 다음에 일어나는 일은 링크를 붙여넣은 사용자에 따라 달라집니다:
   • Miro 팀 관리자가 링크를 붙여넣은 경우: 앱이 자동으로 권한 부여 및 설치되며, 링크 미리보기가 별도 조치 없이 표시됩니다.
   • 일반 사용자가 링크를 붙여넣고 조직에서 승인된 앱만 허용하는 경우: 앱 설치 요청 대화상자가 열립니다. 사용자가 권한을 요청하면, 회사 관리자는 앱 요청 흐름 문서를 참고해 요청을 승인할 수 있습니다.

Power BI 계정 연결

통합이 설치되고 권한이 승인된 후:

1. 보드에 URL을 붙여넣은 후 생성된 위젯에서 연결을 클릭합니다. Miro가 Power BI 계정에 접근할 수 있도록 권한을 부여하라는 페이지로 이동합니다.
2. Microsoft 측에서 권한을 확인합니다. 임베드할 차트를 선택할 수 있는 대화상자가 열립니다. 차트를 선택한 다음 차트 추가를 클릭합니다. 선택한 차트가 보드에 추가됩니다.

기술적 구현

Miro는 Power BI REST API와 Power BI embedded analytics client APIs를 통해 Power BI와 통합됩니다. 사용자는 OAuth 2.0으로 액세스 권한을 승인한 다음 자신의 Power BI 보고서나 대시보드를 Miro 보드에 연결합니다.

보안 고려사항

통합의 에셋 선택기는 사용자가 Power BI 보고서의 일부를 정적 이미지로 캔버스에 첨부할 수 있게 합니다. 라이브 임베드는 권한이 있는 사용자만 접근할 수 있지만, 보드에 접근 권한이 있는 누구나 첨부된 정적 이미지를 볼 수 있습니다. 공개 보드에서는 임베드에서 에셋을 추가하는 기능이 기본적으로 꺼져 있습니다.

회사 관리자는 모든 보드에서 자산 선택기를 끌 수 있습니다:

1. 다음으로 이동하세요: 회사 설정 > 앱 및 통합 > 앱 > Power BI (앱 관리 탭 아래).
2. 다음 옵션을 끕니다: 임베드에서 자산을 캔버스에 추가하지 못하도록 차단.

데이터 흐름

1. 해당 기능이 활성화된 팀 또는 조직에 속한 사용자가 Power BI 링크를 Miro 보드에 붙여넣습니다.
2. Miro가 링크를 읽습니다. 사용자가 아직 통합에 대한 권한을 부여하지 않았다면 Miro는 OAuth 흐름을 시작하여 사용자를 Microsoft의 권한 부여 페이지로 리디렉션합니다.
3. 사용자가 권한을 부여하면 Miro의 통합 서비스가 사용자의 액세스 토큰으로 Power BI REST API를 호출해 콘텐츠를 가져옵니다.

Miro가 저장하는 Power BI 데이터

Miro는 붙여넣은 Power BI 링크에서 다음 데이터를 가져와 저장합니다:

• Power BI 대시보드의 타일 이미지
• Power BI 보고서의 비주얼 이미지
• Power BI 대시보드, 보고서, 비주얼 및 타일의 제목
• Power BI 보고서의 페이지 이름
• Power BI 보고서의 필터 이름과 값
• 에셋 선택기로 생성된 이미지

데이터 보유

임베드된 데이터는 모든 고객 데이터에 대한 Miro의 표준 보유 정책을 따릅니다.

인증 및 권한 부여

보드에 Power BI 링크를 삽입하려면 사용자가 Microsoft의 OAuth API를 통해 통합을 승인해야 합니다. 또한 Microsoft Entra 관리자 승인이 필요합니다 — 위의 Microsoft Entra에서 통합 승인을 참조하세요.

필수 권한 범위

Power BI 통합에는 다음 권한 범위가 필요합니다:

• offline_access — 토큰을 갱신하려면 필요합니다.
• https://analysis.windows.net/powerbi/api/Dashboard.Read.All — 모든 대시보드를 읽으려면 필요합니다.
• https://analysis.windows.net/powerbi/api/Dataset.Read.All — 모든 데이터셋을 읽으려면 필요합니다.
• https://analysis.windows.net/powerbi/api/Report.Read.All — 모든 보고서를 읽으려면 필요합니다.
• https://analysis.windows.net/powerbi/api/UserState.ReadWrite.All — 필터 상태를 지속하려면 필요합니다.

Miro에 저장되는 항목과 방법

Miro는 이 통합을 위해 권한 부여 데이터와 미리보기 데이터를 포함한 두 가지 유형의 데이터를 저장합니다.

권한 데이터: Miro는 액세스 토큰과 리프레시 토큰을 수일간 데이터베이스에 저장합니다. 권한이 활성 상태인 동안 Miro는 사용자가 다시 승인할 필요 없이 리프레시 토큰으로 만료된 액세스 토큰을 자동으로 갱신합니다. 이 통합에 저장된 모든 데이터는 256비트 AES로 저장 시 암호화됩니다.

미리보기 데이터: Miro는 미리보기 데이터를 두 가지로 저장합니다. 에셋 픽커로 캡처한 이미지는 보드의 일부로 저장되며, 제목과 이미지 참조는 내부 서비스에 암호화되어 저장됩니다.

토큰 취소

Microsoft Entra 관리자는 통합의 액세스 권한을 취소할 수 있습니다 — 애플리케이션 액세스 취소에 대한 Microsoft 가이드를 참조하세요.

자주 묻는 질문

통합을 어떻게 비활성화하나요?

Microsoft Entra 관리자는 앱을 삭제해 Miro 통합의 권한을 취소할 수 있습니다: Enterprise applications > All applications로 이동해 Contenthub Power BI Integration 애플리케이션을 선택한 다음 Properties > Delete를 선택하세요.

어떤 사용자가 Miro에 Power BI 콘텐츠를 임베드할 수 있나요?

사용자와 Miro 보드는 다음 두 가지 조건을 모두 충족해야 합니다:

• 사용자가 Miro Power BI 통합을 승인해야 합니다.
• 사용자가 임베드하려는 Power BI 콘텐츠에 접근 권한이 있어야 합니다.

어떤 사용자가 임베드된 Power BI 콘텐츠를 볼 수 있나요?

Miro 보드에 접근 권한이 있고 임베드된 콘텐츠의 소유자가 허용한 사용자, 즉 보드에 대한 보기, 댓글 또는 편집 권한이 있는 사용자라면 누구나 접근할 수 있습니다. 뷰어는 보드에서 임베드된 콘텐츠를 보기 위해 통합을 승인하거나 Power BI 라이선스를 보유할 필요가 없습니다.

사용자가 다른 보드에 링크를 붙여넣으려면 다시 승인해야 하나요?

아니요. 승인이 여전히 유효한 한, Miro에서는 승인이 부여된 후 1개월 동안 유효한 것으로 간주합니다. 사용자는 어떤 보드에든 Power BI 링크를 붙여넣을 수 있으며 콘텐츠가 정상적으로 가져와집니다.

해당 보드가 이 통합이 활성화되지 않은 다른 팀이나 조직에 속한 경우, 사용자는 그곳에서 해당 기능을 사용할 수 없습니다.

Power BI에서 직접 접근할 수 없는 콘텐츠를 Miro를 통해 접근할 수 있나요?

아니요. 이미 접근 권한이 있는 Power BI 콘텐츠만 임베드할 수 있으며 — 접근 권한이 없어 Power BI에서 열 수 없는 콘텐츠를 보기 위해 이 통합을 사용할 수는 없습니다. 다만, 접근 권한이 있는 누군가가 이미 당신과 공유한 보드에 해당 콘텐츠를 정적 이미지로 임베드해둔 경우, 원본 파일에 대한 직접 접근 권한이 없어도 그 스냅샷을 볼 수 있습니다. 통합은 이 외에 추가적인 접근 정책을 적용하지 않습니다. 협업 가능 대상을 제한하려면 Miro 보드의 공유 설정을 사용하세요. 정적 이미지 스냅샷으로는 기본 데이터를 탐색하거나 원본 보고서를 열거나 필터를 변경할 수 없습니다.

Miro 데이터 처리 추가 합의서는 어디에서 찾을 수 있나요?

자세한 내용은 Miro 데이터 처리 추가 합의서를 참조하세요.

공개 Miro 보드에서 허용되지 않는 항목은 무엇인가요?

보안상의 이유로 공개 보드에서는 다음 기능이 비활성화됩니다:

• 자산 추출 — Looker, Google Slides, Figma, Power BI, Microsoft Word, Microsoft Excel 및 Microsoft PowerPoint 통합에서 지원됩니다.
• 직접 자산 펼치기 (라이브 임베드 대신 에셋으로 표시) — Figma 통합에서 지원됩니다.

보드 접근을 원본 파일에 접근 권한이 있는 사람으로 제한하려면 어떻게 하나요?

이 통합은 Miro가 아닌 소스 시스템(Power BI)의 파일 접근만 관리합니다. 기본적으로 이는 강제되지 않습니다 — 이 수준의 보안을 유지하려면 Miro 조직 관리자가 앱의 관리자 설정에서 애셋 선택기를 꺼야 합니다(자세한 내용은 보안 고려사항 참조).

에셋 선택기를 비활성화하면 Power BI 콘텐츠가 Miro 보드에 정적 이미지로 저장되는 것을 방지해, 예를 들어 보드가 공개되거나 소스에 대한 접근 권한이 없는 사람들과 공유되는 경우 해당 콘텐츠를 이후에 볼 수 없게 합니다.