Box (관리자 문서)

사용자 목록: 회사 관리자, 팀 관리자
플랫폼: 브라우저, 데스크톱

Box 통합을 통해 사용자는 Box 파일을 Miro 보드에 임베드할 수 있습니다. 이 가이드는 통합을 평가하거나 구성하는 관리자에게 통합의 기술적 구현, 보안 모델 및 데이터 처리 방식을 설명합니다.

주요 기능

• 라이브 임베드: 사용자는 Box 콘텐츠를 Miro 보드에 라이브 iFrame으로 임베드할 수 있습니다.
• 보안: 모든 보드 방문자는 임베드된 콘텐츠를 보기 전에 iFrame에 로그인하라는 프롬프트가 표시됩니다.
• 표시 옵션: 사용자는 임베드된 콘텐츠를 라이브 임베드로 표시하거나 북마크로 전환하도록 선택할 수 있습니다.
• 집중 모드: 사용자는 라이브 임베드나 북마크를 집중 모드로 확장해 방해 요소 없이 볼 수 있습니다.
• 작업 바로가기: 사용자는 Box 링크를 임베드하기 위한 대화상자를 여는 작업 바로가기를 추가할 수 있습니다.

제한 사항

• 이 통합에서는 자산 선택기를 사용할 수 없습니다.

기술적 구현

Miro는 Box REST API를 통해 Box와 통합됩니다. 사용자는 OAuth 2.0으로 권한을 부여한 후 Box 파일을 Miro 보드에 연결합니다.

데이터 흐름

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

Miro가 저장하는 Box 데이터

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

• 문서 및 파일 제목

데이터 보유

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

인증 및 권한 부여

보드에 Box 링크를 임베드하려면 사용자가 Box의 OAuth 동의 화면에서 통합을 승인해야 합니다. 고객의 Box 구성에 따라 Box 관리자의 승인이 추가로 필요할 수 있습니다.

필요한 권한 범위

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

• root_readonly — Box에 저장된 모든 파일과 폴더를 읽습니다.

Miro에 저장되는 항목 및 저장 방식

Miro는 이 통합을 위해 두 가지 유형의 데이터를 저장합니다: 권한 부여 데이터와 언퍼럴링 데이터.

• 권한 부여 데이터: Miro는 액세스 토큰과 리프레시 토큰을 며칠간 데이터베이스에 저장합니다. 권한 부여가 활성 상태인 동안에는 사용자가 재승인할 필요 없이 Miro가 리프레시 토큰으로 만료된 액세스 토큰을 자동으로 갱신합니다. 이 통합을 위해 저장된 모든 데이터는 256비트 AES로 저장 시 암호화됩니다.
• 언퍼럴링 데이터: Miro는 자산의 제목을 Miro 보드의 일부로 저장하며, 제목과 이미지 참조는 내부 서비스에 암호화된 상태로 저장합니다.

토큰 무효화

사용자는 Box 계정 설정에서 언제든지 Box 통합 연결을 해제할 수 있습니다.

Box 통합 설정

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

통합을 설치하고 사용을 시작하려면:

1. Box 파일 URL을 복사하세요.
2. URL을 Miro 보드에 붙여넣으세요.

3. 다음에 어떤 일이 발생하는지는 링크를 붙여넣은 사람에 따라 달라집니다:

   • Miro 팀 관리자가 링크를 붙여넣은 경우: 앱이 자동으로 승인·설치되며 링크는 추가 조치 없이 미리보기로 표시됩니다.
   • 일반 사용자가 링크를 붙여넣었고 조직에서 승인된 앱만 허용하는 경우: 앱 설치 요청 대화상자가 열립니다. 사용자가 권한을 요청하면 회사 관리자는 요청을 승인하기 위해 앱 요청 흐름 문서를 참고할 수 있습니다.

   

Box 계정 연결

통합이 설치되고 권한이 부여된 후:

1. 보드에 URL을 붙여넣어 생성된 위젯에서 연결을 클릭합니다. Miro가 Box 계정에 접근할 수 있도록 권한을 요청하는 페이지로 이동합니다.
2. Box 계정 신원정보를 입력하고 승인을 클릭합니다.
3. Miro가 Box 파일에 접근할 수 있도록 Box에 액세스 허용을 클릭합니다.

연결되면 파일이 보드에 임베드되어 Box의 전체 기능을 사용할 수 있습니다. 임베드 내부에서 문서에 댓글을 달고 주석을 추가하며 검토할 수 있고, 변경 사항은 실시간으로 반영되어 팀이 보드를 떠나지 않고 협업할 수 있습니다.

팁: 임베드를 집중 모드로 열면 문서를 더 넓고 방해 요소 없는 화면에서 보고 상호작용할 수 있습니다.

자주 묻는 질문

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

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

• 사용자가 Miro Box 통합을 승인했습니다.
• 사용자가 임베드하려는 Box 콘텐츠에 접근 권한이 있습니다.

임베드된 Box 콘텐츠를 볼 수 있는 사용자는 누구인가요?

Miro 보드에 접근할 수 있고 임베드된 콘텐츠의 소유자로부터 권한을 받은 사용자—즉, 보드에서 보기, 댓글 또는 편집 권한이 있는 모든 사용자. 뷰어는 보드에서 임베드된 콘텐츠를 보려면 통합을 승인하거나 Box 라이선스를 보유할 필요가 없습니다.

다른 보드에 링크를 붙여넣을 때 다시 권한을 부여해야 하나요?

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

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

Box에서 직접 열 수 없는 콘텐츠를 Miro에서 볼 수 있나요?

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

Miro 데이터 처리 부록은 어디에서 확인할 수 있나요?

다음 문서를 참조하세요 Miro 데이터 처리 부록.

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

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

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