Foundry IQ でのドキュメント レベルのアクセス制御 (Azure AI 検索)

Note

Foundry IQ (Azure AI 検索) は、マネージド取得用の上位レベルのナレッジ ソースおよびナレッジ ベース API と共に、直接インデックス作成およびクエリ API を提供します。 Azure ポータル、REST API、またはAzure SDKを使用してこれらの機能を構成するか、Microsoft Foundry ポータルでエージェントをナレッジ ベースに接続します。

Important

この記事でマークされている機能 (プレビュー) はパブリック プレビュー段階であり、Microsoft Azure プレビューの追加使用条件に従います。

Foundry IQ (Azure AI 検索) に固有のプレビュー用語については、「プレビュー機能」を参照してください。

SHAREPOINT ACL インジェストとクエリ時間アクセス許可のフィルター処理、ADLS Gen2 ACL/RBAC、および標準 BLOB コンテナー RBAC は、2026-10-01 データ プレーン REST API で一般提供されています。 プッシュ ACL インジェストも一般提供されています。 Microsoft Purview秘密度ラベルの適用はプレビューのままです。

Foundry IQ (Azure AI 検索) ではドキュメント レベルのアクセス制御がサポートされており、組織はデータ インジェストからクエリ実行まで、ドキュメント レベルできめ細かいアクセス許可を適用できます。 この機能は、セキュリティで保護された AI エージェント システムを構築し、データを接地し、取得拡張生成 (RAG) アプリケーション、およびドキュメント レベルで承認チェックを必要とするエンタープライズ検索ソリューションを構築するために不可欠です。

ドキュメント レベルのアクセス制御のアプローチ

Foundry IQ には、ドキュメント レベルのアクセス許可を適用するための 5 つの主要なアプローチが用意されています。それぞれ異なるデータ ソースと ID モデルに適しています。

アプローチ 説明
セキュリティ フィルター 文字列の比較。 アプリケーションは、ユーザーまたはグループ ID を文字列として渡します。この ID は、文字列に一致しないドキュメントを除き、クエリにフィルターを設定します。

セキュリティ フィルターは、ドキュメント レベルのアクセス制御を実現するための手法です。 この方法は API にバインドされていないため、任意のバージョンまたはパッケージを使用できます。
POSIX に似た ACL/RBAC スコープ 委任されたユーザーのMicrosoft Entra は、サポートされているアクセス許可メタデータに対して評価されます。 ADLS Gen2 ACL とコンテナー RBAC スコープインジェスト、標準の BLOB コンテナー RBAC スコープ インジェスト、およびクエリアクセス許可のフィルター処理は、REST API 2026-10-01で一般提供されています。 カスタマー マネージド プッシュ ACL インジェストも一般提供されています。 その他の機能は、文書化されている提供状況のままです。すべてのストレージ承認ポリシーがサポートされているわけではありません。 API と SDK のガイダンスについては、「 ACL アクセス許可メタデータの取得」を参照してください。
Microsoft Purview 秘密度ラベル (プレビュー) インデクサーは、サポートされているデータ ソース (Azure Blob Storage、ADLS Gen2、Microsoft 365、OneLake のSharePoint) から、Microsoft Purviewで定義されている秘密度ラベルを抽出します。 これらのラベルはメタデータとして保存され、クエリ時に評価され、Microsoft Entra トークンと Purview ポリシーの割り当てに基づいてユーザー アクセスが適用されます。 また、ラベルは ナレッジ ソース と エージェント検索応答によって表示されるため、ナレッジ ベースを使用する AI エージェントとチャット アプリは、同じラベル対応のフィルター処理を受け取ります。 このアプローチにより、Foundry IQ 承認が企業のMicrosoft Information Protection モデルに合わせて調整されます。
Microsoft 365 ACL のSharePoint Foundry IQ インデクサーは、サポートされているアクセス許可メタデータを抽出し、そのメタデータをクエリ時のアクセス チェックに使用し、REST API 2026-10-01 で実行します。 インデックス付きアクセス許可のサブセット、グループの制限、同期動作、および構成については、「SharePoint インデクサーを使用してアクセス許可メタデータを取り込む」を参照してください。
OneLake ソースのアクセス許可 (プレビュー) コピーされたユーザーとグループの ACL ではなく、インデックス付きのソースの場所とクエリ時の OneLake 承認を使用します。 「OneLake のアクセス許可を保持する」を参照してください。

