対象: 会社の管理者、チームの管理者
プラットフォーム: ブラウザー、デスクトップ
Box インテグレーションにより、ユーザーは Miro のボードに Box のファイルを埋め込むことができます。このガイドでは、管理者がインテグレーションを評価または設定する際の、インテグレーションの技術的実装、セキュリティーモデル、およびデータ処理について説明します。
主な機能
- ライブ埋め込み: ユーザーは Box のコンテンツをライブ iframe として Miro のボードに埋め込むことができます。
- 安全: すべてのボードのビジターは、埋め込まれたコンテンツを閲覧する前に iframe 内でログインを求められます。
- 表示オプション: ユーザーは埋め込みコンテンツをライブ埋め込みまたはブックマークとして表示するかを選択できます。
- フォーカスモード: ユーザーはライブ埋め込みまたはブックマークをフォーカスモードで拡大し、余分な要素を排して閲覧できます。
- アクションショートカット: ユーザーは Box のリンクを埋め込むダイアログを開くアクションショートカットを追加できます。
制限
- このインテグレーションではアセットピッカーは利用できません。
技術的な実装
Miro は Box の REST API を介して Box とインテグレーションします。ユーザーは OAuth 2.0 でアクセスを認可し、その後 Box のファイルを Miro のボードにリンクします。
データフロー
- この機能が有効になっているチームまたは組織に所属するユーザーが、Box のリンクを Miro のボードに貼り付けます。
- Miro がリンクを読み取ります。ユーザーがまだインテグレーションを認可していない場合、Miro は OAuth フローを開始し、ユーザーを Box の認可ページにリダイレクトします。
- ユーザーが認可を付与すると、Miro のインテグレーションサービスはユーザーのアクセストークンを使用して Box の REST API を呼び出し、コンテンツを取得します。
Miro が保存する Box のデータ
Miro は、貼り付けられた Box リンクから以下のデータを取得して保存します：
- ドキュメントとファイルのタイトル
データの強制保持
埋め込みデータは、すべての顧客データに適用される Miro の標準的な強制保持ポリシーに従います。
認証および認可
ボードに Box のリンクを埋め込むには、ユーザーが Box の OAuth 同意画面でインテグレーションを認可する必要があります。顧客の Box の設定によっては、Box 管理者がインテグレーションを承認する必要がある場合があります。
必要な認可スコープ
Box インテグレーションでは、次のスコープが必要です：
-
root_readonly— Box に保存されたすべてのファイルとフォルダーを読み取ります。
Miro に保存されるデータとその取り扱い
このインテグレーションでは、Miro は 2 種類のデータを保存します: 認可データと展開データ。
- 認可データ：Miro はアクセストークンとリフレッシュトークンをデータベースに数日間保存します。認可が有効な間、Miro はユーザーの再認可を要求することなく、リフレッシュトークンを使って期限切れのアクセストークンを自動的に更新します。このインテグレーションのために保存されるすべてのデータは、保管時に 256 ビット AES で暗号化されます。
- 展開データ：Miro はアセットのタイトルをボードの一部として保存し、タイトルと画像参照を社内のサービスに暗号化して保存します。
トークンの取り消し
ユーザーはいつでも Box のアカウント設定から Box インテグレーションの接続を切断できます。
Box インテグレーションの設定
注意： Miro のチームの管理者のみがアプリをインストールできます。Miro 組織で承認済みアプリのみが許可されている場合、一般ユーザーが Box のリンクを貼り付けると、そのユーザーにはアプリのインストールリクエストのダイアログが表示されます。
インテグレーションをインストールして使用を開始するには:
- Box ファイルの URL をコピーします。
- URL を Miro のボードに貼り付けます。
-
次に何が起きるかは、リンクを貼った人物によって異なります:
- チームの管理者がリンクを貼った場合: アプリは自動的に承認およびインストールされ、リンクは追加の操作なしに展開されます.
- 一般のユーザーがリンクを貼り、組織が承認済みアプリのみを許可している場合: アプリのインストールリクエストダイアログが開きます。ユーザーが権限をリクエストすると、会社の管理者はアプリ リクエスト フローの記事に従ってリクエストを承認できます。
Box アカウントに接続する
インテグレーションをインストールして認可した後：
- ボードに URL を貼り付けて作成されたウィジェットで接続をクリックします。Miro に Box アカウントへのアクセス許可を付与するよう求めるページにリダイレクトされます。
- Box アカウントの認証情報を入力し、許可をクリックします。
- Box へのアクセスを許可をクリックして、Miro が Box のファイルにアクセスできるようにします。
接続されると、ファイルは Box のフル機能を備えた形でボードに埋め込まれます。埋め込み内で直接コメントや注釈を追加し、ドキュメントをレビューできます。変更はリアルタイムで反映されるため、チームはボードを離れずに共同作業できます。
ヒント：埋め込みをフォーカスモードで開くと、より大きく気が散らない表示でドキュメントを閲覧・操作できます。
よくある質問
どのユーザーが Box のコンテンツを Miro に埋め込めますか？
ユーザーと Miro のボードの両方が、次の条件を満たしている必要があります。
- ユーザーが Miro の Box インテグレーションを許可していること。
- ユーザーが埋め込もうとしている Box のコンテンツにアクセス権を持っていること。
どのユーザーが埋め込まれた Box のコンテンツを閲覧できますか？
Miro ボードへのアクセス権と、埋め込みコンテンツの所有者からの許可を持つユーザー、つまりボードの閲覧、コメント、編集権限を持つユーザーが対象です。閲覧者はインテグレーションの認可や Box ライセンスを保有していなくても、ボード上の埋め込みコンテンツを閲覧できます。
他のボードにリンクを貼る際、再認証は必要ですか？
いいえ。有効な認可が残っている限り不要です（Miro は認可が付与されてから約 1 か月間を有効期間と見なします）。ユーザーはどのボードにも Box リンクを貼り付けることができ、コンテンツは通常どおり取り込まれます。
そのボードが、このインテグレーションが有効になっていない別のチームまたは組織に属している場合、ユーザーはそちらでは利用できません。
Box で直接アクセスできないコンテンツを、Miro 経由でアクセスできますか？
いいえ。既にアクセス権のある Box のコンテンツのみを埋め込めます。インテグレーションを使って、Box で開けないものを表示することはできません。ただし、アクセス権を持つ人がそのコンテンツをあなたと共有しているボード上に静的な画像として既に埋め込んでいる場合、元のファイルに直接アクセスできなくてもそのスナップショットを表示できます。インテグレーションはこれ以外のアクセス制御を課しません。共同作業できるユーザーの制限は Miro ボードの共有設定で行ってください。なお、静的な画像のスナップショットからは、元データの参照や元ファイルの開封、フィルターの変更はできません。
Miro データ処理付属書はどこで入手できますか？
Miro データ処理付属書をご覧ください。
公開 Miro ボードで禁止されていることは何ですか？
セキュリティー上の理由により、公開ボードでは以下が無効化されます:
- アセット抽出 — Looker、Google スライド、Figma、Power BI、Microsoft Word、Microsoft Excel、Microsoft PowerPoint のインテグレーションでサポートされています。
- アセットの直接展開 (ライブ埋め込みではなくアセットとして表示) — Figma のインテグレーションでサポートされています。