Azure AI 検索のセキュリティとは|API キーとロール、IP ファイアウォール、マネージド ID を実機で検証

Azure AI 検索のセキュリティとは|API キーとロール、IP ファイアウォール、マネージド ID を実機で検証 AI

はじめに

AI 編の 6 回目。
今回は、RAG(検索拡張生成)やエージェントのナレッジで使う Azure AI 検索のセキュリティを扱う。
実機では、Basic の検索サービスを作り、API キーとロール、API アクセス制御の 3 つの設定、セキュリティ フィルター、IP ファイアウォール、マネージド ID でのインデクサーの接続を、通る・止まるで確かめた。
※2026年11月時点の情報です。

前回:Foundry Tools のセキュリティとは

Foundry Tools のセキュリティとは|キー認証の無効化、ネットワーク制限、データ損失防止を実機で検証
Foundry Tools(旧 Azure AI サービス)共通のセキュリティ。キー認証と Entra ID、キー認証の無効化、ネットワーク制限、データ損失防止、Azure Policy を実機で検証。

AI 検索のセキュリティの全体像

AI 検索のセキュリティは、アプリから検索サービスへの受信と、インデクサーからデータ ソースへの送信に分けて考える。
TLS や保存データの暗号化などは Microsoft が自動で管理し、ネットワーク、認証と認可、文書単位のアクセス制御は利用者が構成する。

Azure AI 検索のセキュリティの全体像
項目内容
転送中の暗号化すべての接続で TLS 1.2 か 1.3。
TLS 1.0 と 1.1 は使えない
保存データの暗号化Microsoft マネージド キーの AES 256 ビット暗号化が自動でかかる。
カスタマー マネージド キーで 2 つ目の層を追加できる
データの場所選んだリージョンの地域内で保存・処理する。
オブジェクト名(インデックス名など)はテレメトリに出るので、機密情報を入れない
ログリソース ログにクエリの文字列は入るが、ユーザーの ID は記録されない

公式ドキュメント:Azure AI 検索 のデータ、プライバシー、組み込み保護 | Microsoft Learn

認証:API キーとロール

AI 検索の認証は、API キーと Microsoft Entra ID のロールの 2 つ。
キーは作成時の既定だが最も安全ではなく、ロールベースのアクセスに置き換えることが勧められている。

API アクセス制御の 3 つの設定と、実機での結果
種類できること数
管理者キーすべてのデータ操作(インデックスの作成、ドキュメントの登録、検索)2 つ(プライマリ、セカンダリ)
クエリ キードキュメントの検索だけ最大 50
検索インデックス データ閲覧者検索、ナレッジ ベースからの取得ロール
検索インデックス データ共同作成者上に加えて、ドキュメントの登録ロール
Search Service 共同作成者インデックスやインデクサーなどのオブジェクト管理、キーの取得ロール

所有者、共同作成者、Search Service 共同作成者は管理者キーを取り出せるので、データを読み書きできる。
これらのロールは信頼できるユーザーにだけ付ける。

公式ドキュメント:
キーを使用してAzure AI 検索に接続する | Microsoft Learn
ロールを使用してAzure AI 検索に接続する | Microsoft Learn

ネットワーク:受信と送信

受信は、IP ファイアウォール(選択した IP アドレス)かプライベート エンドポイントで絞る。
受信のファイアウォールは、検索サービスから外への送信には効かない。
送信(インデクサーからデータ ソース)は、マネージド ID、Storage 側の信頼されたサービスの例外、共有プライベート リンクで守る。

AI 検索のネットワーク(受信と送信)
機能FreeBasic 以上
IP ファイアウォール✘✔
プライベート エンドポイント(受信)✘✔
マネージド ID(インデクサーの送信)✘✔
カスタマー マネージド キー✘✔
共有プライベート リンク(スキルセットのないインデクサー)✘✔

Free はサブスクリプションに 1 つだけ作れ、ほかの顧客と共有のインフラで動く。
長く使わないと削除されることがある。
サーバーレス開発者(プレビュー)は、プライベート エンドポイントと IP ファイアウォールに対応している。

