Incremental SharePoint permissions syncとは?Azure AI Search / Foundry IQの権限同期プレビューを解説

2026年6月3日に公開・更新された「Incremental SharePoint permissions sync for Azure AI Search and Foundry IQ」は、SharePointの権限変更をAzure AI SearchやFoundry IQの検索・AI回答に反映しやすくするプレビュー機能です。結論から言うと、AI検索やRAG、Copilot系の社内ナレッジ活用で「権限を外したはずの文書が検索結果に残る」リスクを減らせます。ただし、すべての権限変更が自動で即時反映されるわけではなく、サイト・ライブラリ・フォルダーなど親スコープの権限変更では明示的な再同期が必要です。(マイクロソフト アジュール)

この更新は、SharePoint / OneDrive上の業務文書をAI検索やエージェントの根拠データとして使う企業にとって重要です。特に、Azure AI SearchのSharePointインデクサー、Foundry IQのIndexed SharePoint knowledge source、社内Copilot、RAGアプリを運用している管理者・開発者は、APIバージョン、ACL取り込み、クエリ時のユーザー認証、再同期手順を確認しておく必要があります。

目次

Incremental SharePoint permissions syncで何が変わるのか

今回のポイントは、SharePointのアクセス制御リスト、いわゆるACLの変更を、Azure AI SearchのインデックスやFoundry IQのナレッジソースに段階的に同期できるようになったことです。

従来の構成では、SharePointの文書を検索インデックスに取り込んでも、後からSharePoint側で権限を変更した場合、その変更が検索結果に反映されるまでに再インデックスや明示的な更新が必要になるケースがありました。今回のプレビューでは、2026-05-01-preview REST API以降を使うことで、個別アイテムに設定されたユニーク権限のACL変更が、次回の成功したインデクサー実行時に検出・更新されます。(Microsoft Learn)

分かりやすく言えば、次のような場面で効果があります。

場面従来起こりやすかった課題今回の更新による改善
機密資料の閲覧権限を特定メンバーだけに変更したAI検索のインデックス側に古いACLが残る可能性があるアイテム単位のユニーク権限変更は次回のインデクサー実行で同期される
SharePointリストやASPXページをナレッジ化した文書以外の権限取り込み設計が複雑だったリスト項目・モダンASPXページのACLにもプレビュー対応
SharePointサイトグループを使っているMicrosoft Entraグループだけでは実際のSharePoint権限を表現しきれない場合があるOwners、Members、Visitors、カスタムサイトグループの取り込みに対応。ただし追加設定が必要
社内RAGアプリでユーザーごとに検索結果を出し分けたいアプリ側で権限フィルターを実装する負担が大きいx-ms-query-source-authorizationでユーザーIDに基づくクエリ時フィルタリングを利用できる

重要なのは、これは「SharePointの権限設定をAzure AI Searchが変更する機能」ではない点です。権限の管理元はSharePoint / Microsoft Entra側にあり、Azure AI SearchやFoundry IQは同期済みの権限メタデータを使って、検索・取得結果を絞り込みます。(Microsoft Learn)

影響範囲:SharePoint / OneDriveのどこに関係するのか

今回の公式ドキュメントで中心になっている対象は、Microsoft 365のSharePointコンテンツです。具体的には、ドキュメントライブラリ内のファイル、SharePointリスト項目、モダンASPXサイトページが対象として説明されています。(Microsoft Learn)

OneDriveについては、実務上はSharePoint基盤上の個人用ストレージとして扱われる場面がありますが、今回の公式説明で直接の主語になっているのはSharePoint in Microsoft 365です。そのため、OneDrive for Business上のファイルを同じ設計で扱う場合は、対象コネクタ、取得対象サイト、権限モデル、サポート範囲を個別に確認してください。

影響を受けやすい環境

次のいずれかに当てはまる企業では、早めに確認する価値があります。

  • Azure AI SearchでSharePointインデクサーを使っている
  • Foundry IQのIndexed SharePoint knowledge sourceを使っている、または検証している
  • SharePoint文書を社内チャットボットやRAGアプリの根拠データにしている
  • Microsoft 365 Copilot以外の独自AIエージェントからSharePointコンテンツを検索している
  • 部門別、役職別、プロジェクト別に細かいSharePoint権限を使っている
  • SharePointサイトグループ、Microsoft 365グループ、セキュリティグループが混在している

逆に、単にSharePointやOneDriveをファイル共有として使っているだけで、Azure AI SearchやFoundry IQに取り込んでいない環境では、直接の影響は限定的です。

管理者が最初に確認すべきこと

