対象:会社の管理者
Looker インテグレーションにより、ユーザーは Looker のダッシュボードや Explore を Miro のボードに埋め込めます。このガイドは、管理者がインテグレーションを評価または設定する際のセットアップ、インテグレーションの技術的実装、セキュリティーモデル、およびデータ処理について説明します。
主な機能
- ライブ埋め込み:ユーザーは Looker のダッシュボードや Explore を Miro のボードにライブ iframe として埋め込めます。
- 安全:埋め込まれたコンテンツを閲覧する前に、すべてのボードのビジターは iframe 内でログインするよう求められます。
- 表示オプション: ユーザーは埋め込みコンテンツをライブ埋め込みとして表示するか、ブックマークとして表示するかを選べます。
- フォーカスモード: ユーザーはライブ埋め込みやブックマークをフォーカスモードで開き、他の要素に邪魔されずに表示できます。
- アクション ショートカット: ユーザーは Looker のリンクを埋め込むダイアログを開くアクション ショートカットを追加できます。
- アセットピッカー: ユーザーは特定のチャートやタイルを静的な画像としてボードに追加できるため、共同作業者は元ファイルへのアクセス権がなくてもその内容を確認・参照できます。
- 管理者コントロール: 管理者はアセットピッカーで Looker コンテンツを静的画像として追加することを禁止できます。
制限
- Looker Studio はサポートされていません。
- Looker Looks はサポートされていません。
- Looker のマージクエリや Looker ボードのリンクの埋め込みはサポートされていません。
- アセット ピッカーで追加した画像は更新できません。
既知の問題
ブラウザーまたは Miro デスクトップアプリで既に認証済みのユーザーが、別のブラウザーや Miro アプリに切り替えると、認証に問題が発生することがあります。これにより認証フローが中断され、Looker へのアクセスが妨げられる可能性があります。
Looker インテグレーションを設定する
前提条件
- あなたの Miro 組織で Company 管理者 が Looker を承認しました。
- Miro を Looker の OAuth アプリとして登録するには、Looker の管理者権限が必要です。
Looker で OAuth アプリを登録する
- Looker のマーケットプレイスで API Explorer extension を見つけて選択し、Install を選択します。
- Home > Applications > API Explorer に移動します。
- API Explorer の検索ボックスに
oauthと入力し、Auth の下にある Register OAuth App を選択します。 - ページ右上の実行を選択します。
-
リクエストフォームに、次の値を入力します。
-
client_guid:
15609152-a12a-4fa1-b364-337e7896d25d -
本文:
{ "redirect_uri": "https://integrations.miro.com/api/contenthub/public/oauth/callback", "display_name": "Miro", "description": "Miro Looker Integration", "enabled": true, "group_id": "" } - フィールドは空のままにします。
より高度なオプション — 例えば
group_idを使って特定の Looker グループへの認可を制限する場合は、OAuth アプリを登録するための Looker のドキュメント(外部)を参照してください。 -
client_guid:
- 「この API エンドポイントはデータを変更することを理解しました」を選択します。
- 「実行」を選択します。実行に成功すると、リクエストボディと HTTP 200 レスポンスが返されます。
返されたボディに"enabled": falseが含まれている場合は、同じ値で OAuth アプリを更新 を実行してクライアントを有効にしてください。
Miro に インテグレーションをインストールして認証する
注意:アプリをインストールできるのは Miro のチームの管理者のみです。組織で承認済みアプリのみを許可している場合、一般ユーザーが Looker のリンクを貼り付けると、そのユーザーにはアプリのインストールリクエストダイアログが表示されます。
- Looker のダッシュボードまたは Explore の URL をコピーします。
- URL を Miro のボードに貼り付けます。
- 次に起こることは、リンクを貼り付けた人によって異なります。
- Miro のチームの管理者がリンクを貼り付けた場合:アプリは自動的に承認されてインストールされ、リンクは追加の操作なしに展開されます。
-
一般ユーザーがリンクを貼り付け、組織が承認済みアプリのみを許可している場合:アプリのインストール要求ダイアログが表示されます。ユーザーが許可をリクエストした後、会社の管理者はアプリリクエスト フローの記事に従ってリクエストを承認できます。
Looker アカウントを接続する
インテグレーションがインストールされ、承認された後:
- ボードに URL を貼り付けると作成されるウィジェットで、接続 をクリックします。Miro が Looker アカウントにアクセスすることを許可するかどうかを尋ねるページにリダイレクトされます。
- Looker 側で承認を確認します。Looker のコンテンツが iframe としてボードに追加されます。
技術的な実装
Miro は Looker の REST API を通じて連携します。ユーザーは OAuth 2.0 でアクセスを許可し、その後 Looker のダッシュボードや Explore を Miro ボードにリンクします。
セキュリティーに関する注意点
インテグレーションのアセットピッカーにより、ユーザーは Looker のチャートやタイルをキャンバスに静的な画像として添付できます。ライブ埋め込みには認可されたユーザーのみがアクセスできる一方、ボードへのアクセス権を持つ人であれば誰でも添付された静的な画像を閲覧できます。公開ボードでは、埋め込みからアセットを追加する機能はデフォルトで無効化されています。
会社の管理者は、すべてのボードでアセットピッカーを無効化できます:
- 次の順に移動します: 会社設定 > アプリとインテグレーション > アプリ > Looker の展開(アプリの管理タブ内)。
- 埋め込みのアセットをユーザーがキャンバスに追加するのを防ぐ を切り替えます。
データフロー
- この機能が有効になっているチームまたは組織に所属するユーザーが、Looker のリンクを Miro のボードに貼り付けます。
- Miro はリンクを読み取ります。ユーザーがまだインテグレーションを承認していない場合、Miro は OAuth フローを開始し、ユーザーを Looker の認可ページにリダイレクトします。
- ユーザーが承認を付与すると、Miro のインテグレーションサービスはユーザーのアクセストークンを使用して Looker の REST API を呼び出し、コンテンツを取得します。
Miro が保存する Looker のデータ
Miro は、貼り付けられた Looker リンクから以下のデータを取得し、保存します:
- ダッシュボードとExploreのタイトル
- アセットピッカーで作成された画像
データ保持
埋め込みデータは、すべての顧客データに対する Miro の標準データ保持ポリシーに従います。
認証と認可
ボードに Looker のリンクを埋め込むには、ユーザーが Looker の OAuth API を通じてインテグレーションを認可する必要があります。また、Looker の管理者が Miro を OAuth アプリとして登録する必要もあります。上の Looker で OAuth アプリを登録する を参照してください。
必要な認可スコープ
Looker インテグレーションでは、以下のスコープが必要です。
apiMiro に保存される内容と保存方法
Miro はこのインテグレーションに関して、2 種類のデータを保存します: 認可データとアンファーリングデータ。
認可データ: Miro はアクセストークンとリフレッシュトークンを数日間データベースに保存します。認可が有効な間、Miro はユーザーに再承認を求めることなく、リフレッシュトークンを使って期限切れのアクセストークンを自動的に更新します。すべてのデータは保存時に 256 ビット AES で暗号化されます。
アンファーリングデータ: Miro はアンファーリングデータを 2 種類保存します: アセットピッカーで取得された画像(ボードの一部として保存されます)と、タイトルおよび画像の参照(暗号化された状態で内部サービスに保存されます)。
トークンの取り消し
Looker 管理者は Looker の管理者コンソールからインテグレーションへのアクセスを取り消すことができます:
- Admin > Users に移動します。
- ユーザーを選択します。
- API Keys までスクロールし、トークンの横にある Delete を選択します。
よくある質問
インテグレーションを無効にするにはどうすればよいですか?
Looker から Miro OAuth アプリを削除します。これは既に Miro のボードに埋め込まれている Looker データを削除するものではありませんが、ユーザーが新しいコンテンツを埋め込んだり既存のアセットを更新したりすることを防ぎます。
どのユーザーが Looker のコンテンツを Miro に埋め込めますか?
ユーザーと Miro のボードは、次の両方の条件を満たしている必要があります:
- ユーザーが Miro の Looker インテグレーションを承認しています。
- ユーザーが埋め込もうとしている Looker コンテンツにアクセス権を持っています。
埋め込まれた Looker コンテンツを閲覧できるユーザーは誰ですか?
埋め込まれたコンテンツの所有者からの許可があり、かつ Miro ボードにアクセスできる人は誰でも閲覧できます。つまり、ボードに対して閲覧、コメント、編集のいずれかの権限を持つ人です。閲覧者はインテグレーションを承認したり、Looker ライセンスを保有したりする必要はありません。
他のボードにリンクを貼る際に、再承認は必要ですか?
いいえ。承認が有効である限り不要です(Miro では承認が付与されてから 1 か月間を有効として扱います)。ユーザーはどのボードにも Looker リンクを貼り付けることができ、コンテンツは通常どおり読み込まれます。
ボードがこのインテグレーションを有効にしていない別のチームや組織に所属している場合、ユーザーはそのチームや組織では利用できません。
Miro 経由で、Looker で直接アクセスできないコンテンツにアクセスできますか?
いいえ。既にアクセス権を持っている Looker コンテンツのみ埋め込めます。Looker で開けないコンテンツをこのインテグレーションで閲覧することはできません。ただし、アクセス権を持つ誰かがそのコンテンツを静的画像としてあなたと共有しているボードに既に埋め込んでいる場合は、元のファイルに直接アクセスできなくてもそのスナップショットを閲覧できます。インテグレーション側でこれ以外のアクセス制御は行いません。共同作業できる相手は Miro ボードの共有設定で制限してください。静的画像のスナップショットは、元データの探索や元のチャートを開くこと、フィルターの変更には使用できない点に注意してください。
Miro Data Processing Addendum はどこで参照できますか?
Miro Data Processing Addendum をご覧ください。
Miro の公開ボードで禁止されていることは何ですか?
セキュリティー上の理由から、公開ボードでは次の機能が無効化されます:
- アセットの抽出 — Looker、Google スライド、Figma、Power BI、Microsoft Word、Microsoft Excel、Microsoft PowerPoint のインテグレーションでサポートされています。
- アセットの直接展開(ライブ埋め込みではなくアセットとして表示する機能) — Figma のインテグレーションでサポートされています。
ボードへのアクセスを、ソース ファイルにアクセス権のある人と同じ人に制限するにはどうすればよいですか?
このインテグレーションは、 Miro ではなく、ソースシステム(Looker)側のファイルアクセスのみを管理します。デフォルトでは、この制約は強制されていません — このレベルのセキュリティーを維持するには、 Miro の組織管理者がアプリの管理設定でアセットピッカーを無効化する必要があります(セキュリティーに関する考慮事項)。
アセットピッカーを無効化すると、Looker のコンテンツが Miro ボード上に静的画像として保存されるのを防げます。静的画像は、ボードが公開共有されている場合や、ソースへのアクセス権を持たない人と共有された場合など、Looker でのアクセス権がない人にも見られる可能性があります。