公式ドキュメント:
Azure AI 検索のネットワーク アクセスとファイアウォール規則を構成する | Microsoft Learn
Azure AI 検索 に安全な接続を行うためにプライベート エンドポイントを作成する | Microsoft Learn
共有プライベート リンクを介して送信接続を行う | Microsoft Learn
Azure Storage へのインデクサー接続を信頼できるサービスとして作成する | Microsoft Learn
Azure AI 検索 のサービス制限 | Microsoft Learn

文書単位のアクセス制御:セキュリティ フィルター

RAG では、利用者が見てよい文書だけを検索結果に入れる必要がある。
組み込みの ACL を使えない場合は、文書にグループやユーザーの ID を持たせ、アプリが search.in のフィルターを付けて検索する。

セキュリティ フィルターで検索結果を絞る

この方法は、検索サービスが利用者を確かめるわけではない。
フィルターを付けるのはアプリの責任で、付け忘れると全件が見える。
ID のフィールドは retrievable を false にするが、これだけで機密情報を守れるわけではない。

公式ドキュメント:Azure AI 検索 の結果をトリミングするためのセキュリティ フィルター | Microsoft Learn

構築手順

今回の構成と実施すること

今回の構成
手順実施すること確かめること
①ポータルで AI 検索(Basic)を作る作成画面の既定値、ネットワーク、暗号化
②管理者キーとクエリ キーで、作成・登録・検索をするクエリ キーでは書き込みが拒否される
③API アクセス制御を「API キー」「両方」「ロールベース」に切り替えるどの認証が通るか
④検索インデックス データ閲覧者を付ける検索は通り、登録は拒否される
⑤セキュリティ フィルターで検索するグループごとに返る文書が変わる
⑥IP ファイアウォールを設定する許可していない IP は API もポータルも拒否される
⑦マネージド ID で、閉じた Storage からインデックスを作る信頼されたサービスの例外がないと失敗する
⑧同じ構成を Bicep で作る設定が同じになること
⑨片付け何も残っていないこと

① ポータルで AI 検索を作る

Azure portal で「リソースの作成」⇒「AI Search」を選ぶ。
作成画面の既定は、価格レベルが Standard、場所が Central US、リソース グループが既存のものになっていたので、すべて選び直した。

価格レベルの選択
番号項目説明
1基本(Basic)15 GB/パーティション、最大 3 レプリカ、3 パーティション。
検索ユニットのコストは月 $98.95(推定)。
Free では IP ファイアウォールなどが使えないので、今回は Basic にした
検索サービスを作成する:基本情報
番号項目説明
1リソース グループ新規作成で rg-a5-demo
2場所Japan East。Storage と同じリージョンにした
3価格レベル基本
検索サービスを作成する:ネットワーク
番号項目説明
1エンドポイントの接続 (データ)パブリックかプライベート。
プライベートにすると、プライベート エンドポイント経由だけになる。
今回はパブリックで作り、あとで IP を絞った
検索サービスを作成する:暗号化
番号項目説明
1暗号化の種類既定は Microsoft マネージド キー。
カスタマー マネージド キー(プレビュー)も選べ、「CMK 暗号化を適用する」で CMK を必須にできる
検索サービスを作成する:確認して作成
番号項目説明
1月ごとの推定コスト$98.95。作成前にここで金額を確かめる

作成は約 1 分で終わった。
作成直後の API アクセス制御は「両方」(API キーとロールの両方を受け付ける)になっていた。
公式ドキュメントでは既定はキーベースとされているが、ポータルで作ったサービスでは「両方」だった。

② API キーで作成・登録・検索する

REST API(api-version 2026-04-01)で、管理者キーとクエリ キーを使い分けて、インデックスの作成、ドキュメントの登録、検索をした。
キーは「キー」の画面や CLI(az search admin-key show、az search query-key list)で取り出せる。

