Figma（管理者向けドキュメント） – Miro Help Center

対象: 会社の管理者、チームの管理者
プラットフォーム: ブラウザー、デスクトップ

Miro のボードに Figma のファイル、フレーム、およびセクションを埋め込むことができます。本ガイドでは、インテグレーションの技術的な実装、セキュリティーモデル、およびインテグレーションを評価または設定する管理者向けのデータの取り扱いについて説明します。

主な機能

ライブ埋め込み: ユーザーは Figma のコンテンツを Miro のボードにライブの iframe として埋め込むことができます。
安全性: すべてのボードのビジターは、埋め込まれたコンテンツを閲覧する前に iframe にログインするよう求められます。
表示オプション: ユーザーは埋め込まれたコンテンツをライブ埋め込みとして表示するか、ブックマークとして表示するかを選択できます。
フォーカスモード: ユーザーはライブ埋め込みやブックマークをフォーカスモードで展開して、余計な表示を排して閲覧できます。
アクションショートカット: ユーザーは Figma のリンクを埋め込むダイアログを開くアクションショートカットを追加できます。
アセットピッカー: ユーザーは特定のフレームやセクションを静的画像としてボードに追加できるため、共同作業者はソースファイルへのアクセス権がなくてもその内容を表示して参照できます。
管理者向けコントロール: 管理者は、ユーザーがアセットピッカーで Figma のコンテンツを静的画像として追加することを無効にできます。

制限

アセットピッカーはスライドでは利用できません。
ライブ埋め込みでは編集はサポートされていません。

技術的な実装

Miro は Figma REST API を介して Figma と統合されます。ユーザーは OAuth 2.0 でアクセスを認可し、その後 Figma のファイルを Miro のボードにリンクします。

セキュリティーに関する考慮事項

インテグレーションのアセットピッカーにより、ユーザーは Figma ファイルの一部を静的画像としてキャンバスに添付できます。認可されたユーザーのみがライブ埋め込みにアクセスできますが、ボードにアクセスできる人なら誰でも添付された静的画像を閲覧できます。公開ボードでは、埋め込みからのアセットの追加はデフォルトで無効化されています.

会社の管理者はすべてのボードでアセットピッカーを無効化できます:

次の順に移動します: 会社設定 > アプリとインテグレーション > アプリ > Figma (アプリの管理 タブ内).
埋め込みからのアセットのキャンバスへの追加を禁止する を切り替えます.

データフロー

この機能が有効なチームまたは組織に属するユーザーが、Figma のリンクを Miro ボードに貼り付けます。
Miro がリンクを読み取ります。ユーザーがまだインテグレーションを許可していない場合、Miro は OAuth フローを開始してユーザーを Figma の認可ページにリダイレクトします。
ユーザーが認可を付与すると、Miro のインテグレーションサービスがユーザーのアクセストークンを使って Figma の REST API を呼び出し、コンテンツを取得します。
コンテンツがボードに表示されると、同じボードにアクセスできる全員が閲覧できます。再認証は、リフレッシュトークンの有効期間である 90 日間不要です。

Miro が保存する Figma のデータ

Miro は、貼り付けられた Figma リンクから以下のデータを取得して保存します。

フレームやセクションのビジュアル画像
ボード、デザイン、スライド、スライド資料、プロトタイプのタイトル
Figma のボードおよびデザインのページ名

データの保持

埋め込まれたデータは、すべての顧客データに適用される Miro の標準的なデータ保持ポリシーに従います。

認証と認可

ボードに Figma リンクを埋め込むには、ユーザーが Figma の OAuth 同意画面でインテグレーションを承認する必要があります。お客様の Figma 設定によっては、Figma の管理者による承認が必要になる場合があります。

必要な認可スコープ

Figma インテグレーションでは、次のスコープが必要です。

files:read — ファイル、プロジェクト、ユーザー、バージョン、コメント、コンポーネントおよびスタイル、Webhook を読み取ります。

Miro に保存される内容とその扱い

Miro はこのインテグレーションのために、認可データとアンファーリングデータの 2 種類のデータを保存します。

認証情報： Miro はアクセストークンとリフレッシュトークンを数日間データベースに保存します。認証が有効な間、Miro は（デフォルトで90日有効な）リフレッシュトークンを使って期限切れのアクセストークンを自動的に更新し、ユーザーの再認証を必要としません。このインテグレーションのために保存されるすべてのデータは、保存時に256ビット AESで暗号化されます。
展開データ： Miro は展開データを2種類保存します。1つはアセットピッカーで取得された画像（ボードの一部として保存）、もう1つはタイトルと画像参照（暗号化された状態で内部サービスに保存）です。

トークンの取り消し

ユーザーは Figma のアカウントからいつでもこのインテグレーションのアクセスを取り消すことができます：

From the ファイルブラウザー、画面左上のアカウントメニューをクリックし、設定を選択します。
下にスクロールして、個人用アクセストークンセクションまで移動します。
個人用アクセストークンの一覧から、取り消したいトークンを選択します。
アクセスを取り消すをクリックします。