インデックス付きナレッジ ソースの場合、 ingestionPermissionOptions を assetStoreと組み合わせることはできません。 そのため、ネイティブ ドキュメント レベルのアクセス許可インジェストが有効になっている場合、 イメージ サービス (プレビュー) は使用できません。

アクセス許可の取り込みでサポートされている解析とコンテンツの抽出

SharePoint、ADLS Gen2、またはBlob Storageに対してネイティブ ドキュメント レベルのアクセス許可を有効にする場合は、標準または既定のドキュメント解析とコンテンツ抽出を使用します。 インジェスト全体を通じて、各ソース項目のアクセス許可メタデータとソース コンテキストを保持します。

データソースと API でサポートされている場合は、Content Understanding に基づく抽出も使用できます。 必要なアクセス許可メタデータとソース コンテキストを保持するように、生成されたすべてのチャンクを構成します。 サポートされているダウンストリーム チャンクは、特殊なソース解析モードを選択する場合と同じではありません。

REST API 2026-10-01の場合は、構成するリソースの設定を使用してください。

Resource REST プロパティ Configuration
SharePoint、ADLS Gen2、または BLOB インデクサー parameters.configuration.parsingMode 標準のドキュメント解析には default を使用します。
ADLS Gen2 を含む BLOB ナレッジ ソース azureBlobParameters.ingestionParameters.contentExtractionMode minimal は既定の抽出オプションです;standard は Content Understanding に基づく抽出を指定します。 生成されたアクセス許可とソース コンテキストマッピングを保持します。
インデックス化されたSharePointナレッジソース indexedSharePointParameters.ingestionParameters.contentExtractionMode minimal は既定の抽出オプションであり、サポートされている環境では、Content Understanding ベースの抽出に standard を使用します。 生成されたパーサー設定を変更することによってではなく、ナレッジ ソース API を使用して抽出を構成します。

ナレッジ ソースの contentExtractionMode とインデクサーの parsingMode は異なる設定です。 特に、 minimal は特殊なプレーンテキスト解析モードではありません。 REST 定義については、「 インデクサー - 作成 と ナレッジ ソース - 作成または更新」を参照してください。

現時点では、お客様が選択した他の解析モードは、ドキュメント レベルのアクセス許可ではサポートされていません。 選択しないでください:

  • JSON 解析 (json)。
  • JSON 配列の解析 (jsonArray) または複数の JSON ドキュメントの個別のレコードへの解析。
  • JSON 行の解析 (jsonLines)。
  • CSV または区切りテキスト解析 (delimitedText)。
  • プレーンテキスト固有の解析 (text)。
  • Markdown 固有の解析 (markdown)。
  • サポートされているアクセス許可伝達コントラクトなしで、1 つのソース項目から複数の論理レコードを作成、分割、整形、またはマップするその他のモード。

これらの制限は、ファイル拡張子や抽出されたコンテンツの形式ではなく、解析モードに関するものです。 たとえば、 default 解析で処理されたプレーンテキスト ファイルでは、特殊な text モードは使用されません。 Content Understanding からの Markdown 出力は、markdown のソース解析モードではありません。

チャンク マッピングと必要なソース メタデータについては、SharePointアクセス許可ガイダンス、ADLS Gen2 アクセス許可ガイダンス、および BLOB RBAC スコープガイダンスを参照してください。

インデックス付きアクセス許可のソースを信頼する

クエリ時のアクセス許可フィルター処理では、インデックス付きレコードに関連付けられているアクセス許可メタデータが評価されます。 個別に、インジェスト設計では、そのレコードの ID を選択し、そのコンテンツへのアクセスを付与する権限を持つ者が誰であるかを確立する必要があります。 ドキュメント キーは、更新またはマージの対象となるレコードを選択するものであり、認可の境界ではありません。

