대상자: 회사 관리자, 팀 관리자
플랫폼: 브라우저, 데스크톱
Google Workspace 통합을 통해 사용자는 Google Docs, Sheets, 및 Slides 콘텐츠를 Miro 보드에 임베드할 수 있습니다. 이 가이드는 통합의 기술적 구현, 보안 모델 및 통합을 평가하거나 구성하는 관리자를 위한 데이터 처리 방식을 다룹니다.
주요 기능
- 라이브 임베드: 사용자는 Google 문서, 스프레드시트 또는 슬라이드 콘텐츠를 Miro 보드에 라이브 iFrame으로 임베드할 수 있습니다.
- 보안: 모든 보드 방문자는 임베드된 콘텐츠를 보기 전에 iFrame에서 로그인하라는 프롬프트가 표시됩니다.
- 표시 옵션: 사용자는 임베드된 콘텐츠를 라이브 임베드 또는 북마크로 표시하도록 선택할 수 있습니다.
- 집중 모드: 사용자는 라이브 임베드나 북마크를 확장해 집중 모드에서 방해 없이 볼 수 있습니다.
- 액션 바로가기: 사용자는 Google 문서, 스프레드시트 또는 슬라이드 링크를 임베드하는 대화상자를 여는 액션 바로가기를 추가할 수 있습니다.
- 에셋 선택기: 사용자는 특정 슬라이드를 보드에 정적 이미지로 추가할 수 있어 공동 작업자가 원본 파일에 접근할 필요 없이 해당 내용을 정확히 보고 참조할 수 있습니다.
- 관리자 제어: 관리자는 사용자가 에셋 선택기를 사용해 Google Slides 콘텐츠를 정적 이미지로 추가하지 못하도록 차단할 수 있습니다.
제한 사항
- 에셋 선택기는 Google Slides에서만 사용할 수 있습니다. Google Docs나 Google Sheets에서는 사용할 수 없습니다.
기술 구현
Miro는 Google REST API를 통해 Google Workspace와 통합됩니다. 사용자는 OAuth 2.0으로 접근 권한을 승인한 후 Google Docs, Sheets 또는 Slides 파일을 Miro 보드에 연결합니다.
보안 고려 사항
통합의 에셋 선택기는 사용자가 Google 슬라이드 파일의 일부를 정적 이미지로 캔버스에 첨부할 수 있게 합니다. 라이브 임베드는 권한이 있는 사용자만 접근할 수 있지만, 보드에 접근 권한이 있는 누구나 첨부된 정적 이미지를 볼 수 있습니다. 공개 보드에서는 기본적으로 임베드에서 에셋을 추가하는 기능이 꺼져 있습니다.
회사 관리자는 모든 보드에서 에셋 선택기를 끌 수 있습니다:
- 다음 경로로 이동하세요: 회사 설정 > 앱 및 통합 > 앱 > Google Office Integration App (앱 관리 탭 아래).
- 다음 설정을 전환하세요: 임베드에서 캔버스로 에셋 추가 방지.
데이터 흐름
- 이 기능이 활성화된 팀 또는 조직에 속한 사용자가 Google 문서, 스프레드시트 또는 슬라이드 링크를 Miro 보드에 붙여넣습니다.
- Miro가 링크를 읽습니다. 사용자가 아직 통합을 승인하지 않은 경우, Miro는 OAuth 흐름을 시작하고 사용자를 Google 권한 부여 페이지로 리디렉션합니다.
- 사용자가 권한을 부여하면 Miro의 통합 서비스가 사용자의 액세스 토큰을 사용해 Google REST API를 호출하고 콘텐츠를 가져옵니다.
Miro가 저장하는 Google 데이터
Miro는 붙여넣은 Google Workspace 링크에서 다음 데이터를 가져와 저장합니다:
- 문서 및 파일 제목
- 자산 선택기로 생성된 이미지
데이터 보유
임베드된 데이터는 모든 고객 데이터에 대한 Miro의 표준 보유 정책을 따릅니다.
인증 및 권한 부여
보드에 Google 문서, 스프레드시트 또는 슬라이드 링크를 임베드하려면 사용자가 Google의 OAuth 동의 화면에서 통합을 승인해야 합니다. 고객의 Google Workspace 구성에 따라 Google Workspace 관리자의 승인이 필요할 수도 있습니다.
필수 권한 범위
Google Workspace 통합에는 다음 권한 범위가 필요합니다:
https://www.googleapis.com/auth/presentations.readonly https://www.googleapis.com/auth/spreadsheets.readonly https://www.googleapis.com/auth/documents.readonly
Miro에 저장되는 항목 및 방식
Miro는 이 통합과 관련해 두 가지 유형의 데이터를 저장합니다: 권한 데이터와 언퍼링 데이터.
- 권한 데이터: Miro는 액세스 토큰과 리프레시 토큰을 데이터베이스에 며칠간 저장합니다. 권한이 활성 상태인 동안 만료된 액세스 토큰은 사용자가 다시 승인할 필요 없이 Miro가 리프레시 토큰으로 자동으로 갱신합니다. 이 통합을 위해 저장된 모든 데이터는 휴지 상태에서 256비트 AES로 암호화됩니다.
- 언퍼링 데이터: Miro는 언퍼링 데이터 두 가지를 저장합니다: 에셋 픽커로 캡처한 이미지(보드의 일부로 저장됨)와 제목 및 이미지 참조(내부 서비스에 암호화되어 저장됨).
토큰 취소
사용자는 Google Identity 가이드에 따라 언제든지 Google 계정에서 해당 통합의 접근 권한을 취소할 수 있습니다.
Google Workspace 통합 설정
참고: Miro 팀 관리자만 앱을 설치할 수 있습니다. Miro 조직에서 승인된 앱만 허용하는 경우, 일반 사용자가 Google Workspace 링크를 붙여넣으면 그 사용자에게 앱 설치 요청 대화상자가 표시됩니다.
통합을 설치하고 사용을 시작하려면:
- Google 문서, 시트 또는 슬라이드 파일 URL을 복사하세요.
- Miro 보드에 URL을 붙여넣으세요.
-
다음 단계는 링크를 붙여넣은 사람에 따라 달라집니다:
- Miro 팀 관리자: 앱이 자동으로 권한이 부여되고 설치되며, 추가 조치 없이 링크의 미리보기가 표시됩니다.
- 일반 사용자가 링크를 붙여넣고 조직에서 승인된 앱만 허용하는 경우: 앱 설치 요청 대화상자가 열립니다. 사용자가 권한을 요청하면 회사 관리자는 앱 요청 흐름 문서를 따라 요청을 승인할 수 있습니다.
Google 계정 연결
통합을 설치하고 권한을 부여한 후:
- 보드에 URL을 붙여넣으면 생성되는 위젯에서 연결을 클릭하세요. Miro가 계정에 접근할 수 있도록 허용해 달라는 Google 페이지로 이동합니다.
- Google 측에서 권한을 확인하세요. Google 콘텐츠가 iFrame으로 보드에 추가됩니다.
자주 묻는 질문
어떤 사용자가 Google 콘텐츠를 Miro에 임베드할 수 있나요?
사용자와 Miro 보드는 다음 두 가지 조건을 모두 충족해야 합니다:
- 사용자가 Miro Google Workspace 통합을 승인한 상태여야 합니다.
- 사용자가 임베드하려는 Google 콘텐츠에 접근 권한이 있어야 합니다.
임베드된 Google 콘텐츠를 누가 볼 수 있나요?
Miro 보드에 접근할 수 있고 임베드된 콘텐츠의 소유자가 부여한 보기·댓글·편집 권한을 가진 모든 사용자가 볼 수 있습니다. 뷰어는 보드에서 임베드된 콘텐츠를 보기 위해 통합을 승인하거나 Google 라이선스를 보유할 필요가 없습니다.
다른 보드에 링크를 붙여넣으려면 사용자가 다시 승인을 받아야 하나요?
아니요. 승인이 유효한 한 다시 승인할 필요가 없습니다. Miro는 승인을 받은 후 한 달 동안 이를 유효한 것으로 간주합니다. 사용자는 어떤 보드에서든 Google Workspace 링크를 붙여넣을 수 있으며, 콘텐츠는 정상적으로 가져와집니다.
보드가 해당 통합이 활성화되어 있지 않은 다른 팀이나 조직에 속한 경우, 사용자는 그곳에서 이 통합을 사용할 수 없습니다.
Google에서 직접 열 수 없는 Google 콘텐츠를 Miro에서 접근할 수 있나요?
아니요. 이미 접근 권한이 있는 Google 콘텐츠만 임베드할 수 있으며, 통합을 통해 Google에서 열 수 없는 콘텐츠를 볼 수는 없습니다. 다만 접근 권한이 있는 누군가가 해당 콘텐츠를 정적 이미지로 보드에 임베드해 당신과 공유한 경우에는 원본 파일에 직접 접근 권한이 없어도 그 스냅샷을 볼 수 있습니다. 이 통합은 이 외의 추가 접근 정책을 강제하지 않습니다. 협업할 수 있는 사람을 제한하려면 Miro 보드의 공유 설정을 사용하세요. 정적 이미지 스냅샷은 원본 데이터를 탐색하거나 원본 파일을 열거나 필터를 변경하는 데 사용할 수 없습니다.
Miro 데이터 처리 부속 합의서는 어디에서 찾을 수 있나요?
Miro 데이터 처리 부속합의서를 참조하세요.
공개 Miro 보드에서 허용되지 않는 항목
보안상의 이유로 공개 보드에서는 다음 기능을 끕니다:
- 에셋 추출 — Looker, Google Slides, Figma, Power BI, Microsoft Word, Microsoft Excel, 및 Microsoft PowerPoint 통합에서 지원됩니다.
- 직접 에셋 언펄링 (라이브 임베드 대신 에셋) — Figma 통합에서 지원됩니다.
보드 접근을 원본 파일에 접근 권한이 있는 사람과 동일하게 제한하려면 어떻게 하나요?
이 통합은 파일 접근 권한을 Miro가 아니라 소스 시스템인 Google에서만 관리합니다. 기본적으로 이 권한이 강제 적용되지는 않습니다 — 이 수준의 보안을 유지하려면 Miro 조직 관리자는 앱의 관리자 설정에서 에셋 선택기 끄기해야 합니다.
에셋 선택기를 끄면 Google 콘텐츠가 Miro 보드에 정적 이미지로 저장되는 것을 방지하여, 보드가 공개되거나 소스 파일에 대한 접근 권한이 없는 사람과 공유되는 경우에도 Google 접근 권한이 없는 사람이 해당 콘텐츠를 나중에 볼 수 없게 됩니다.