インテグレーションはこれ以降 API を通じてデータにアクセスできなくなります。後で再度インテグレーションを利用するには、新しい個人用アクセストークンを生成し、インテグレーションを再設定してください。

Figma インテグレーションを設定する

注： Miro のチームの管理者のみがアプリをインストールできます。Miro 組織が承認済みアプリのみを許可している場合、一般ユーザーが Figma のリンクを貼り付けると、そのユーザーには代わりにアプリのインストールをリクエストするダイアログが表示されます。

インテグレーションをインストールして使用を開始するには：

Figma ファイルの URL をコピーします。
URL を Miro のボードに貼り付けます。
次に何が起こるかは、リンクを貼り付けたユーザーによって異なります:
- チームの管理者がリンクを貼り付けた場合: アプリは自動的に認可されてインストールされ、リンクは追加の操作なしで展開されます。
- 一般ユーザーがリンクを貼り付け、組織が承認済みアプリのみを許可している場合: アプリのインストールリクエストダイアログが表示されます。ユーザーが権限をリクエストした後、会社の管理者はアプリリクエストフローの記事に従ってリクエストを承認できます。

Figma アカウントを接続する

インテグレーションがインストールされ、承認された後：

ボードに URL を貼り付けると作成されるウィジェットの接続をクリックします。Miro が Figma アカウントへのアクセスを許可するよう求めるページにリダイレクトされます。
必要に応じてアカウントの認証情報を入力し、アクセスを許可 をクリックします。Figma のコンテンツが iframe としてボードに追加されます。

よくある質問

インテグレーションを無効にするにはどうすればよいですか？

Figma 開発者アプリにアクセスします。
アプリケーションを選択します。
Embed API タブで、Allowed embed origins の URL を削除します。

どのユーザーが Figma のコンテンツを Miro に埋め込めますか？

ユーザーと Miro のボードは、次の両方の条件を満たしている必要があります。

ユーザーが Miro の Figma インテグレーションを認可していること。
ユーザーが埋め込もうとしている Figma コンテンツにアクセス権があること。

埋め込まれた Figma コンテンツを閲覧できるのは誰ですか？

Miro ボードにアクセスでき、かつ埋め込まれたコンテンツの所有者から許可を得ている人、つまりボードに対して閲覧・コメント・編集のいずれかの権限を持つ人であれば、誰でも閲覧できます。閲覧者は埋め込みコンテンツを表示するためにインテグレーションを認可する必要はなく、Figma のライセンスを持っていなくても表示できます。

別のボードにリンクを貼り付ける際、ユーザーは再認可が必要ですか？

いいえ、認可が有効であれば再認可は必要ありません（Miro は認可を付与後 1 か月間有効とみなします）。ユーザーは任意のボードに Figma のリンクを貼り付けられ、コンテンツは通常どおり取り込まれます。

そのボードが、このインテグレーションが有効になっていない別のチームまたは組織に所属している場合、ユーザーはそこでこのインテグレーションを利用できません。

Figma で直接アクセスできないコンテンツに、Miro 経由でアクセスできますか？

いいえ。埋め込めるのは、すでにアクセス権を持っている Figma コンテンツのみです — このインテグレーションを使って、Figma で開けないものを閲覧することはできません。とはいえ、アクセス権を持つ誰かがそのコンテンツを静的画像として、あなたと共有しているボードに既に埋め込んでいる場合は、元のファイルに直接アクセスできなくてもそのスナップショットを閲覧できます。インテグレーションはこの点を超えるアクセス制御を追加で課すものではないため、コラボレーションの範囲を制限するには Miro ボードの共有設定を使用してください。静的画像のスナップショットは、元のデータを調べたり、元ファイルを開いたり、フィルターを変更したりすることはできない点にご注意ください。

Miro のデータ処理付属書はどこで確認できますか？

Miro データ処理付属書をご参照ください。

Miro の公開ボードで禁止されていることは？

セキュリティー上の理由から、公開ボードでは以下が無効化されています:

アセットの抽出 — Looker、Google Slides、Figma、Power BI、Microsoft Word、Microsoft Excel、Microsoft PowerPoint のインテグレーションでサポートされています。
アセットの直接展開 (ライブ埋め込みの代わりにアセットを表示) — Figma インテグレーションでサポートされています。

ボードへのアクセスをソースファイルにアクセスできる人と同じ人に制限するにはどうすればよいですか？

このインテグレーションは、ファイルへのアクセス管理を Miro ではなくソースシステム（Figma）側で行います。既定ではそれが強制されていません — このレベルのセキュリティーを維持するには、Miro 組織の管理者がアプリの管理設定でアセットピッカーを無効化する必要があります（詳細はセキュリティーに関する考慮事項）。

アセットピッカーを無効化すると、Figma のコンテンツが Miro ボード上に静的画像として保存されることを防げます。静的画像は後に Figma 側のアクセス権を持たない人（たとえば、ボードが公開共有されている場合やソースへのアクセス権がない人と共有されている場合）に見られてしまう可能性があります。

このセクションの記事