ネイティブ コネクタ インジェストの場合は、ソース固有の構成に従い、ソース コンテンツ、ID、コネクタから派生したアクセス許可の間の関連付けを保持します。 カスタマー マネージド プッシュ インジェストの場合、承認された発行元はキーとアクセス許可の値を提供します。 アプリケーションで管理される文字列のフィルタリングは、アプリケーションの認証とフィルターの構築にも依存します。

通常の低信頼コンテンツは、フィールド名が一致するためだけに、認可権限メタデータとして扱わないようにしてください。 ソース ライター、インジェスト管理者、暗黙的および明示的なマッピング、エンリッチメント出力、および投影された子を確認します。 BLOB インジェストの場合は、 ID とアクセス許可の構成チェックリストを使用します。 このレビューは、アクセス許可の鮮度とは別です。

アプローチを選択する

次の条件を使用して、データ ソース、ID モデル、およびコンプライアンス要件に最適なアプローチを特定します。

Scenario 推奨される方法 なぜでしょうか
カスタム ID システムまたはMicrosoft以外のセキュリティ フレームワーク。 セキュリティ フィルター API に依存せず、一般公開されており、単純な文字列照合に基づいています。
Microsoft Entra のユーザーとグループのアクセス許可が、ADLS Gen2 と Azure Blob Storage からインデックス、インデックス付き ADLS Gen2 ACL、またはインデックス付きコンテナー RBAC スコープにプッシュされます。 POSIX に似た ACL/RBAC スコープ クエリ時の適用制御にネイティブアクセス許可メタデータを使用します。 スキーマ、プッシュ インデックス作成、およびクエリ適用は、REST API 2026-10-01で一般提供されています。ソース固有のインジェストには個別の可用性要件があります。
Microsoft Purview情報保護ポリシーによって既に管理されているエンタープライズ コンテンツ。 Microsoft Purview 機密ラベル Foundry IQ 全体での一元化された分類とポリシー割り当ての再利用。
Microsoft 365 (ライブラリ、リスト、ASPX サイト ページ) のSharePointからソースを取得したコンテンツ。 Microsoft 365 ACL のSharePoint 検索に同期される、サポート対象のアクセス許可のサブセットを評価します。 ソース側の要求時の取得または顧客が管理する更新プログラムの送信については、SharePointの取得方法と鮮度を比較します。

フィルターを使用したセキュリティ トリミングのパターン

ネイティブ ACL/RBAC スコープの統合が実行できないシナリオでは、セキュリティ文字列フィルターを使用して、除外条件に基づいて結果をトリミングします。 このパターンには、次のコンポーネントが含まれています。

  • ユーザー ID またはグループ ID を格納するには、インデックスに文字列フィールドを作成します。
  • 関連付けられている ACL を含むソース ドキュメントを使用してインデックスを読み込みます。
  • 文字列に一致するフィルター式をクエリ ロジックに含めます。
  • クエリ時に、呼び出し元の ID を取得します。
  • 呼び出し元の ID をフィルター文字列として渡します。
  • 結果は、ユーザーまたはグループの ID 文字列を含められなかった一致を除外するためにトリミングされます。

プッシュ またはプル モデル API を使用できます。 このアプローチは API に依存しないため、インデックスとクエリにフィルター処理手順の有効な文字列 (ID) があることを確認するだけで済みます。

このアプローチは、カスタム アクセス モデルまたはMicrosoft以外のセキュリティ フレームワークを持つシステムに役立ちます。 この方法の詳細については、「 Foundry IQ で結果をトリミングするためのセキュリティ フィルター」を参照してください。

POSIX に似た ACL と RBAC スコープのアクセス許可のネイティブ サポートのパターン

ネイティブ アクセス許可フィルタリングでは、インデックス化された Microsoft Entra のユーザーおよびグループ オブジェクト ID と、ストレージ コンテナー RBAC スコープを使用します。

Azure Data Lake Storage (ADLS) Gen2 では、ディレクトリとファイルの ACL をサポートしています。 ADLS Gen2 インデクサーまたは ADLS Gen2 用に構成された BLOB ナレッジ ソースを使用して、REST API 2026-10-01でサポートされている ACL とコンテナー RBAC スコープを取り込みます。 標準Blob Storageの場合、Blob indexerまたはナレッジ ソースは、ファイルごとの ACL ではなくコンテナー RBAC スコープを取り込みます。

