대상: 회사 관리자
Looker 통합을 통해 사용자는 Looker 대시보드와 Explore를 Miro 보드에 임베드할 수 있습니다. 이 가이드는 관리자가 통합을 평가하거나 구성할 때 설정, 통합의 기술적 구현, 보안 모델 및 데이터 처리 방식을 다룹니다.
주요 기능
- 라이브 임베드: 사용자는 Looker 대시보드나 Explore를 Miro 보드에 라이브 iFrame으로 임베드할 수 있습니다.
- 보안: 임베드된 콘텐츠를 보기 전에 모든 보드 방문자에게 iFrame 로그인을 요청합니다.
- 표시 옵션: 사용자는 임베드된 콘텐츠를 라이브 임베드로 표시하거나 북마크로 표시하도록 선택할 수 있습니다.
- 집중 모드: 사용자는 라이브 임베드나 북마크를 확장해 집중 모드로 전환하여 방해 요소 없이 볼 수 있습니다.
- 액션 바로가기: 사용자는 Looker 링크를 임베드하는 대화상자를 여는 액션 바로가기를 추가할 수 있습니다.
- 에셋 선택기: 사용자는 특정 차트나 타일을 보드에 정적 이미지로 추가할 수 있어 공동 작업자가 원본 파일에 대한 접근 권한 없이도 해당 내용을 그대로 보고 참조할 수 있습니다.
- 관리자 설정: 관리자는 사용자가 에셋 선택기로 Looker 콘텐츠를 정적 이미지로 추가하지 못하도록 차단할 수 있습니다.
제한 사항
- Looker Studio는 지원되지 않습니다.
- Looker Looks는 지원되지 않습니다.
- Looker 병합 쿼리나 Looker 보드 링크의 임베드는 지원되지 않습니다.
- 자산 선택기로 추가한 이미지는 새로고침할 수 없습니다.
알려진 이슈
브라우저나 Miro 데스크톱 앱에서 이미 인증된 사용자가 다른 브라우저나 Miro 앱으로 전환하면 인증 문제가 발생할 수 있습니다. 이로 인해 인증 흐름이 끊기고 Looker에 대한 접근이 중단될 수 있습니다.
Looker 통합 설정
사전 요구 사항
- 회사 관리자가 Miro 조직에 대해 Looker를 승인했습니다.
- Miro를 Looker에 OAuth 앱으로 등록하려면 Looker 관리자 권한이 있어야 합니다.
Looker에서 OAuth 앱 등록
- Looker 마켓플레이스에서 API Explorer extension을 찾아 선택한 다음, Install을 선택합니다.
- Home > Applications > API Explorer로 이동합니다.
- API Explorer 검색 상자에
oauth를 입력한 다음, Auth 아래에서 Register OAuth App을 선택합니다. - 페이지 오른쪽 상단에서 실행을 선택하세요.
-
요청 양식에 다음 값을 입력하세요:
-
client_guid:
15609152-a12a-4fa1-b364-337e7896d25d -
본문:
{ "redirect_uri": "https://integrations.miro.com/api/contenthub/public/oauth/callback", "display_name": "Miro", "description": "Miro Looker Integration", "enabled": true, "group_id": "" } - fields는 비워 두세요.
더 고급 옵션 — 예를 들어
group_id로 특정 Looker 그룹에 권한을 제한하는 방법 — 은 Looker의 OAuth 앱 등록 문서(외부)를 참조하세요. -
client_guid:
- 다음 항목을 선택하세요: 이 API 엔드포인트가 데이터를 변경한다는 점을 이해합니다.
- 다음 항목을 선택하세요: 실행. 실행이 성공하면 요청 본문과 HTTP 200 응답이 반환됩니다.
반환된 본문에"enabled": false가 포함되어 있으면 같은 값으로 OAuth 앱 업데이트를 실행해 클라이언트를 활성화하세요.
Miro에 통합 설치 및 권한 부여
참고: 앱은 Miro 팀 관리자만 설치할 수 있습니다. 사용 중인 Miro 조직에서 승인된 앱만 허용하고 일반 사용자가 Looker 링크를 붙여넣으면 해당 사용자는 대신 앱 설치 요청 대화상자를 보게 됩니다.
- Looker 대시보드 또는 Explore의 URL을 복사합니다.
- URL을 Miro 보드에 붙여넣습니다.
- 무슨 일이 일어나는지는 링크를 붙여넣은 사람에 따라 다릅니다:
- Miro 팀 관리자가 링크를 붙여넣은 경우: 앱이 자동으로 권한을 승인받아 설치되며, 링크는 추가 조치 없이 자동으로 미리보기가 생성됩니다.
-
일반 사용자가 링크를 붙여넣었고 조직에서 승인된 앱만 허용하는 경우: 앱 설치 요청 대화 상자가 열립니다. 사용자가 권한을 요청하면 회사 관리자들은 앱 요청 워크플로 문서를 따라 요청을 승인할 수 있습니다.
Looker 계정 연결
통합이 설치되고 권한이 부여되면:
- 보드에 URL을 붙여넣어 생성된 위젯에서 연결을 클릭하세요. Miro가 Looker 계정에 접근할 수 있도록 권한을 부여해 달라는 페이지로 이동합니다.
- Looker 쪽에서 권한을 확인하세요. Looker 콘텐츠가 iFrame으로 보드에 추가됩니다.
기술적 구현
Miro는 Looker REST API를 통해 Looker와 통합됩니다. 사용자는 OAuth 2.0으로 액세스 권한을 승인한 다음, Looker 대시보드나 Explore를 Miro 보드에 연결합니다.
보안 고려사항
이 통합의 에셋 선택기는 사용자가 Looker 차트나 타일을 정적 이미지로 캔버스에 첨부할 수 있게 합니다. 라이브 임베드에는 권한이 있는 사용자만 접근할 수 있지만 보드에 접근 권한이 있는 사용자는 누구나 첨부된 정적 이미지를 볼 수 있습니다. 공개 보드에서는 임베드에서 자산을 추가하는 기능이 기본적으로 비활성화되어 있습니다.
회사 관리자는 모든 보드에서 에셋 선택기를 끌 수 있습니다:
- 다음으로 이동: 회사 설정 > 앱 및 통합 > 앱 > Unfurl Looker (앱 관리 탭 아래).
- 다음 항목을 토글합니다: 임베드에서 자산을 캔버스에 추가하지 못하도록 방지.
데이터 흐름
- 이 기능이 활성화된 팀 또는 조직에 속한 사용자가 Looker 링크를 Miro 보드에 붙여넣습니다.
- Miro가 링크를 읽습니다. 사용자가 아직 통합을 승인하지 않았다면 Miro가 OAuth 흐름을 시작하고 사용자를 Looker의 권한 부여 페이지로 리디렉션합니다.
- 사용자가 권한을 부여하면 Miro의 통합 서비스가 사용자의 액세스 토큰을 사용해 Looker REST API를 호출하고 콘텐츠를 가져옵니다.
Miro가 저장하는 Looker 데이터
Miro는 붙여넣은 Looker 링크에서 다음 데이터를 가져와 저장합니다:
- 대시보드 및 Explore 제목
- 에셋 픽커로 생성된 이미지
데이터 보유
임베디드 데이터는 모든 고객 데이터에 적용되는 Miro의 표준 보유 정책을 따릅니다.
인증 및 권한 부여
보드에 Looker 링크를 임베드하려면 사용자가 Looker의 OAuth API를 통해 통합을 승인해야 합니다. 또한 Looker 관리자가 Miro를 OAuth 앱으로 등록해야 합니다 — 위의 Looker에서 OAuth 앱 등록을 참조하세요.
필요한 권한 범위
Looker 통합에는 다음 권한 범위가 필요합니다:
apiMiro에 저장되는 항목과 방식
Miro는 이 통합을 위해 두 가지 범주의 데이터를 저장합니다: 권한 데이터와 언펄링 데이터.
권한 데이터: Miro는 액세스 토큰과 리프레시 토큰을 며칠 동안 데이터베이스에 저장합니다. 권한이 활성화된 동안 Miro는 리프레시 토큰을 사용해 만료된 액세스 토큰을 자동으로 갱신하며 사용자가 재승인할 필요가 없습니다. 이 통합을 위해 저장된 모든 데이터는 저장 시 256비트 AES로 암호화됩니다.
언펄링 데이터: Miro는 두 가지 유형의 언펄링 데이터를 저장합니다: 에셋 픽커로 캡처한 이미지(보드의 일부로 저장됨)와 제목 및 이미지 참조(내부 서비스에 암호화되어 저장됨).
토큰 취소
Looker 관리자는 Looker 관리자 콘솔에서 이 통합의 액세스를 취소할 수 있습니다:
- Admin > Users로 이동하세요.
- 사용자를 선택하세요.
- API Keys로 스크롤한 다음 토큰 옆의 Delete를 선택하세요.
자주 묻는 질문
통합을 어떻게 끄나요?
Looker에서 Miro OAuth 앱 삭제. 이미 Miro 보드에 임베드된 Looker 데이터는 삭제되지 않지만, 새 콘텐츠를 임베드하거나 기존 자산을 새로 고치는 것은 중단됩니다.
어떤 사용자가 Looker 콘텐츠를 Miro에 임베드할 수 있나요?
사용자와 Miro 보드는 다음 두 가지 조건을 모두 충족해야 합니다:
- 사용자가 Miro Looker 통합을 승인했습니다.
- 사용자가 임베드하려는 Looker 콘텐츠에 접근 권한이 있습니다.
임베드된 Looker 콘텐츠를 볼 수 있는 사용자는 누구인가요?
Miro 보드에 접근 권한이 있고 임베드된 콘텐츠의 소유자가 허용한 모든 사용자, 즉 보드에 대한 보기, 댓글 또는 편집 권한이 있는 사용자입니다. 뷰어는 보드에서 임베드된 콘텐츠를 보려면 통합을 승인하거나 Looker 라이선스를 보유할 필요가 없습니다.
다른 보드에 링크를 붙여넣으려면 사용자가 다시 승인을 받아야 하나요?
아니요. 승인이 부여된 후 한 달 동안 유효하는 한 사용자는 어떤 보드에든 Looker 링크를 붙여넣을 수 있으며, 콘텐츠가 정상적으로 불러와집니다.
보드가 이 통합이 활성화되어 있지 않은 다른 팀이나 조직에 속해 있으면 사용자는 그곳에서 통합을 사용할 수 없습니다.
Looker에서 직접 접근할 수 없는 Looker 콘텐츠를 Miro를 통해 볼 수 있나요?
아니요. 사용자는 이미 접근 권한이 있는 Looker 콘텐츠만 임베드할 수 있으며, Looker에서 열 수 없는 콘텐츠를 보기 위해 통합을 사용할 수 없습니다. 다만, 접근 권한이 있는 사용자가 해당 콘텐츠를 정적 이미지로 보드에 임베드해 함께 공유한 경우에는 원본 파일에 직접 접근할 수 없어도 그 스냅샷을 볼 수 있습니다. 통합은 이에 대한 추가 접근 정책을 적용하지 않습니다. 협업 가능한 사용자는 Miro 보드의 공유 설정으로 제한하세요. 정적 이미지 스냅샷에서는 기본 데이터를 탐색하거나 원본 차트를 열거나 필터를 변경할 수 없습니다.
Miro 데이터 처리 부속 합의서는 어디에서 확인할 수 있나요?
다음 문서를 참조하세요: Miro 데이터 처리 부속합의서.
공개 Miro 보드에서 허용되지 않는 항목은 무엇인가요?
보안상 공개 보드에서는 다음을 비활성화합니다:
- 에셋 추출 — Looker, Google Slides, Figma, Power BI, Microsoft Word, Microsoft Excel, Microsoft PowerPoint 통합에서 지원됩니다.
- 직접 에셋 미리보기 (라이브 임베드 대신 에셋) — Figma 통합에서 지원됩니다.
소스 파일에 접근 권한이 있는 사람들과 동일한 사람만 보드에 접근하도록 어떻게 제한하나요?
통합은 파일 접근을 소스 시스템(Looker)에서만 관리하고 Miro에서는 관리하지 않습니다. 기본적으로 이 보안은 적용되지 않습니다 — 이 수준의 보안을 유지하려면 Miro 조직 관리자가 앱의 관리자 설정에서 에셋 픽커를 꺼야 합니다(보안 고려사항).
에셋 픽커를 끄면 Looker 콘텐츠가 Miro 보드에 정적 이미지로 저장되는 것을 방지할 수 있습니다. 정적 이미지로 저장되면 보드를 공개로 공유하거나 소스 접근 권한이 없는 사람과 공유한 경우처럼 Looker 접근 권한이 없는 사람이 나중에 해당 이미지를 볼 수 있게 됩니다.