Microsoft 365 インテグレーションにより、ユーザーは Microsoft Word、Excel、PowerPoint のファイル(職場または学校のアカウントの SharePoint または OneDrive に保存されている)を Miro ボードに埋め込むことができます。 このガイドでは、セットアップ、インテグレーションの技術的な実装、セキュリティーモデル、および管理者がインテグレーションを評価または構成する際のデータ処理について説明します。
主な機能
- ライブ埋め込み: ユーザーは Word、Excel、PowerPoint のファイルをライブ iframe として Miro のボードに埋め込むことができます。
- 安全: 各ボードのビジターは、埋め込まれたコンテンツを閲覧する前に iframe 上でログインするよう求められます。
- 表示オプション: ユーザーは埋め込みコンテンツをライブ埋め込みとして表示するか、ブックマークとして表示するか選択できます。
- フォーカスモード: ユーザーはライブ埋め込みまたはブックマークをフォーカスモードで拡大して、余計な表示を排して閲覧できます。
- アクションショートカット: ユーザーは Microsoft 365 のリンクを埋め込むためのダイアログを開くアクションショートカットを追加できます。
- アセットピッカー: ユーザーは特定のページ、シート、またはスライドを静的画像としてボードに追加できます。これにより、共同作業者は元ファイルへのアクセスがなくても該当の内容を閲覧して参照できます。
- Admin controls: 管理者は、ユーザーがアセットピッカーを使って Microsoft 365 コンテンツを静的画像として追加することを禁止できます。
要件と制限
- Word、Excel、または PowerPoint を含む、SharePoint ベースの Microsoft 365 ビジネス アカウントが必要です。個人用 Microsoft アカウントはサポートされていません。
Microsoft 365 インテグレーションの設定
前提条件
- Company 管理者が、あなたの Miro 組織に対して Microsoft 365 インテグレーションを承認しました。
- Microsoft Entra の管理者アクセス権を持っており、あなたの Microsoft テナントでインテグレーションを承認できます。
Microsoft Entra でインテグレーションを承認する
現在のバージョンの Miro の Microsoft 365 アプリを顧客の Microsoft テナントにインストールするには、管理者の同意が必要です。
- 管理者として Microsoft Entra にログインし、Enterprise applications > Consent and permissions に移動します。
- Users can request admin consent to apps they are unable to consent to に Yes を設定します。
-
Who can review admin consent requests の下で、これらのリクエストをレビューできるユーザー、ロール、またはグループを選択します。
- この設定を行うと、管理者でないユーザーが(インテグレーションが有効なチームの)Miro ボードに Microsoft 365 のリンクを貼り付けることで、承認リクエストを起動できます。
- ステップ 3 で選択した管理者は、エンタープライズ アプリケーション > 管理者同意リクエスト に移動してリクエストを確認・承認できます。承認されると、テナント内の任意のユーザーが各自でインテグレーションを認証できるようになります。
Miro にインテグレーションをインストールして認証する
注: Miro のチームの管理者のみがアプリをインストールできます。Miro 組織で承認済みアプリのみを許可している場合、管理者でないユーザーが Microsoft 365 のリンクを貼り付けると、そのユーザーにはアプリのインストール要求ダイアログが表示されます。
- Word、Excel、PowerPoint ファイルの URL をコピーします。
- URL を Miro のボードに貼り付けます。
- 次に起こることは、リンクを貼った人によって異なります。
- チームの管理者がリンクを貼った場合: アプリは自動的に承認・インストールされ、リンクは追加の操作なしに展開されます。
-
一般のユーザーがリンクを貼り、組織が承認済みアプリのみを許可している場合: アプリのインストール要求ダイアログが表示されます。ユーザーが許可をリクエストした後、会社の管理者はアプリ要求フローの記事に従ってリクエストを承認できます。
Microsoft 365 アカウントを接続する
インテグレーションがインストールされ、承認された後:
- ボードに URL を貼り付けて作成されたウィジェットで、接続をクリックします。Miro に Microsoft 365 アカウントへのアクセス許可を与えるよう求めるページにリダイレクトされます。
- Microsoft 側で承認を完了します。ファイルの内容が iframe としてボードに追加されます。
技術的な実装
Miro は Microsoft Graph REST API を通じて Microsoft 365 と連携します。ユーザーは OAuth 2.0 でアクセスを認可し、その後 Word、Excel、PowerPoint のファイルを Miro のボードにリンクします。
セキュリティーに関する考慮事項
インテグレーションのアセットピッカーを使うと、Microsoft 365 ファイルの一部を静的画像としてキャンバスに添付できます。ライブ埋め込みには許可されたユーザーのみがアクセスできますが、ボードにアクセス権を持つ人であれば添付された静的画像は誰でも閲覧できます。公開ボードでは、埋め込みからアセットを追加する機能はデフォルトで無効化されています。
会社の管理者はすべてのボードでアセットピッカーを無効化できます:
- 次の順に移動します:会社設定 > アプリとインテグレーション > アプリ > Microsoft ドキュメント インテグレーション(アプリの管理タブの下)。
- 埋め込みからアセットをキャンバスに追加することをユーザーに禁止する を切り替えます。
データフロー
- この機能が有効になっているチームまたは組織に属するユーザーが、Microsoft 365 のリンクを Miro のボードに貼り付けます。
- Miro がリンクを読み取ります。ユーザーがまだインテグレーションを認可していない場合、Miro は OAuth フローを開始し、ユーザーを Microsoft の認可ページにリダイレクトします。
- ユーザーが認可を与えた後、Miro のインテグレーションサービスはユーザーのアクセストークンを使って Microsoft Graph REST API を呼び出し、コンテンツを取得します。
Miro が保存する Microsoft 365 のデータ
Miro は、貼り付けられた Microsoft 365 のリンクから、次のデータを取得して保存します。
- ドキュメントおよびファイルのタイトル
- アセットピッカーで作成された画像
データ保持
埋め込みデータは、すべての顧客データに適用される Miro の標準データ保持ポリシーに従います。
認証と認可
ボードに Microsoft 365 のリンクを埋め込むには、ユーザーが Microsoft の OAuth API を通じてインテグレーションを認可する必要があります。 また、Microsoft Entra 管理者によるインテグレーションの承認が必要です — 上の Microsoft Entra でインテグレーションを承認する を参照してください。
必要な認可スコープ
Microsoft 365 インテグレーションには、次のスコープが必要です:
-
offline_access— トークンを更新するために必要です。 -
Files.ReadWrite— アプリがログインしたユーザーのファイルを読み取り、作成、更新、削除できるようにします。 -
Files.ReadWrite.All— アプリがログインしたユーザーがアクセスできるすべてのファイルを読み取り、作成、更新、削除できるようにします。 -
Sites.ReadWrite.All— アプリがログインしたユーザーに代わって、すべてのサイトコレクション内のドキュメントやリスト項目を編集または削除できるようにします。
Miro に保存されるデータと保存方法
Miro はこのインテグレーションのために、認可データとアンファーリングデータの2種類のデータを保存します。
認可データ: Miro はアクセストークンとリフレッシュトークンを数日間データベースに保存します。認可が有効な間、Miro はリフレッシュトークンを使用して期限切れのアクセストークンを自動的に更新し、ユーザーの再認証を必要としません。このインテグレーションのために保存されるすべてのデータは、保存時に 256 ビット AES で暗号化されます。
展開データ: Miro は展開データを 2 種類保存します:アセットピッカーで取得した画像(ボードの一部として保存)と、タイトルおよび画像参照(内部サービスに暗号化して保存)。
トークンの取り消し
Microsoft Entra 管理者はインテグレーションのアクセスを取り消すことができます — 詳しくは アプリケーションのアクセス取り消しに関する Microsoft のガイド(外部)を参照してください。
よくある質問
インテグレーションを無効にするにはどうすればよいですか?
Microsoft Entra の管理者は、アプリを削除することで Miro インテグレーションの権限を取り消すことができます。Enterprise applications > All applications に移動し、Contenthub Microsoft Integration アプリを選択して、Properties > Delete を選択します。
どのユーザーが Microsoft 365 のコンテンツを Miro に埋め込めますか?
ユーザーと Miro のボードは、次の両方の条件を満たしている必要があります。
- ユーザーが Miro の Microsoft 365 インテグレーションを承認していること。
- ユーザーが埋め込もうとしている Microsoft 365 コンテンツにアクセス権を持っていること。
埋め込まれた Microsoft 365 コンテンツを閲覧できるのはどのユーザーですか?
Miro ボードへのアクセス権と埋め込みコンテンツの所有者からの許可がある人、つまりボードに対して閲覧、コメント、または編集の権限を持つすべてのユーザーです。閲覧者は、埋め込みコンテンツをボード上で表示するためにインテグレーションを承認したり、Microsoft 365 のライセンスを保有したりする必要はありません。
ユーザーは他のボードにリンクを貼る際に再承認が必要ですか?
いいえ。有効な承認である限り再承認は不要です(Miro は承認が付与されてから 1 か月間を有効と扱います)。ユーザーは任意のボードに Microsoft 365 のリンクを貼り付けられ、コンテンツは通常どおりインポートされます。
そのボードがインテグレーションを有効にしていない別のチームまたは組織に属する場合、ユーザーはそこでこのインテグレーションを使用できません。
Microsoft で直接アクセスできない Microsoft 365 コンテンツに、Miro 経由でアクセスできますか?
いいえ。既にアクセス権のある Microsoft 365 のコンテンツだけを埋め込むことができます — Microsoft で開けないものをインテグレーションで閲覧することはできません。とはいえ、アクセス権を持つユーザーがそのコンテンツを静的画像としてあなたと共有しているボードにすでに埋め込んでいる場合は、元ファイルに直接アクセスできなくてもそのスナップショットを閲覧できます。インテグレーションはこれ以外の追加のアクセスポリシーを課しません。共同作業できる人を制限するには、Miro ボードの共有設定を利用してください。静的画像のスナップショットからは、元のドキュメントを詳細に確認したり、元ファイルを開いたり、フィルターを変更したりすることはできない点にご注意ください。
Miro Data Processing Addendum はどこで入手できますか?
詳細は Miro Data Processing Addendum をご覧ください。
公開ボードで許可されていないことは何ですか?
セキュリティーの観点から、公開ボードでは次の機能が無効化されています:
- アセット抽出 — Looker、Google スライド、Figma、Power BI、Microsoft Word、Microsoft Excel、Microsoft PowerPoint のインテグレーションでサポートされています。
- アセットの直接展開 (ライブ埋め込みではなくアセットとして表示) — Figma のインテグレーションでサポートされています。
ソース ファイルにアクセスできる人と同じメンバーだけがボードにアクセスできるように制限するにはどうすればよいですか?
インテグレーションはファイルのアクセスをソースシステム(Microsoft 365)側でのみ管理し、Miro 側では管理しません。デフォルトではこれが強制されないため、このレベルのセキュリティーを維持するには、Miro 組織の管理者がアプリの管理設定でアセットピッカーを無効化する必要があります(詳細はセキュリティーに関する考慮事項を参照)。
アセットピッカーを無効にすると、Microsoft 365 のコンテンツが Miro ボード上に静的画像として保存されるのを防げます。そうした画像は、後に Microsoft 365 でのアクセス権を持たないユーザーに閲覧される可能性があります(例:ボードが公開されている場合や、ソースへのアクセス権を持たないユーザーと共有している場合)。