ACL で保護されたコンテンツの場合は、管理を容易にするために、個々のユーザー アクセスに対するグループ アクセスを使用します。 このパターンには、次のコンポーネントが含まれています。

  • ACL が割り当てられているドキュメントまたはファイルから始めます。
  • インデックスでアクセス許可フィルターを有効にします。
  • インデックス内の 適切な文字列または文字列コレクション フィールドにアクセス許可フィルターを追加します。
  • 関連付けられた ACL を持つソース ドキュメントでインデックスを読み込みます。
  • インデックスにクエリを実行し、要求ヘッダーに x-ms-query-source-authorization を追加します。

ネイティブのアクセス許可でフィルター処理されたクエリは、呼び出し元と、ドキュメントのアクセス許可が評価されるユーザーを区別します。

  • Authorization には、Search RBAC の呼び出し元トークンが含まれます。 アプリケーション サービス プリンシパルまたはマネージド ID は、検索インデックス データ閲覧者や検索インデックス データ共同作成者などの適切なロールで Search を呼び出すことができます。
  • x-ms-query-source-authorization には、ドキュメントアクセス許可評価用の委任されたユーザーのトークンが含まれます。 グループはアクセス許可メタデータであり、トークンを含む ID ではありません。

Search を呼び出すことができるアプリケーションは、ドキュメント権限の対象主体として必ずしもサポートされていません。 たとえば、承認されたアプリケーションでは、Purview 以外のインデックスで昇格された読み取りを使用できますが、その管理バイパスではアプリケーション ACL メンバーシップは評価されません。 サポートされているトークン フローと操作固有の制限については、「 アプリケーション トークンの境界」を参照してください。

プッシュ API ワークフローを使用して、コンテンツとネイティブアクセス許可メタデータを読み込みます。

REST API 2026-10-01を使用して、ADLS Gen2 ACL とコンテナー スコープ、または標準 BLOB コンテナー スコープのプル モデル (インデクサー) API を使用します。

インジェスト中に ACL アクセス許可メタデータを取得する

ACL アクセス許可を取得する方法は、ドキュメント ペイロードをプッシュするか、ADLS Gen2 インデクサーを使用するかによって異なります。

ADLS Gen2 と標準の BLOB アクセス許可インジェストの場合は、 REST API 2026-10-01 を使用します。 その API と必要なプロパティのサポートについては、SDK の変更ログを確認してください。 GA REST が利用可能であっても、SDK パッケージの準備が整っていることを意味するものではありません。

プッシュ ACL インジェストは一般提供されています。 プッシュ ガイドには、2026-10-01 REST ワークフローが含まれています。 アクセス許可フィルターと ACL/RBAC インジェストのサポートについては、SDK の変更ログを確認してください。

プッシュ モデルアプローチの場合:

  1. REST API または必要なプロパティをサポートするAzure SDK パッケージを使用して、アクセス許可フィルターを使用してインデックス スキーマを作成します。
  2. グループ ID またはユーザー ID を取得するには、Microsoft Graph SDK を使用することを検討してください。
  3. ドキュメントとその関連するアクセス許可メタデータを検索インデックスにプッシュするには、Index Documents または同等のAzure SDK API を使用します。

プル モデルの ADLS Gen2 インデクサー アプローチまたは BLOB (ADLS Gen2) ナレッジ ソースの場合:

  1. ディレクトリ内のファイルが ADLS Gen2 アクセス制御モデルを使用してセキュリティで保護されていることを確認します。
  2. Indexers - Create (REST API)、Knowledge Sources - Create (REST API)、または同等のAzure SDK API を使用してインデクサー、インデックス、データ ソースを作成します。

スキルセットで ADLS または BLOB ドキュメントをチャンク化する場合は、インデクサー フィールド マッピングだけでなく、インデックス プロジェクションを使用して、保護されたすべてのチャンクに対するアクセス許可を設定します。

アクセス許可インジェストのソース メタデータ

ソース コンテキストとアクセス許可の付与は、さまざまな目的に役立ちます。 ソース パスは、エンコードされたキー、引用 URL、生成された親 ID ではなく、生の値として保持します。