管理者が最初に見るべきポイントは、「AI検索に出してよい文書だけが、正しいユーザーにだけ返る状態になっているか」です。機能を有効化する前に、SharePoint側の権限設計が乱れていると、その乱れがAI検索にも持ち込まれます。

SharePoint側の権限を棚卸しする

まず、対象サイト・ライブラリ・フォルダー・ファイルで権限継承がどう使われているかを確認します。今回のIncremental SharePoint permissions syncは、個別アイテムのユニーク権限変更には強くなっていますが、サイト、ライブラリ、リスト、フォルダーなど親スコープの権限変更は自動検出の対象外です。親スコープの変更を反映するには、/resyncで権限を再同期するか、影響する文書に対して/resetdocsを使う必要があります。(Microsoft Learn)

変更内容自動検出管理者の対応
ファイル、リスト項目、ページなど個別アイテムのユニーク権限変更される次回の成功したインデクサー実行を確認
コンテンツ変更されるインデクサー実行後に検索結果を検証
サイト、ライブラリ、リスト、フォルダーの権限変更されない/resyncまたは/resetdocsを実行
既存インデクサーにACL取り込みを後から有効化されない/resyncで既存アイテムのACLをバックフィル

特に注意したいのは、部署異動やプロジェクト終了時です。SharePointではフォルダーやライブラリ単位で権限を変更する運用が多いため、「上位の権限を変えたからAI検索側も自動で追従する」と考えると、古いACLが残る可能性があります。

プレビューAPIを使っているか確認する

Incremental ACL updatesを利用するには、2026-05-01-preview REST API以降、または同等のプレビューSDKが必要です。以前のプレビューAPIでは、ACLが初回取り込み時に取得されるだけで、その後の権限変更には明示的な再インデックスが必要になると説明されています。(Microsoft Learn)

確認すべき箇所は次のとおりです。

確認項目見る場所判断基準
APIバージョンREST呼び出し、SDK、IaCテンプレート2026-05-01-preview以降を使っているか
SDK.NET / Pythonなどのパッケージプレビュー機能対応版か
デプロイ方法Bicep、Terraform、CI/CD、手動設定古いAPI指定が残っていないか
検証環境開発・ステージング本番前に権限変更シナリオを再現できるか

プレビュー機能なので、本番適用は慎重に進めるべきです。特に、規制対象データ、個人情報、人事・法務・財務データを含むSharePointサイトでは、検証環境で「権限変更後に誰が何を取得できるか」をユーザー単位で確認してください。

Microsoft Entraアプリの権限を確認する

ACL取り込みには、Microsoft Entraアプリのアプリケーション権限が必要です。委任されたアクセス許可は小規模テストでは使える場合がありますが、ACL ingestionはサポートされないとされています。(Microsoft Learn)

代表的な権限要件は次のとおりです。

シナリオ必要になりやすい権限・設定
ドキュメントライブラリのACLを取り込むMicrosoft GraphのFiles.Read.AllSites.FullControl.AllまたはSites.Selected
SharePointサイトグループも考慮するSharePoint API側のSites.FullControl.AllまたはSites.Selected、フェデレーション資格情報
リスト項目やASPXページのACLを取り込むUser.Read.Allが必要になるケースがある
Sites.Selectedで最小権限にする対象SharePointサイトごとにアプリへ明示的なアクセス許可を付与

Sites.FullControl.Allは強力な権限です。全社展開では、可能であればSites.Selectedを検討し、対象サイトを限定する設計にしたほうが監査しやすくなります。ただし、Sites.Selectedを使う場合は、対象サイトへの明示的な権限付与を忘れるとインデクサーが失敗します。(Microsoft Learn)

開発者が確認すべき実装ポイント

開発者にとって重要なのは、ACLを「取り込む」だけでなく、検索・取得時に「ユーザーのIDで絞り込む」ことです。インデックスに権限メタデータがあっても、クエリ時に適切なユーザートークンを渡さなければ、期待したセキュリティトリミングになりません。

ACLフィールドをインデックスに正しく持たせる

Azure AI SearchでSharePoint ACLを使うには、ACLメタデータをUserIdsGroupIdsなどのフィールドに格納し、permissionFilterfilterableを設定します。公式ドキュメントでは、retrievableは検証時だけtrueにし、確認後はfalseに戻す運用が示されています。(Microsoft Learn)

実装上の落とし穴は、チャンク化です。RAGでよく使うText Split skillや統合ベクトル化では、元文書を複数チャンクに分けます。このとき、各チャンクにACLフィールドが投影されていないと、検索で返されるチャンク単位の権限判定が正しく機能しません。

構成ACLフィールドの持たせ方
1文書=1検索ドキュメントインデクサーのfieldMappingsで対応
1文書を複数チャンク化し、親文書をインデックスしないindexProjectionsで各チャンクにACLを投影
親インデックスと子チャンクインデックスを分ける親・子の両方に必要なACLメタデータを持たせる