$ep = 'https://srch-a5-demo-2611.search.windows.net'
$k = az search admin-key show -g rg-a5-demo --service-name srch-a5-demo-2611 --query primaryKey -o tsv
$body = @{ search = '*'; select = 'id,title'; count = $true } | ConvertTo-Json
Invoke-WebRequest -Method Post -Uri "$ep/indexes/docs-a5/docs/search?api-version=2026-04-01" -Headers @{ 'api-key' = $k; 'Content-Type' = 'application/json' } -Body $body -UseBasicParsing
操作管理者キークエリ キー
インデックスの作成201403
ドキュメントの登録(3 件)200403
検索200(3 件)200(3 件)
キーなし401401
403 {"error":{"code":"","message":"The given API key doesn't match service's internal, primary or secondary keys."}}

クエリ キーは検索専用で、登録や作成には使えない。
検索だけのアプリには、管理者キーではなくクエリ キーを渡す。

③ API アクセス制御を切り替える

「セキュリティとネットワーク」⇒「キー」の「API アクセス制御」で、3 つの設定を切り替えた。

キー:API アクセス制御(作成直後は両方)
番号項目説明
1API アクセス制御API キー、ロールベースのアクセス制御、両方の 3 つ。作成直後は「両方」
2管理者キーの管理プライマリとセカンダリ。片方ずつ再生成できる
3クエリ キーの管理検索専用のキー。追加と削除ができる
ロールベースのアクセス制御に切り替える
番号項目説明
1ロールベースのアクセス制御これを選ぶと、API キーでの要求は受け付けない
2確認「この検索サービスの API アクセス制御を更新しますか?」で「はい」を押すと、すぐに保存される
ロールベースのアクセス制御に切り替えたあと
番号項目説明
1ロールベースのアクセス制御保存すると、管理者キーとクエリ キーの欄が画面から消えた

それぞれの設定で、管理者キー、クエリ キー、Entra ID(検索インデックス データ閲覧者あり)で検索した。

API アクセス制御管理者キークエリ キーEntra ID
API キー200200403
両方200200200(ロールなしは 403)
ロールベースのアクセス制御401401200

「API キー」のときは、ロールを持っていても Entra ID の要求は 403 になった。
「ロールベースのアクセス制御」にすると、キーはどちらも 401 になった。
設定の変更は、どれも 1 分以内に効いた。

④ 検索インデックス データ閲覧者を付ける

自分に「検索インデックス データ閲覧者」を CLI で割り当てた(ポータルでのロールの割り当て手順は前回と同じ)。
割り当てから約 1 分で、Entra ID での検索が 200 になった。

$sid = az search service show -g rg-a5-demo -n srch-a5-demo-2611 --query id -o tsv
az role assignment create --assignee-object-id <オブジェクト ID> --assignee-principal-type User --role "Search Index Data Reader" --scope $sid
$t = az account get-access-token --scope https://search.azure.com/.default --query accessToken -o tsv
操作(Entra ID)結果
ロールなしで検索403
閲覧者で検索200(3 件)
閲覧者でドキュメントを登録403
閲覧者でインデックスを作成201

インデックスの作成は、公式のロールの表では閲覧者にも所有者にも許可されていない操作だが、実機(サブスクリプションの所有者+検索インデックス データ閲覧者)では 201 で作成できた。
本番では、所有者や共同作成者を広く付けないこと、ロールの組み合わせを実際に試して確かめることが大切。

⑤ セキュリティ フィルターで絞る

インデックスに group_ids(Collection(Edm.String)、filterable、retrievable は false)を持たせ、3 件の文書にそれぞれグループを付けた。
アプリが利用者のグループを search.in で渡すと、返る文書が変わった。

$body = @{ search = '*'; select = 'id,title'; filter = "group_ids/any(g: search.in(g, 'grp-all,grp-sales'))" } | ConvertTo-Json
フィルター返った文書
grp-all,grp-sales全社のお知らせ、営業部の売上目標
grp-all,grp-hr全社のお知らせ、人事部の評価資料
grp-all全社のお知らせ
なし3 件すべて