ソースとシナリオ ソース メタデータと目的 マッピングと可用性
ADLS の名前付きユーザー/グループの ACL 必要な metadata_storage_path (Edm.String) は、ソースを識別します。 metadata_user_ids と metadata_group_ids には有効な ACL が含まれています。 と の注釈が付けられた フィールドに ACL をマップします。 レコードとチャンクのパスを保持します。 2026-10-01 で一般提供開始。
ADLS RBAC のみ metadata_storage_path は、ACL フィールドがなくても、ADLS アクセス許可インジェストに必要です。 metadata_rbac_scope はコンテナーを識別します。 スコープをEdm.Stringの注釈が付いたrbacScopeフィールドにマップします。 必要なパスは、ロールの割り当てをコピーするために使用されません。 GA の2026-10-01。
ADLS 混合 ACL/RBAC ソース パス、有効なユーザー/グループ ACL、コンテナー スコープ。 レコードと投影されたチャンクに対して、構成されているすべてのフィールドを保持します。 サポートされている独立したグラントがあれば、アクセスを承認できます。 2026-10-01 で GA。
Standard Blob RBAC metadata_rbac_scope はコンテナーを識別します。このスコープを計算するためにドキュメントごとのパスは必要ありません。 生成されたナレッジ ソース パイプラインには、引き続き metadata_storage_pathが含まれます。 スカラー スコープを、ドキュメントとチャンクの rbacScope注釈付きフィールドにマップします。 ADLS ファイル ACL 推論はありません。 2026-10-01 で GA。
SharePoint ACLs metadata_spo_item_path は項目コンテキストを提供します。 metadata_spo_site_url はサイト コンテキストを提供します。 リストとページでは、 metadata_spo_site_asset_item_idも使用されます。 ソース固有のSharePoint スキーマとプロジェクション ガイダンスを使用してください。 SharePoint可用性と要件は、Storage GA スコープとは無関係です。

直接スキーマ定義、権限のあるマッピング、生成されたパイプライン、既存のレコード修復については、 ADLS アクセス許可インジェスト と BLOB RBAC スコープインジェストに関するページを参照してください。

名前付き ID を除外しながら広範なアクセスを許可する ADLS ソース ACL については、「サポートされていない暗黙的な拒否 blocklists」を参照してください。

Microsoft 365 の SharePoint における基本 ACL アクセス許可取り込みのパターン

インデックス付きSharePointコンテンツの場合、Foundry IQ はサポートされているソースのアクセス許可をメタデータとして格納し、それらを使用してクエリ結果をフィルター処理できます。 このアクセス許可の構成には、Microsoft 365 の SharePoint インデクサーと REST API 2026-10-01、またはこの機能をサポートする SDK パッケージを使用します。

アクセス許可の要件、サポートされているグループリレーションシップ、アクセス許可の同期、および制限については、「SharePoint インデクサーを使用してアクセス許可メタデータを取り込む」を参照してください。

スキルセットが (たとえば、統合ベクター化のためのテキスト分割スキルを使用して) ドキュメントをチャンクする場合、ACL フィールドはインデクサー フィールド マッピングからインデックス プロジェクションに移動します。 ACL フィールドを設定する場所の選択を参照してください。

Microsoft Purview センシティビティ ラベルのパターン (プレビュー)

ラベル インジェストを有効にすると、Foundry IQ はサポートされているデータ ソースから秘密度ラベルのメタデータを抽出します。 これらのデータ ソースには、Azure Blob Storage、Azure Data Lake Storage Gen2 (ADLS Gen2)、Microsoft 365のSharePoint、および OneLake Microsoftが含まれます。 抽出されたラベルは、ドキュメント コンテンツと共にインデックスに格納されます。

クエリ時に、Foundry IQ は各ドキュメントの秘密度ラベル、ユーザーのMicrosoft Entra トークン、および組織の Purview ポリシーをチェックしてアクセスを決定します。 ユーザーの ID とラベルベースのアクセス許可で構成された Purview ポリシーでのアクセスが許可されている場合にのみ、ドキュメントが返されます。

