附註
Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。
網路安全邊界是圍繞你部署在虛擬網路外部的平台即服務(PaaS)資源的邏輯網路邊界。 它建立一個邊界,用來控制對 Foundry IQ(Azure AI 搜尋服務)、Azure 儲存體 以及 Microsoft Foundry Models 中 Azure OpenAI 等資源的公共網路存取。
本文說明如何將 Foundry IQ 服務加入網路安全邊界,以控制對您的 Foundry IQ 服務的網路存取。 藉由加入網路安全界限,您可以:
- 將所有對 Foundry IQ 服務的存取權,與同一範圍內的其他 Azure 資源一同記錄。
- 阻擋任何從 Foundry IQ 服務外洩到邊界外其他服務的資料。
- 利用網路安全邊界的入站與出站存取功能,允許存取您的 Foundry IQ 服務。
您可以如本文所述,將 Foundry IQ 服務新增至 Azure 入口網站的網路安全邊界。 或者,您也可以使用 搜尋管理 REST API 來檢視並同步設定設定。
先決條件
現有的網路安全界限。 您可以 建立一個,並將其與您的 Foundry IQ 服務關聯。
Foundry IQ 可在任何區域的支援專用層級或無伺服器層級上使用。
Azure 角色指派:界限 (或其資源群組或訂用帳戶) 上的 Network Security Perimeter Contributor,用於建立和管理界限、設定檔、存取規則和關聯。 在 Foundry IQ 服務上具有 搜尋服務參與者(或 參與者)角色,以將其與安全性周界建立關聯。 欲了解更多資訊,請參閱 「什麼是網路安全邊界?」。
如果您計畫使用索引器,請將 Foundry IQ 服務設定為 系統指派或使用者指派的受控識別,並在每個資料來源上為該識別指派適當的資料平面角色。
局限性
網路安全邊界控制公用端點的存取。 它不是外向的共享 private link,也無法在 S3 HD 或 Serverless 上啟用共享 private links。 對 Search 的入站私有端點是一個獨立控制項。 請參閱 代理式擷取的網路安全性。
支援的索引子資料來源目前僅限於 Azure Blob 儲存體、Azure Cosmos DB for NoSQL 和 Azure SQL 資料庫。
索引子連線到 Azure PaaS 以進行資料擷取,是主要的界限內使用案例。 對於其他流量, 請設定進出規則。 如需了解對 Microsoft Foundry 資源的輸出呼叫,請參閱 Microsoft Foundry 資源的輸出存取。 共享私有連結 是特定資源類型的替代方案。
對 Microsoft Foundry 資源的外撥存取
網路安全邊界可規範您的 Foundry IQ 服務與 Microsoft Foundry 資源之間支援的外撥通話。 周邊存取規則本身並不會建立 Private Link 路由。 檢視呼叫該資源的每個工作負載的需求:
所有需要使用 Foundry 資源的技能,例如 Azure OpenAI 嵌入技能、GenAI 提示技能、內容理解技能,以及其他用於 AI 豐富與計費的 Foundry 資源技能。
在 整合式向量化 期間於查詢時使用的 Azure OpenAI 向量化工具。
從知識代理程式到 Foundry 模型部署的代理式擷取呼叫
設定周界存取的方法如下:
將您的 Foundry IQ 服務與 Foundry 資源加入同一個網路安全邊界,或允許彼此間通訊的邊界。
如果兩個資源位於相同邊界,且 Foundry IQ 服務透過管理身份驗證 Foundry 資源,則無需新增外發規則。 邊界內流量是隱含允許的。 如果資源位於不同的邊界,或 Foundry IQ 服務使用 API 金鑰進行驗證,請在與您的 Foundry IQ 服務相關聯的周邊上新增一個針對 Foundry 資源主機名稱的外寄 FQDN 存取規則。 如需 Foundry 端設定的相關指引,請參閱 將 Microsoft Foundry 新增至網路安全界限。
驗證存取權分為兩個階段:
在界限處於學習模式時,執行會調用 Foundry 資源的技能集、向量化工具查詢或代理式擷取呼叫。 查看周邊日誌以確認預期的進入路徑。
切換到強制模式並重複執行相同的操作。 確認索引子執行歷程記錄和界限傳出允許記錄中皆顯示成功。
針對種類為 Microsoft.CognitiveServices 的 AIServices 資源,網路安全界限 (NSP) 支援已正式發行。 對於類型為 OpenAI(Azure OpenAI 服務)的資源,NSP 支援目前為公開預覽版。 有關目前的支援名單,請參見 「入門私人連結資源」。
在 符合資格的搜尋層級與工作負載中,與 Foundry 資源的共用 Private Link 是一個獨立的私有端點選項。 不要從周界成員資格推斷每個模型提供者的私有路由或備用政策。
將 Foundry IQ 服務指派至網路安全邊界
將您的 Foundry IQ 服務與周界關聯,讓所有索引與查詢流量都受周界規則所規範。
Tip
自動化方面,請使用 搜尋管理 REST API 代替入口網站。 欲了解更多資訊,請參閱 使用 REST API 管理您的 Foundry IQ 服務。
在 Azure 入口網站中,尋找訂用帳戶的網路安全界限服務。
從左窗格中選擇設定>相關資源。
選取 [新增]>[將資源與現有設定檔建立關聯]。
選取您為 [設定檔] 建立網路安全界限時所建立的設定檔。
選擇 「新增」,然後選擇您的 Foundry IQ 服務。
選取左下角的 關聯 來建立關聯。
從網路安全邊界移除 Foundry IQ 服務
若要將 Foundry IQ 服務從周邊解除關聯:
在 Azure 入口網站中瀏覽至網路安全界限資源。
從左窗格中選擇設定>相關資源。
在表格中找到您的 Foundry IQ 服務,選取列尾的三個點,然後選擇 「移除關聯」。
確認刪除。 移除關聯後,周界規則將不再適用於 Foundry IQ 服務,而 Foundry IQ 服務上的
publicNetworkAccess設定會再次控制輸入流量。
網路安全界限存取模式
網路安全界限支援相關聯資源兩種不同的存取模式:
| Mode | Description |
|---|---|
| 學習模式 | 這是預設存取模式。 在學習模式下,網路安全邊界會記錄所有若邊界處於強制模式時會被拒絕的流量,這些流量會被拒絕到 Foundry IQ 服務。 此存取模式讓網路管理員在實施存取規則執行前,能了解 Foundry IQ 服務現有的存取模式。 |
| 強制模式 | 在強制模式下,網路安全邊界會記錄並拒絕所有未被存取規則明確允許的流量。 |
網路安全邊界與 Foundry IQ 服務網路設定
此 publicNetworkAccess 設定決定 Foundry IQ 服務與網路安全邊界的關聯。
在學習模式下,
publicNetworkAccess設定控制資源的公共存取。在強制模式下,網路安全邊界規則會覆蓋設定。
publicNetworkAccess例如,如果設定為publicNetworkAccess的enabledFoundry IQ 服務在強制模式下與網路安全邊界相關聯,對 Foundry IQ 服務的存取仍受網路安全邊界存取規則控制。
變更網路安全界限存取模式
在 Azure 入口網站中瀏覽至網路安全界限資源。
從左窗格中選擇設定>相關資源。
在表格中找到您的 Foundry IQ 服務。
選取資料列結尾的三個點,然後選取 [ 變更存取模式]。
選取您想要的存取模式,然後選取 [套用]。
啟用記錄網路存取
在 Azure 入口網站中瀏覽至網路安全界限資源。
從左窗格中,選取 [監視>診斷設定]。
選取 [新增診斷設定]。
輸入任何名稱,例如
diagnostic,作為 診斷設定名稱。在 [記錄] 底下,選取 [allLogs]。 allLogs 確保您網路安全邊界內對資源的所有進出站網路存取都會被記錄。
在 [目的地詳細資料] 下面,選取 [封存至儲存體帳戶] 或 [傳送至 Log Analytics 工作區]。 儲存體帳戶必須位於與網路安全界限相同的區域中。 您可以使用現有的儲存體帳戶或建立新帳戶。 Log Analytics 工作區所在的區域可與網路安全界限所使用的區域不同。 您也可以選取任何其他適用的目的地。
選取 [儲存] 以建立診斷設定,並開始記錄網路存取。
若要確認記錄功能是否已啟用,請對 Foundry IQ 服務產生流量(例如執行查詢)。 大約 10 分鐘內,查詢 Log Analytics 中的
NSPAccessLogs表格,或檢查儲存帳號中對應的insights-logs-*容器。
讀取網路存取日誌
網路安全邊界日誌會傳送到您在 診斷設定中選擇的目的地。 最常見的目的地是 Log Analytics 工作區和儲存帳號。
Log Analytics 工作區
該 NSPAccessLogs 表包含每個對數類別的所有對數,例如 NspPublicInboundPerimeterRulesAllowed。 每個日誌都包含與日誌類別相符的網路安全邊界網路存取紀錄。
以下是 NspPublicInboundPerimeterRulesAllowed 記錄格式的範例:
| 欄位名稱 | 意義 | 範例值 |
|---|---|---|
| 結果說明 | 網路接入操作名稱。 | POST /indexes/my-index/docs/搜尋 |
| 設定檔 | Foundry IQ 服務所關聯的網路安全邊界。 | defaultProfile |
| ServiceResourceId | Foundry IQ 服務的資源 ID。 | search-service-resource-id |
| 相符的規則 | 日誌符合的規則的 JSON 描述。 | { "accessRule": "IP firewall" } |
| 來源IP位址 | 如適用,請提供入站網路存取的來源 IP。 | 192.0.2.1 |
| AccessRuleVersion | 用於執行網路存取規則的網路安全邊界存取規則版本。 | 0 |
記憶體帳戶
儲存帳號為每個日誌類別提供容器,例如 insights-logs-nsppublicinboundperimeterrulesallowed。 容器內的資料夾結構符合網路安全界限的資源識別碼,以及記錄的取得時間。 JSON 記錄檔上的每一行都包含符合記錄類別的網路安全界限網路存取記錄。
例如,輸入界限規則允許的類別記錄會使用下列格式:
{
"properties": {
"ServiceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/network-security-perimeter/providers/Microsoft.Search/searchServices/network-security-perimeter-search",
"Profile": "defaultProfile",
"MatchedRule": {
"AccessRule": "myaccessrule"
},
"Source": {
"IpAddress": "192.0.2.1"
}
}
}
為您的 Foundry IQ 服務新增存取規則
網路安全界限設定檔會指定允許或拒絕透過界限存取的規則。
在界限內,所有資源可在網路層級相互存取。 您仍然必須設定驗證和授權,但在網路層級,會接受來自界限內的連線要求。
對於網路安全界限以外的資源,您必須指定輸入和輸出存取規則。 輸入規則會指定允許輸入的連線,輸出規則會指定允許輸出的要求。
Foundry IQ 服務接受來自 Microsoft Foundry 入口網站等應用程式及任何發送索引或查詢請求的應用程式的入站請求。 Foundry IQ 服務會在基於索引器的索引與技能集執行期間發送外寄請求。 本節說明如何為 Foundry IQ 情境設定入站與出站存取規則。
附註
當 Foundry IQ 服務透過管理式身分與基於 Microsoft Entra 的角色指派進行驗證時,在同一網路安全邊界內的資源間的流量在網路層級上是隱含允許的。 如果 Foundry IQ 服務使用 API 金鑰進行驗證,邊界無法將流量識別為內部邊界,因此即使兩個資源位於同一邊界,您必須新增明確的入站與出站存取規則。
新增輸入存取規則
輸入存取規則可允許界限外的網際網路和資源與界限內的資源連線。
網路安全界限支援兩種類型的輸入存取規則:
IP 位址範圍。 IP 位址或範圍必須是無類別網域間路由選擇 (CIDR) 格式。 CIDR 標記法的範例是 192.0.2.0/24,其代表範圍從 192.0.2.0 到 192.0.2.255 的 IP。 這種類型的規則允許來自範圍內任何 IP 位址的輸入要求。
訂用帳戶。 這種規則允許透過訂閱中的任何管理身份來驗證入站存取。 該規則僅控制網路路徑;呼叫者仍需在 Foundry IQ 服務中指派 Azure RBAC 角色。
若要在 Azure 入口網站中新增輸入存取規則:
在 Azure 入口網站中瀏覽至網路安全界限資源。
從左窗格中,選取 [設定>設定檔]。
選取您搭配網路安全界限使用的設定檔。
從左窗格中,選取 設定>入口存取規則。
選取 [新增]。
輸入或選取下列值:
設定 值 規則名稱 入站存取規則的名稱,例如 MyInboundAccessRule。來源類型 有效值為 IP 位址範圍 或 訂閱。 允許的來源 如果您選取IP 地址範圍,請以 CIDR 格式輸入允許從中存取的 IP 地址範圍。 下載 Azure IP 範圍與服務標籤檔案。 如果您選取 [訂閱],請使用您要允許入站訪問的訂閱。 選取 [新增] 以建立輸入存取規則。
要驗證規則,請在測試設定檔中將關聯切換為強制模式。 確認匹配請求會出現在
NspPublicInboundPerimeterRulesAllowed日誌類別,非匹配請求則出現在分類NspPublicInboundPerimeterRulesDenied中。
新增輸出存取規則
Foundry IQ 服務會在基於索引器的索引與技能集執行期間發出外撥呼叫。 如果您的索引器資料來源、附加的 Microsoft Foundry Tool、計費技能資源,或自訂技能邏輯位於網路安全範圍之外,請建立外寄存取規則,讓您的 Foundry IQ 服務能夠建立連線。
在安全邊界內,索引器可以連接 Azure Blob 儲存體、Azure Cosmos DB for NoSQL 以及 Azure SQL Database。 如果您的索引子使用其他資料來源,您需要輸出存取規則來支援該連線。
網路安全邊界支援基於目的地的完全限定網域名稱(FQDN)的外發存取規則。 例如,您可以允許與網路安全界限相關聯的任何服務對 FQDN 的輸出存取,例如 mystorageaccount.blob.core.windows.net。
若要在 Azure 入口網站中新增輸出存取規則:
在 Azure 入口網站中瀏覽至網路安全界限資源。
從左窗格中,選取 [設定>設定檔]。
選取您搭配網路安全界限使用的設定檔。
從左窗格中,選取 設定> 輸出存取規則。
選取 [新增]。
輸入或選取下列值:
設定 值 規則名稱 出站存取規則的名稱,例如 MyOutboundAccessRule。目的地類型 保留為 FQDN。 允許的目的地 輸入您要允許輸出存取的 FQDN 的逗號分隔清單。 選取 [新增] 以建立輸出存取規則。
要驗證規則,請在測試設定檔中將關聯切換為強制模式。 確認對應的外撥請求會出現在
NspPublicOutboundPerimeterRulesAllowed日誌分類中。
透過網路安全界限測試您的連線
若要透過網路安全性周邊測試連線,您需要在具有因特網連線或 Azure VM 的本機電腦上存取網頁瀏覽器。
將您的網路安全邊界關聯變更為 強制模式 ,以開始強制執行對 Foundry IQ 服務網路存取所需的網路安全邊界要求。
選擇用戶端
對於本地電腦,請取得你的公共 IP 位址。
對於Azure虛擬機,請使用 private link或 在Azure入口網站找到 IP 位址。
為該 IP 位址建立一個入 站存取規則 ,允許存取。
在 Azure 入口網站中,開啟您的 Foundry IQ 服務並檢視其索引。
預期成功: 索引清單會載入,您可以執行測試查詢。 入站 IP 規則是有效的。
如果您看到 403 或「公共網路存取已停用」錯誤訊息:您的用戶端 IP 或 Azure 入口網站不受入站規則保護。 請查看 入站存取規則。
排除常見問題
| 癥狀 | 可能的原因 | 緩和措施 |
|---|---|---|
| 索引器切換到強制模式後失敗。 | Foundry IQ 服務識別碼在資料來源上缺少資料平面角色,或該資料來源在該範圍內不被支援。 | 確認 Foundry IQ 服務使用 受管理身份 ,且在資料來源上具有所需角色。 對於不受支援的資料來源,請新增 輸出存取規則。 |
| 對 Foundry 資源的技能、向量化工具或代理式擷取呼叫遭到拒絕。 | Foundry 資源位於不同的邊界,或者 Foundry IQ 服務使用 API 金鑰進行認證,因此通道並非隱含的。 | 將兩個資源加入同一個邊界並使用管理身份,或新增一個針對 Foundry 資源主機名稱的外發 FQDN 規則。 欲了解更多資訊,請參閱 Microsoft Foundry 資源外站存取。 |
| 診斷日誌不會出現在 Log Analytics 或 Storage。 | 擷取延遲,或儲存體帳戶不在與界限相同的區域。 | 產生流量後等待最多 10 分鐘,然後查詢 NSPAccessLogs 資料表或檢查匹配的 insights-logs-* 儲存容器。 確認儲存帳戶的區域。 |
| 在強制執行後,對 Foundry IQ 服務的入口網站存取遭到拒絕。 | 你的客戶端 IP 不受任何入站規則保護。 | 為你的客戶端 IP 新增一個入 站存取規則 ,或在完成設定時回到學習模式。 |
檢視和管理網路安全界限設定
使用 Network Security Perimeter Configuration REST API 來檢視並調和 Foundry IQ 服務上的周界設定。
例如,列出 Foundry IQ 服務中目前的邊界設定:
az rest --method get \
--url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Search/searchServices/<search-service-name>/networkSecurityPerimeterConfigurations?api-version=2026-11-01"
若配置與周邊不同步,觸發調和:
az rest --method post \
--url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Search/searchServices/<search-service-name>/networkSecurityPerimeterConfigurations/<association-name>/reconcile?api-version=2026-11-01"
請使用最新穩定版的搜尋管理 REST API。 欲了解更多資訊,請參閱 使用 REST API 管理您的 Foundry IQ 服務。