⑥ IP ファイアウォールを設定する

「セキュリティとネットワーク」⇒「ネットワーク」で、パブリック ネットワーク アクセスを変えた。

ネットワーク:変更前
番号項目説明
1パブリック ネットワーク アクセスすべてのネットワーク、選択した IP アドレス、無効の 3 つ。
作成時はすべてのネットワーク
ネットワーク:選択した IP アドレス
番号項目説明
1選択した IP アドレス許可した IP と範囲からだけ受け付ける
2クライアント IP アドレスの追加ポータルを開いている PC のパブリック IP を追加する
3例外信頼されたサービス(Azure OpenAI、Foundry Tools、Azure Machine Learning)を、IP を見ずに通す

自分の PC が許可されない状態を作るため、文書用のアドレス 203.0.113.10 だけを許可した。
ポータルでは IP を 1 つも入れないと保存できず、アドレスの欄への入力も反映されなかったので、CLI で設定した。

az search service update -g rg-a5-demo -n srch-a5-demo-2611 --ip-rules "203.0.113.10"
ネットワーク:CLI で追加した IP 規則
番号項目説明
1制限されたアドレスの範囲CLI で入れた 203.0.113.10 が表示された

約 1 分後、PC からの Entra ID の検索が 403 になった。
認証が通る要求でも、IP が許可されていなければ止まる。

403 {"error":{"code":"","message":"Request is denied as the source is not allowed by applicable rules. The service is set 'publicNetworkAccess: Enabled'. Please review all service's network security settings to ensure the client is allowed."}}
ポータルのインデックスの画面も拒否された
番号項目説明
1制限されたアクセスIP ルールを構成すると、ポータルからもインデックスやインデクサーにアクセスできなくなる。
「クライアント IP アドレスの追加」ボタンで PC の IP を許可できる
2エラー メッセージAPI と同じ 403。ポータルも PC の IP から直接接続している

「クライアント IP アドレスの追加」を押すと、約 25 秒後に API とポータルの両方が使えるようになった。

⑦ マネージド ID で、閉じた Storage からインデックスを作る

検索サービスの「ID」で、システム割り当てマネージド ID をオンにした。

システム割り当てマネージド ID
番号項目説明
1状態オンにして保存すると、オブジェクト(プリンシパル)ID が表示される

CLI で Storage(共有キー無効)を作り、検索サービスの ID に「Storage BLOB データ閲覧者」を付けて、JSON の文書を 2 つ置いた。
そのうえで、Storage のネットワークを「既定で拒否、IP なし、例外なし」にした。
データ ソースの接続文字列はキーを含まない ResourceId=<Storage のリソース ID>; にした。

Storage のネットワーク:変更前
番号項目説明
1Public network accessEnabled from selected networks(選択したネットワーク)
2ExceptionsNone(例外なし)

この状態でインデクサーを作ると、403 で作成できなかった。
ロールを付けてから 11 分待っても同じだった。

403 {"error":{"code":"","message":"Error with data source: Credentials provided in the connection string are invalid or have expired. ... Please adjust your data source definition in order to proceed."}}

Storage の「リソース設定:仮想ネットワーク、IP アドレス、例外」⇒「Manage」で、例外をオンにした。

Storage の例外:信頼された Microsoft サービス
番号項目説明
1Allow trusted Microsoft services to access this resource信頼された Microsoft サービスが、マネージド ID とロールでアクセスできるようにする

保存した直後にインデクサーを作成でき、実行すると 2 件をインデックスに入れられた。
例外を外して実行すると、同じエラーで失敗し、戻すと成功した。

インデクサーの実行履歴
番号項目説明
1実行履歴例外あり:成功(2 件)→ 例外を外す:失敗 → 例外を戻す:成功(新しい文書はないので 0 件)

同じリージョンの Storage と検索サービスの通信はプライベート IP を通るので、Storage の IP ファイアウォールでは検索サービスを許可できない。
そのため、信頼されたサービスの例外とマネージド ID を組み合わせる。