このパターンには、次のコンポーネントが含まれます。

  • REST API または Purview ラベル インジェストをサポートするプレビュー SDK を使用して、インデックス、2026-11-01-preview、および インデクサー (スケジュール設定用) を構成します。
  • Foundry IQ サービスで システム割り当てマネージド ID を有効にします。 Purview ラベル抽出では、ユーザー割り当てマネージド ID はサポートされていません。サービス独自の ID は、昇格された Purview アクセス許可を保持する必要があります。 次に、テナント全体管理者または特権ロール管理者に、Foundry IQ サービスがMicrosoft Purviewで認証し、ラベル メタデータを抽出できるようにするために必要なアクセス権を付与します。
  • インジェスト中にシステムが認識して保持できるように、インデックス作成の前に秘密度ラベルをドキュメントに適用します。
  • クエリ時に、ヘッダー x-ms-query-source-authorization を介して有効なMicrosoft Entra トークンを各クエリ要求にアタッチします。 Foundry IQ は、トークンと関連するラベル メタデータを評価して、ラベルベースのアクセス制御を適用します。

Purview 秘密度ラベルの適用は、シングルテナント シナリオに限定され、RBAC 認証が必要です。 プレビュー期間中は、REST API とAzure SDKでのみサポートされます。 オートコンプリート API と Suggest API は現在、Purview 対応インデックスでは使用できません。

秘密度ラベルが表示される場所

システムがクエリ時にラベルを適用したり、応答の取得でラベルを返したりする前に、まずラベル メタデータをインデックスに同期する必要があります。 このセクションで説明されている両方の使用パスは、この同期手順に依存しています。 サポートされているデータ ソースに対して Foundry IQ インデクサーを直接構成するか、ナレッジ ソースを作成するときに同等のインジェスト オプションを有効にすることで、ラベルを同期できます。 どちらの場合も、環境は秘密度ラベルメタデータ同期構成の前提条件 (マネージド ID、Foundry IQ サービスの RBAC、必要なMicrosoft Purviewとデータ ソースのアクセス許可) を満たしている必要があります。 エンド ツー エンドのインデクサーのセットアップについては、「Foundry IQ インデクサーを使用して秘密度ラベルMicrosoft Purview取り込む」を参照してください。 ナレッジ ソース主導の取り込みでは、ingestionPermissionOptions時に sensitivityLabel を設定して を含めます。

ラベルを同期すると、2 つのクエリ パスで同じインデックス付きラベル メタデータが使用されます。 アプリケーションで Foundry IQ を呼び出す方法に合った経路を選択してください。

  • 直接クエリ API (/docs/search): ユーザーのMicrosoft Entra トークンをx-ms-query-source-authorizationにアタッチします。 管理者は、監査対応の調査のために 特権読み取り 要求を送信することもできます。 セットアップと例については、「Microsoft Purview の秘密度ラベルのクエリ時の適用」を参照してください。

  • ナレッジ ソースとエージェント検索 (MCP):ナレッジ ソースにsensitivityLabelを含むようにingestionPermissionOptionsを設定します。 取得アクションと MCP knowledge_base_retrieve ツールは、クライアントが表示バナーとポリシーの適用に使用できる参照ごとの sensitivityLabelInfo と応答レベルの metadata.responseSensitivityLabelInfo を返します。 セットアップについては、「 ナレッジ ソースの作成 」および「 応答を取得する際の機密ラベルメタデータの検査」を参照してください。

ナレッジ ソースが、統合ベクトル化またはカスタム Text Split スキルによって生成されたものなど、チャンク化されたインデックスを指している場合、スキルセットでは 各チャンク行にも機密ラベルを投影する必要があります。 このプロジェクションがないと、チャンク レベルの参照はフィルター処理されません。

詳細については、「Foundry IQ インデクサーを使用して Microsoft Purview の秘密度ラベルを取り込む」を参照してください。

クエリ時にドキュメント レベルのアクセス許可を適用する