「検索結果にはチャンクが返るのに、ACLは親文書にしかない」という構成は、AI検索で権限漏れや結果欠落の原因になります。

クエリ時にユーザートークンを渡す

クエリ時の権限適用では、x-ms-query-source-authorizationヘッダーにエンドユーザーのアクセストークンを渡します。Azure AI Searchは、取り込み済みのACLメタデータとユーザーのMicrosoft Entra情報を照合し、権限のない文書を結果から除外します。(Microsoft Learn)

Foundry IQやknowledge baseのretrieve APIを使う場合も考え方は同じです。Indexed SharePoint knowledge sourceでは、作成時にingestionPermissionOptionsで権限メタデータを取り込み、取得時にx-ms-query-source-authorizationでユーザーIDを渡します。設定されていない場合、権限メタデータがインデックスに存在せず、ヘッダーを渡しても期待したフィルタリングにならない点に注意が必要です。(Microsoft Learn)

Indexed SharePointとRemote SharePointを使い分ける

Foundry IQやAzure AI Searchの構成では、SharePointを「インデックス化して使う」方法と、「SharePointに直接問い合わせる」方法があります。

方式特徴向いているケース
Indexed SharePoint knowledge sourceSharePointコンテンツをAzure AI Search側に取り込み、検索インデックスとして使う高速検索、ベクトル検索、カスタムRAG、独自ランキングを使いたい
Remote SharePoint knowledge sourceCopilot Retrieval API経由でSharePointに直接問い合わせる。コンテンツはインデックス化しないSharePoint側の完全な権限モデルやラベルを重視したい

Microsoft Learnでは、完全なSharePoint権限モデル、感度ラベル、組み込みのセキュリティトリミングが必要なシナリオではRemote SharePoint knowledge sourceの利用が案内されています。(Microsoft Learn)

つまり、カスタム検索やRAG性能を重視するならIndexed SharePoint、SharePoint側のガバナンス追従を最優先するならRemote SharePointを検討するのが実務上の判断軸です。

移行・展開時のチェックリスト

既存のAzure AI Search / Foundry IQ環境に今回のIncremental SharePoint permissions syncを取り入れる場合は、いきなり本番で有効化せず、権限変更シナリオを先に洗い出してください。

フェーズ確認すること失敗しやすいポイント
現状調査どのSharePointサイトをインデックス化しているか古い検証用インデクサーが残っている
権限棚卸しユニーク権限、継承、サイトグループの利用状況フォルダー単位の権限変更が多い
API確認2026-05-01-preview以降を使っているかSDKだけ更新してREST呼び出しが古い
アプリ権限確認Microsoft Graph / SharePoint APIの権限、管理者同意Graph側とSharePoint API側の同名権限を混同する
インデックス設計UserIdsGroupIds、チャンクへのACL投影チャンクだけに検索結果が返り、ACLが空になる
クエリ実装x-ms-query-source-authorizationを渡しているかサービストークンとユーザートークンを混同する
再同期運用/resync/resetdocsの実行タイミング親スコープ変更後に再同期しない
監査権限変更後の検索結果をユーザー別に検証管理者アカウントだけで確認してしまう

特に移行時は、「ACL ingestionを有効にしたから既存データにも自動で権限が入る」と考えないことが重要です。既存インデクサーに後からACL取り込みを有効化した場合は、/resyncで既存アイテムのACLをバックフィルする必要があります。(Microsoft Learn)

利用者には何が変わるのか

一般利用者から見ると、画面や操作が大きく変わる機能ではありません。変化があるのは、AI検索や社内チャットボットが返す文書の範囲です。

例えば、経理部だけが見られる予算ファイル、特定プロジェクトメンバーだけが見られる議事録、人事部だけが管理する評価資料などは、SharePoint側の権限が正しく設定され、Azure AI Search側にもACLが同期されていれば、権限のないユーザーの検索結果やAI回答の根拠に含まれにくくなります。

ただし、利用者に「AIが見せないから安心」と説明するのは不十分です。正しい説明は、「SharePointの権限をもとにAI検索側でも結果を絞り込む設計にできる。ただし、権限同期とクエリ時認証が正しく構成されている必要がある」です。

注意すべき制限と落とし穴

今回の更新は便利ですが、プレビュー機能であり、万能ではありません。設計時には次の制限を前提にしてください。

