Graph Data Connect と Microsoft Graph アクセス許可の解説:セットアップ、同意、最小特権
By Mirko Peters ·
Microsoft Graph Data Connect の概要、Graph API との違い、セットアップと承認の手順、そして Graph のアクセス許可(委任、アプリケーション、同意)の仕組みを解説します。
Automatically translated with AI from the original post. Read the English original
Microsoft Graph Data Connect と Microsoft Graph のアクセス許可は別のテーマですが、一緒に検索されることの多いトピックです。Data Connect は Microsoft 365 の分析向けに大量のデータを一括抽出するサービスです。Graph のアクセス許可は、アプリが Graph API を通じて何をできるかを制御します。どちらも同意の仕組みに依存しており、どちらにも共通して有効な習慣があります。それは、業務を遂行するために必要な最小限のアクセス権だけを要求することです。
重要なポイント
- Graph Data Connect は、分析のために Microsoft 365 のデータを Azure ストレージへ一括で抽出します。Graph API は、選択したユーザーやグループの少量のデータに適しています。
- セットアップには、機能を有効にするグローバル管理者、Entra のアプリ登録、Azure ストレージアカウント、そしてデータアクセス要求に対する管理者の承認が必要です。
- パイプラインには約 45 分のオーバーヘッドがあり、同意の手順を含めると初回実行は 40 分以上かかることがあります。
- Graph のアクセス許可には 2 種類あります。委任されたアクセス許可は、サインイン済みのユーザーとして動作します。アプリケーションのアクセス許可はユーザーなしで動作し、管理者の同意が必要です。
- Microsoft は、アプリの要件を満たせる場合は委任モデルを、そして機能する中で最小のアクセス許可を使うことを推奨しています。
- アクセス許可の名前は {resource}.{operation}.{constraint} の形式に従います。例えば Application.ReadWrite.OwnedBy のようになります。
Graph Data Connect とは
Microsoft は Data Connect を、エンタープライズ分析のために Microsoft Fabric、Azure Synapse、Azure Data Factory から Microsoft 365 のデータセットへ安全かつスケーラブルにアクセスする仕組みとして説明しています。データは Microsoft Entra ID、Outlook、Teams、SharePoint、Viva Insights、Microsoft グループなどのソースから取得されます。
データセットは 3 つのグループに分類されます。基本データ(顧客が作成した未加工のコンテンツ)、クリーニング済みデータ(正規化または重複排除されたもの)、キュレーション済みデータ(特定のシナリオ向けに作成されたもの)です。データセットの一覧には、例えば TeamsCallRecords_v1、SharePointPermissions_v1、GroupMembers_v0、PlannerTasks_v0 などが含まれます。Viva Insights のデータセットには Viva Insights ライセンスが必要です。これは、データセットのページに記載されているライセンスに関する唯一の注意事項です。
Data Connect か Graph API か
Data Connect のよくある質問では、次のように説明されています。どちらも同じ基盤データに到達できます。Data Connect は組織全体の大量のデータを一括で抽出します。Graph API は、選択したユーザーやグループの少量のデータに適しています。また、よくある質問では両者の併用も提案されており、例えば初回の抽出には Data Connect を、その後のリアルタイムの処理には Graph API を使う方法が示されています。
よくある質問に記載されている既知の制限事項:
- パイプラインには、データサイズに関係なく約 45 分のオーバーヘッドがあります。
- ハイブリッド構成を含め、オンプレミスの Exchange ユーザーはサポートされていません。
- リソースアカウントのメッセージや予定はサポートされていません。
- テナントをまたぐデータセットへのアクセスは利用できません。Azure リソースと Microsoft 365 は、同じ Entra テナント内に存在する必要があります。
セットアップの手順
クイックスタートでは、以下の手順を説明しています。メニュー名は Microsoft の表記のとおりです。
- Data Connect を有効にします。 グローバル管理者として admin.microsoft.com にサインインします。[設定] > [組織の設定] を選択し、[サービス] タブで [Microsoft Graph Data Connect] を選択します。組織全体で有効にするオプションにチェックを入れて保存します。
- Entra アプリケーションを作成します。 Microsoft Entra 管理センターで、アプリの登録 > 新規登録 に移動します。「この組織のディレクトリ内のアカウントのみ」を選択します。アプリケーション (クライアント) ID とテナント ID をコピーし、クライアント シークレットを作成して、その値をすぐに保存します。アプリケーションの所有者にはメールボックスが必要で、クイックスタートによると、有効な E5 サブスクリプションも必要です。
- Azure Storage を作成します。 Microsoft 365 のリージョンに合わせたリージョンでストレージ アカウントを作成します。アクセス制御 (IAM) で、アプリケーションに Storage Blob Data Contributor ロールを付与し、プライベート コンテナーを作成します。
- Azure portal で、Data Connect にアプリケーションを登録します。転送先、アプリケーション、データセットと列を選択します。
- リクエストを承認します。 管理者が 設定 > 組織の設定 > セキュリティとプライバシー > Microsoft Graph Data Connect アプリケーション を開きます。アプリケーションには 事前承諾 と表示されます。データセットを確認し、承認 を選択します。クイックスタートでは、自分自身で承認することはできないと注意されています。
- Synapse、Data Factory、または Fabric でパイプラインを実行します。ステータスは、Initializing、Consent Pending、Extracting Data、Persisting Data、Succeeded の順に変わります。初回実行には 40 分以上かかることがあります。
サポートされているシンクは、Azure Data Lake Storage Gen2、Azure Storage Blob、Azure SQL DB (マッピング データ フローのみ)、Microsoft Fabric OneLake です。サービス プリンシパル認証が、サポートされている唯一の認証方式です。
同意とコスト
同意は抽出範囲、つまりデータセット、列、ユーザー、シンクを対象とします。同じ範囲での実行であれば、新たなリクエストは不要です。課金は Azure サブスクリプションを通じて、パイプラインの実行ごとに行われ、端数の単位は切り上げられます。FAQ の例では、500 行ずつの実行を 20 回行うと、10 単位ではなく 20 単位として課金されます。読んだページには料金は記載されていません。
Graph のアクセス許可の基本
Graph API では、Microsoft は 2 種類のアクセス許可を定義しています。
| | 委任 | アプリケーション | |---|---|---| | 動作 | サインイン済みユーザーの代わりに動作 | ユーザーなしで動作 | | 実効アクセス | アプリのアクセス許可とユーザー自身の権限で制限 | アクセス許可が対象とするすべてのデータ | | 同意できるユーザー | ユーザー、または全ユーザー向けに管理者 | 管理者のみ | | その他の名称 | スコープ | アプリ ロール |
アプリケーション アクセス許可に対する同意には、特権ロール管理者またはグローバル管理者のロールが必要です。委任されたアクセス許可のユーザー同意は、テナントのアプリ同意ポリシーによって引き続き制限される場合があります。
命名規則と最小権限の原則
アクセス許可は {resource}.{operation}.{constraint} の形式に従います。ページの例では、Read や ReadWrite などの操作と、All や OwnedBy などの制約が使われています。制約が指定されていない場合、アクセスはサインイン済みユーザーが所有するデータに限定されます。たとえば、Application.ReadWrite.OwnedBy はアプリが作成または所有するアプリケーションのみを管理しますが、Application.ReadWrite.All はそれらすべてを管理します。
Microsoft のガイダンスでは、必要最小限のアクセス許可を付与することが推奨されています。Directory.AccessAsUser.All、Directory.ReadWrite.All、Directory.Read.All は慎重に使用し、より弱いアクセス許可を優先してください。リソース固有の同意では、テナント全体ではなく、チームなど 1 つのリソース インスタンスへのアクセスをユーザーが許可できます。この方式をサポートしているのは一部の機能のみです。
よくある問題
- コネクタ エージェントの登録に失敗します。 Learn によると、コネクタ エージェントの登録では委任されたアクセス許可はサポートされていません。最小権限のアプリケーション アクセス許可を要求し、テナント全体の管理者同意を付与してください。
- メンバーに id と @odata.type しか表示されません。 そのメンバーの種類を読み取るためのアクセス許可がアプリにありません。
- 1 つのアプリに対するアクセス許可が多すぎます。 サインイン対象に個人の Microsoft アカウントを含むアプリは、最大 30 件のアクセス許可を要求できます。組織向けの対象では最大 400 件まで要求できます。
ドキュメントに記載されていない事項
参照した Data Connect のページには、承認の有効期間や料金単価は記載されていません。また、クイックスタートのチュートリアル環境以外のライセンス要件も記載されていません。
関連情報
データソース
- Microsoft Graph Data Connect の概要
- Data Connect のクイック スタート
- Data Connect よくある質問
- データセット、リージョン、シンク
- Microsoft Graph のアクセス許可の概要
FAQ
Graph Data Connect と Microsoft Graph API の違いは何ですか?
Microsoft Learn の Data Connect のよくある質問では、どちらも同じ基盤データに異なる方法でアクセスする仕組みだと説明されています。Data Connect は組織全体の大量のデータを一括で抽出するように設計されています。一方、Graph API は選択したユーザーやグループの少量のデータに適しています。
Graph Data Connect アプリケーションを承認するのは誰ですか?
Microsoft のクイックスタートでは、管理者が Microsoft 365 管理センターの [設定] > [組織の設定] > [セキュリティとプライバシー] > [Microsoft Graph Data Connect アプリケーション] で要求を承認します。また、クイックスタートには、自分が作成したアプリを自分で承認することはできないと記載されています。
パイプラインの実行ごとに新しい同意の要求が必要ですか?
いいえ。Data Connect のよくある質問によると、データセット、列、ユーザー、シンクのスコープが同じであれば、実行ごとに新しい同意の要求は必要ありません。日付を変えて同じスコープで実行する場合も対象に含まれます。
アプリは委任されたアクセス許可とアプリケーションのアクセス許可のどちらを使うべきですか?
Microsoft Learn によると、アプリケーションのアクセス許可は強い権限を持つため、最小特権の観点からは、アプリの要件を満たせる場合は委任モデルを推奨するとされています。アプリケーションのアクセス許可には、常に管理者の同意が必要です。