⑧ 同じ構成を Bicep で作る

ロールベースのアクセス制御だけ(API キー無効)、許可する IP だけ、システム割り当てマネージド ID の検索サービスと、既定で拒否+信頼されたサービスの例外の Storage を Bicep で作った。

Bicep:azure-bicep-samples / a5-ai-search

デプロイは約 10 分かかった。
Entra ID でのインデックスの作成と検索は通り、管理者キーでの検索は 401 だった。

⑨ 片付け

リソース グループ(rg-a5-demo、rg-a5-bicep)を削除し、リソース グループとロールの割り当てが残っていないことを確かめた。
Basic は時間単位で課金されるので、確認が終わったらすぐ消す。

実機でつまずいた点

Credentials provided in the connection string are invalid or have expired.

資格情報のエラーに見えるネットワークの拒否。やったこと、起きたこと、直し方

マネージド ID のデータ ソースでインデクサーを作ると、資格情報が無効というエラーで失敗した。
実際の原因は、Storage のネットワークが信頼されたサービスを通していないことだった。
メッセージだけを見てロールや接続文字列を疑う前に、Storage のネットワークの例外を確かめる。

推奨構成(RAG で使うとき)

項目推奨理由
認証API アクセス制御を「ロールベースのアクセス制御」にするキーは持つ人なら誰でも使え、誰が使ったか分からない
ロールアプリやエージェントのマネージド ID に検索インデックス データ閲覧者。
登録するパイプラインだけデータ共同作成者
必要最小限の権限にする
受信プライベート エンドポイントを作り、パブリック ネットワーク アクセスを無効にする。
Foundry から呼ぶなら信頼されたサービスの例外も検討
インターネットから検索サービスに届かないようにする
送信インデクサーはマネージド ID で接続し、Storage は信頼されたサービスの例外か共有プライベート リンクで許可する接続文字列にキーを置かず、データ ソースも閉じたままにする
文書単位セキュリティ フィルターか組み込みの ACL で、利用者ごとに結果を絞るRAG の回答に、見てはいけない文書が混ざるのを防ぐ
暗号化要件があればカスタマー マネージド キー鍵のローテーションや失効を自分で管理できる

注意事項

項目内容
費用Basic は 1 時間 $0.133(Japan East)。
検証が終わったらすぐ削除する
Free の制限IP ファイアウォール、プライベート エンドポイント、マネージド ID、カスタマー マネージド キーが使えない
ポータルの利用IP ファイアウォールやプライベート エンドポイントで閉じると、ポータルのインデックスなどの画面も使えなくなる。
管理用の IP を許可するか、VNet から操作する
受信と送信は別受信のファイアウォールは、インデクサーの送信には効かない。
データ ソース側で許可する
既定値の確認作成時の価格レベルと場所、作成後の API アクセス制御(今回は「両方」)を必ず確かめる
ロールの確認公式の表と実機の動きが違うことがあった。
ロールの組み合わせは実際に試して確かめる

まとめ

・AI 検索のセキュリティは、受信(キーとロール、IP、プライベート エンドポイント)と送信(マネージド ID、信頼されたサービス、共有プライベート リンク)に分けて考える。
・API アクセス制御は「ロールベースのアクセス制御」にすると、管理者キーもクエリ キーも 401 になった。
ポータルで作ると既定は「両方」だった。
・IP ファイアウォールで閉じると、API だけでなくポータルの画面も拒否された。
・閉じた Storage からのインデックス作成は、信頼されたサービスの例外とマネージド ID で通った。
エラーは資格情報の問題に見えるので注意する。

次回:Foundry のガードレールとは(AI 編 7 回目)

Foundry のガードレールとは|Prompt Shields、間接プロンプト インジェクション、ブロックリストを実機で検証
Foundry のガードレールを実機で検証。既定の DefaultV2、脱獄の検出、間接プロンプト インジェクション、カスタム ブロックリスト、Content Safety の API、RAG の文書の渡し方の注意。

コメント

タイトルとURLをコピーしました