Azure Cards により、ユーザーは Azure Boards の作業項目を Miro のボードにインポートして同期できます。このガイドでは、インテグレーションの技術的実装、セキュリティーモデル、データ処理、およびインテグレーションの評価や設定を行う管理者向けの Microsoft の同意フローについて説明します。機能の詳細な解説とエンドユーザー向けのセットアップ手順については、Azure Cards を参照してください。
要件と制限
- カードのカスタマイズ(カードに表示する属性の選択)はサポートされていません。
- クリップボードからタスクの URL を貼り付けてカードをインポートすることはサポートされていません。
技術的実装
Miro は Azure DevOps REST API を介して Azure Boards と連携し、Azure DevOps のサービス フックを購読して、ワークアイテムの更新をリアルタイムで受信します。
データフロー
データは Azure DevOps と Miro の間で双方向にやり取りされます。
Azure DevOps → Miro:
- Azure DevOps の作業項目ピッカーに表示される作業項目の一覧。この一覧には、リクエストを行ったユーザーが Azure DevOps でアクセスできる作業項目のみが含まれ、ID、種類、タイトル、担当者、状態が表示されます。
- Azure カードに表示される作業項目の詳細: ID、タイトル、プロジェクト、種類、状態、説明、親作業項目、担当者、優先度、エリア、イテレーション、ストーリーポイント、および Azure Boards の作業項目 URL。これは Azure Boards の該当項目が更新されるたびに送信されます。Azure DevOps はこれらに加えて他の作業項目フィールドも送信しますが、Miro はこの一覧に含まれないフィールドは破棄します。
Miro → Azure DevOps:
- Azure カードを作成する際に使用するワークアイテム情報: タイトル、プロジェクト、種類、状態、説明、親ワークアイテム、担当者、優先度、エリア、イテレーション、ストーリーポイント。
- カード作成時に、ピッカーの結果や担当者、エリア、イテレーション、親ワークアイテムの絞り込みに使用される検索文字列。
転送中のデータ
Azure DevOps と Miro 間で交換されるデータは TLS を使用して暗号化されます。
データの保持
Miro は、カードがボード上にある限り、ボードに追加されたワークアイテムのデータを保持し、サービスフックが構成されている場合は更新を維持します。 このデータに対する固定の保持期限はありません; 標準的な Miro アカウントのセキュリティー プロトコルが適用されます。
認証と認可
ユーザーは OAuth 2.0 の認可コードグラントを使用して Azure アカウントを認証し、認可コードをアクセストークンと交換します。Azure DevOps の OAuth の仕組みの詳細については Microsoft の OAuth ドキュメント を参照してください。
Azure Cards を承認した各 Miro ユーザーはそれぞれ個別のアクセストークンを取得します — アクセスはユーザー間で共有されません。
必要な認可スコープ
-
vso.identity— ID とグループを読み取ります。 -
vso.graph— ユーザー、グループ、スコープ、およびグループのメンバーシップ情報を読み取ります。 -
vso.memberentitlementmanagement— ユーザー、そのライセンス、ユーザーがアクセスできるプロジェクトおよび拡張機能を読み取ります。 -
vso.project— プロジェクトとチームを読み取ります。 -
vso.work_full— 作業項目、クエリ、バックログ、プラン、および作業項目トラッキングのメタデータに対するフルアクセス; またサービス フックを通じて作業項目イベント通知を受け取るためにも必要です。This scope grants broader access than Miro uses — Azure DevOps doesn't offer a narrower scope limited to work items only, and Miro only reads and writes work item data.
詳細は Microsoft のスコープ参照 を参照してください。
Miro に保存されるものとその方法
インテグレーションの稼働中に使用されるのはアクセストークンのみで、Miro はアクセストークンを除いてリクエストトークンやその他の OAuth シークレットを保持しません。アクセストークンは Miro のデータベース内に安全に保管され、サーバー側でのみ使用されます。
サービス フックのセキュリティー
Miro はインテグレーションを設定した各チームごとに、秘密キーを含む固有のサービス フック URL を生成します。各 Azure DevOps インスタンスは、それぞれ固有のサービス フック URL を呼び出して、作業項目の変更を Miro に通知します。
リクエストは暗号化された接続で送信されるため、URL自体が転送中に露出することはありません。サービスフック URL が不正な第三者に渡る主な原因は、Azure DevOps の管理者がキーを組織外に共有することであり、意図的な場合も誤っての場合も同様です。
接続または再接続時の同意シナリオ
Azure DevOps インスタンスを接続または再接続する(例:Miro が登録済みの Azure Cards アプリを更新した後など)と、管理者は Microsoft の同意フローを通過します。管理者に表示される内容は、Microsoft Entra テナントの同意設定によって異なります(詳細は Microsoft の管理者およびユーザーの同意に関する概要 を参照してください):
- Entra 管理者の承認が必要で、インテグレーションを接続する管理者が必要な権限を持っている場合:Microsoft の同意画面で、組織を代表して同意するにチェックできます。これにより、Entra テナントの全ユーザーに対してアプリが一括で承認されます。
- ユーザーによる同意が許可されている場合:インテグレーションを接続する管理者は、自分自身に対してのみ同意します。他の各ユーザーは、インテグレーションを初めて使用する際にそれぞれ個別に同意します。
- インテグレーションの接続を行った管理者に承認権限がない場合:画面に管理者の承認が必要と表示され、Microsoft Entra の管理者に同意を付与してもらう必要があります — テナントで許可されていれば同意画面からリクエストを送信するか、Entra 管理者に直接連絡してください。
Enterprise または組織レベルでの再接続
Miro の会社の管理者権限と、Azure Boards の Project Collection Admin グループの権限の両方が必要です。
- Miro で、会社の設定 > アプリとインテグレーション > アプリ > アプリを管理 > Azure Cards > 設定 に移動します。
- 既存の Azure DevOps インスタンスの横にある 切断 を選択します。
- Azure DevOps インスタンスを再接続するには、接続 を選択します。Microsoft にリダイレクトされ、ログインするための画面が表示されます。
- ログイン後、Miro Azure Cards アプリの同意画面が表示されます。以降の処理は Entra の権限とテナントの同意設定によって異なります — 上記のシナリオを参照してください。
Enterprise のチームレベル、または Business プランでの再接続
Miro でチームの管理者権限と、Azure Boards で Project Collection Admin グループの権限の両方が必要です。
- Miro で チームの設定 > アプリ > Azure カード に移動します。
- Azure インスタンスの横にある 切断 を選択します。
- Microsoft アカウントの横にある 切断 を選択します。
- Microsoft アカウントを再接続するには、接続 を選択します。サインインするために Microsoft にリダイレクトされます。
- サインイン後、Miro Azure Cards アプリの同意画面が表示されます。以降の処理はお使いの Entra の権限とテナントの同意設定によって異なります。上のシナリオを参照してください。
- Miro に戻り、Azure インスタンスの横にある接続を選択して再接続します。
- Azure Cards インテグレーションを使用している各チームについて、これらの手順を繰り返します。