トークンベースのクエリ強制は、POSIX ライクな ACL および RBAC のスコープ、Microsoft Purview の秘密度ラベル、ならびに Microsoft 365 における SharePoint ACL パターンに適用される共通機能です。 Foundry IQ は、ネイティブ トークンベースのクエリを使用して、各要求で呼び出し元のMicrosoft Entra トークンを検証し、ドキュメント ACL メタデータがインデックスに同期されている限り、呼び出し元がドキュメント ACL に従って読み取りを許可されているドキュメントのみに結果セットをトリミングします。

x-ms-query-source-authorization ヘッダーを使用してユーザーのトークンをクエリ要求に付加すると、Foundry IQ は次の処理を行います:

  1. トークンからユーザー、グループ、スコープの要求を抽出します。
  2. これらの要求を、インデックス付きドキュメント (ACL エントリ、RBAC スコープ、Purview ラベルの割り当て、または SharePoint ACL) と共に格納されているアクセス許可メタデータと比較します。
  3. 同期されたアクセス許可メタデータによって呼び出し元のアクセスが許可されているドキュメントのみを返します。

アクセス許可の鮮度

クエリ時の適用では、格納されたアクセス許可メタデータが使用されますが、その鮮度はアクセス許可の種類によって異なります。 ADLS のユーザー ACL とグループ ACL はインデックス付きスナップショットです。ACL のみの変更では、既定の有効化、対象となる通常の実行でのほぼ毎日の自動更新、または明示的なアクセス許可の再同期が使用されます。 コンテナー RBAC スコープは、ロールの割り当てではなくリソースを識別します。委任ユーザーの認可は、反映とキャッシュを考慮して、クエリ時に個別に評価されます。 グループ メンバーシップの解決には、独自の伝達とキャッシュの動作もあります。

SharePointの場合、増分処理では、検出された項目レベルの変更と、サポートされているルート以外のフォルダー権限の変更 (変更されていない子孫を含む) が対象となります。 その他のスコープまたは見逃した通知では、明示的な更新が必要になる場合があります。 シナリオ テーブルとタイミング制限については、「 インデックス付きコンテンツとソース コンテンツの間でアクセス許可を同期 する」を参照してください。

アクセス許可の更新では、即時失効やコーパス全体の鮮度 SLA は提供されません。 操作手順、障害、チャンク整合性、クリーンアップについては、ADLS 同期、BLOB スコープの鮮度、およびSharePoint同期に関するページを参照してください。 カスタム プッシュ インジェストは、独自のメタデータの同期を引き続き担当します。

エンドツーエンドのクエリ実装手順については、Foundry IQ でのクエリ時の ACL と RBAC の適用に関するページを参照してください。

ドキュメント レベルのアクセス制御の利点

Foundry IQ にネイティブに備わるドキュメントレベルのアクセス制御には、アプリケーション側のフィルタリングに対して明確な利点があります。

  • カスタムアクセス許可コードを減らします。 Foundry IQ は、クエリの実行中にサポートされているグループ解決とアクセス許可のフィルター処理を処理します。
  • 既存のコンプライアンス管理に準拠: Microsoft Entra、Microsoft Purview、SharePoint のアクセス許可メタデータを再利用することで、検索結果をソースの ID システムと整合した状態に保つのに役立ちます。 各ソースのアクセス許可同期モデルを確認して、その制限を理解します。
  • 各 ACL 同期の後に、ソースのアクセス許可を優先します。トークンベースのアプローチ (ACL、RBAC スコープ、Purview ラベル、SharePoint ACL) の場合、クエリ時間の適用では、ドキュメント化されたソース固有の同期メカニズム (インデクサーの実行、プッシュ API 更新、または Purview 更新) によって既にインデックスに書き込まれているアクセス許可メタデータが使用されます。
  • パフォーマンスとクエリ後のトリミングが向上します。 検索パイプライン内でのフィルター処理は、アプリケーションに大きな結果セットを読み込み、そこでトリミングするよりも高速です (特にクエリ量が多い場合)。
  • 既存の ID インフラストラクチャを再利用します。Microsoft Entra ID とSharePoint ID は、アクセスの決定に関する信頼できる情報源であり、ID の重複と、並列アクセス許可ストアを維持する運用上のオーバーヘッドが軽減されます。

チュートリアルとサンプル

Foundry IQ のドキュメント レベル アクセス制御の詳細については、関連記事やサンプルをご覧ください。