注意点実務上の影響
親スコープの権限変更は自動検出されないサイト・ライブラリ・フォルダー単位の変更後は再同期手順が必要
Azure portalではこのACL機能をサポートしないと説明されているREST API、SDK、IaCでの管理が中心になる
「Anyone」リンクや「組織内のすべてのユーザー」リンクはプレビューで未対応共有リンク運用が多い組織では検索結果とのずれが出る可能性
外部/ゲストユーザーは未対応B2B共有や取引先共有をAI検索対象にする場合は注意
SharePoint Information Management policiesは評価・取り込み・クエリ時適用の対象外既存の情報管理ポリシーをAI検索の権限制御として過信できない
一部のスキルセット・デバッグ系機能では権限継承を含む文書レベル権限が含まれないCustom Web API skill、GenAI Prompt skill、Knowledge storeなどを使う構成は要検証

とくに共有リンクの扱いは見落としがちです。SharePointでは「リンクを知っている組織内ユーザー」や「Anyone」リンクが運用で使われることがありますが、今回のプレビューでは「Specific people」リンクのみがサポート対象とされています。(Microsoft Learn)

管理者・開発者が今すぐ取るべき対応

まずは、本番環境に入れるかどうかではなく、「自社のSharePoint権限がAI検索に耐えられる状態か」を確認するのが先です。

管理者向けの対応

管理者は次の順で確認すると、権限漏れのリスクを減らせます。

  1. Azure AI SearchまたはFoundry IQに取り込んでいるSharePointサイトを一覧化する
  2. 対象サイトの権限継承、ユニーク権限、共有リンク、外部共有の有無を確認する
  3. サイトグループとMicrosoft Entraグループの使い分けを整理する
  4. Sites.FullControl.Allが必要か、Sites.Selectedで絞れるかを判断する
  5. 親スコープ権限を変更したときの/resync運用を手順化する
  6. 権限変更後に、一般ユーザー・部門ユーザー・管理者で検索結果を比較する

開発者向けの対応

開発者は次の実装項目を重点的に見直してください。

  1. REST APIまたはSDKが2026-05-01-preview以降に対応しているか確認する
  2. SharePointデータソースでindexerPermissionOptionsを設定する
  3. インデックスにUserIdsGroupIds、必要に応じてSharePointSiteUrlを追加する
  4. チャンク化している場合、すべてのチャンクにACLフィールドを投影する
  5. Indexed SharePoint knowledge sourceではingestionPermissionOptionsを設定する
  6. retrieve APIや検索APIでx-ms-query-source-authorizationにエンドユーザーのトークンを渡す
  7. 権限を外したユーザーで、対象文書が検索結果・AI回答の根拠に出ないことをテストする

導入判断の目安

今回のIncremental SharePoint permissions syncは、すべての組織がすぐに本番導入すべき機能というより、SharePoint文書をAI活用する企業が「安全に検索・回答させるための基盤」として検証すべき機能です。

導入を前向きに検討したいのは、次のような組織です。

  • SharePoint文書を社内AI検索やRAGで活用している
  • 部門・役職・プロジェクトごとに文書権限が細かく分かれている
  • AI回答の根拠に機密文書が混ざるリスクを下げたい
  • SharePointサイトグループを含めた権限反映を検証したい
  • Foundry IQやAzure AI Searchのknowledge sourceを本格展開する予定がある

一方、SharePoint側の権限運用が整理されていない組織では、先に権限設計の見直しが必要です。AI検索は、元データの権限管理を補完するものではありますが、SharePoint側の権限ミスを自動で正してくれるものではありません。

まとめ:AI検索の前にSharePoint権限の運用設計を固める

Incremental SharePoint permissions syncは、SharePoint / OneDrive上の業務コンテンツをAzure AI SearchやFoundry IQで安全に活用するうえで重要な更新です。個別アイテムの権限変更が次回のインデクサー実行で増分同期されるため、社内AI検索やRAGアプリのセキュリティトリミングを実装しやすくなります。

ただし、親スコープの権限変更には明示的な再同期が必要です。さらに、ACL取り込み、チャンクへの権限投影、x-ms-query-source-authorizationによるクエリ時認証、SharePointサイトグループの追加設定など、管理者と開発者の両方で確認すべき項目があります。

次に取るべき行動は、対象SharePointサイトの棚卸しです。どの文書をAI検索に取り込み、どの権限を反映し、どのユーザーで検証するのかを整理したうえで、検証環境で2026-05-01-preview API、ACL同期、再同期手順を確認しましょう。

この記事を書いた人

実務の現場で詰まりがちなポイントを地図にするITブログ「IT trip」を運営。Windows/Office(Teams・Excel)からSQL、サーバ運用、ガジェットまで、再現性のある手順と“なぜそうなるか”を丁寧に解説します。読んだらすぐ試せること、そして迷った人の次の一歩が見えることを大切にしています。

コメント

コメントする

目次