Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Uwaga
Foundry IQ (Wyszukiwanie AI platformy Azure) udostępnia bezpośrednie interfejsy API indeksowania i zapytań, a także interfejsy API wyższego poziomu dla źródeł wiedzy i baz wiedzy do zarządzanego pobierania. Użyj portalu Azure, interfejsów API REST lub Azure SDKs, aby skonfigurować te możliwości lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.
Foundry IQ (Wyszukiwanie AI platformy Azure) pobiera zakresy zasobów kontenerów z Azure Blob Storage i filtruje wyniki zapytań na podstawie obsługiwanego dla delegowanego użytkownika uprawnienia do odczytu obiektów blob. Pozyskiwanie zakresów RBAC kontenerów i filtrowanie w czasie wykonywania zapytania są ogólnie dostępne w interfejsie API REST w wersji 2026-10-01.
Użyj indeksatora obiektów blob lub źródła wiedzy obiektu blob. Standardowe pozyskiwanie obiektów blob nie ocenia list ACL plików ani katalogów usługi ADLS. W przypadku tych uprawnień użyj konfiguracji usługi ADLS Gen2.
Zakres RBAC jest ustawiany na poziomie kontenera i rozciąga się na wszystkie bloby (dokumenty) dzięki dziedziczeniu uprawnień. Zakres RBAC jest przechwytywany podczas indeksowania w formie metadanych uprawnień. Możesz używać push API do ręcznego przekazywania i indeksowania zawartości oraz metadanych uprawnień (zobacz Uprawnienia indeksowania przy użyciu push REST API), lub wykorzystać indeksator lub zasób wiedzy w celu zautomatyzowania pozyskiwania danych. Ten artykuł koncentruje się na automatyzacji indeksowania.
Przechowywany zakres identyfikuje kontener; nie jest to skopiowana lista przypisań ról ani podmiotów zabezpieczeń. W czasie wykonywania zapytania element x-ms-query-source-authorization przenosi token delegowanego użytkownika. Usługa Foundry IQ ocenia autoryzację użytkownika względem przechowywanych zakresów niezależnie od autoryzacji płaszczyzny danych wyszukiwania aplikacji.
Ten artykuł koncentruje się na podejściach automatyzacji indeksowania opartych na tej podstawie:
obiekty blob usługi Azure Storage zabezpieczone przy użyciu kontroli dostępu opartej na rolach (Azure RBAC). Nie ma obsługi kontroli dostępu opartej na atrybutach (Azure ABAC).
Azure indeksator obiektów blob lub źródło wiedzy obiektu blob, które pobierają i przetwarzają dane i metadane, w tym filtry uprawnień. Użyj interfejsu API REST
2026-10-01, lub sprawdź równoważną obsługę zestawu SDK w dzienniku zmian pakietów.Indeks w IQ usługi Foundry zawierający pozyskane dokumenty i odpowiednie uprawnienia dostępu. Metadane uprawnień są przechowywane jako pola w indeksie.
Zapytanie korzystające z filtrów uprawnień z interfejsem API
2026-10-01REST lub zestawem SDK obsługującym ten interfejs API.
Wymagania wstępne
uwierzytelnianie i autoryzacja w Microsoft Entra ID. Usługi i aplikacje muszą znajdować się w tej samej dzierżawie. Użytkownicy mogą należeć do różnych dzierżawców, pod warunkiem że wszyscy są z "Microsoft Entra ID." Przypisania ról są używane dla każdego uwierzytelnionego połączenia.
Usługa Foundry IQ, dowolny region, ale musisz mieć warstwę rozliczaną (podstawową i wyższą) na potrzeby obsługi tożsamości zarządzanych. Usługa IQ rozwiązania Foundry musi być skonfigurowana pod kątem dostępu opartego na rolach i musi mieć tożsamość zarządzaną (system lub użytkownik).
Azure Storage, Standardowa wydajność (ogólnego przeznaczenia w wersji 2), w warstwach dostępu gorącej, chłodnej i zimnej, z dostępem RBAC kontenera.
Należy zrozumieć, jak działają indeksatory i źródła wiedzy oraz jak utworzyć indeks. W tym artykule wyjaśniono ustawienia konfiguracji źródła danych i indeksatora, ale nie udostępnia kroków tworzenia indeksu. Aby uzyskać więcej informacji na temat indeksów przeznaczonych dla filtrów uprawnień, zobacz Tworzenie indeksu z polami filtru uprawnień.
Ograniczenia
Użyj standardowego lub domyślnego analizowania dokumentów (
parameters.configuration.parsingMode: "default") albo wyodrębniania opartego na usłudze Content Understanding, jeśli jest ono obsługiwane. Każdy wygenerowany fragment musi zachować wymagane metadane uprawnień i kontekst źródłowy. Specjalne wybrane przez klienta tryby analizowania nie są obsługiwane. Zobacz Obsługiwane analizowanie i wyodrębnianie zawartości na potrzeby pozyskiwania uprawnień dla wykluczonych trybów i ustawień źródła wiedzy.Portal Azure nie obsługuje tej funkcji.
Następujące funkcje indeksatora nie są zgodne z pozyskiwaniem uprawnień z Blob Storage:
Konfigurowanie Blob Storage
Proszę sprawdzić, czy kontener obiektów blob korzysta z dostępu opartego na rolach.
Zaloguj się do portalu Azure i znajdź swoje konto magazynowe.
Rozwiń kontenery i wybierz kontener, który ma obiekty blob, które chcesz indeksować.
Wybierz pozycję Access Control (IAM) aby sprawdzić przypisania ról. Użytkownicy i grupy z czytnikiem danych obiektu blob usługi Storage lub współautorem danych obiektu blob usługi Storage mają dostęp do przeszukiwania dokumentów w indeksie po indeksie kontenera.
Autoryzacja
W przypadku wykonywania indeksatora tożsamość usługi IQ usługi Foundry musi mieć uprawnienie Czytelnik danych obiektu blob usługi Storage . Aby uzyskać więcej informacji, zobacz Połączenie z Azure Storage przy użyciu tożsamości zarządzanej.
Skonfiguruj Foundry IQ
Pamiętaj, że usługa Foundry IQ musi mieć:
Autoryzacja
W przypadku wykonywania indeksatora klient wystawiający wywołanie interfejsu API musi mieć uprawnienie Współautor usługi wyszukiwania do tworzenia obiektów, współautor danych indeksu wyszukiwania w celu przeprowadzenia importowania danych i czytelnika danych indeksu wyszukiwania w celu wykonywania zapytań dotyczących indeksu. Zobacz Connect to Foundry IQ using roles.
Konfigurowanie źródła wiedzy
Jeśli używasz źródła wiedzy, definicje w źródle wiedzy są używane do generowania kompletnego procesu indeksacji (indeksator, źródło danych i indeks). Zakres kontroli dostępu opartej na rolach jest wykrywany i automatycznie uwzględniany w wygenerowanym indeksie. Nie ma potrzeby modyfikowania żadnego z wygenerowanych obiektów, jeśli chcesz dziedziczenie uprawnień w indeksowanej zawartości.
Kluczowe kwestie dotyczące konfiguracji, które sprawiają, że działają w tym scenariuszu:
-
isADLSGen2jest ustawiona na wartość false, co oznacza, że źródłem danych jest Azure Blob Storage. -
ingestionPermissionOptionsokreślarbacScope.
# Create / Update Azure Blob Knowledge Source
###
PUT {{url}}/knowledgesources/azure-blob-ks?api-version=2026-10-01
api-key: {{key}}
Content-Type: application/json
{
"name": "azure-blob-ks",
"kind": "azureBlob",
"description": "A sample azure blob knowledge source",
"azureBlobParameters": {
"connectionString": "{{blob-connection-string}}",
"containerName": "blobcontainer",
"folderPath": null,
"isADLSGen2": false,
"ingestionParameters": {
"identity": null,
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"deploymentId": "{{embedding-deployment}}",
"modelName": "{{embedding-model}}",
"resourceUri": "{{aoai-endpoint}}",
"apiKey": "{{aoai-key}}"
}
},
"chatCompletionModel": null,
"disableImageVerbalization": true,
"ingestionSchedule": null,
"ingestionPermissionOptions": ["rbacScope"],
"contentExtractionMode": "minimal",
"aiServices": {
"uri": "{{ai-endpoint}}",
"apiKey": "{{ai-key}}"
}
}
}
}
Odwołanie:tworzenie lub aktualizowanie źródła wiedzy (interfejs API REST)
Konfigurowanie indeksowania opartego na indeksatorze
Jeśli używasz indeksatora, skonfiguruj go, źródło danych oraz indeks, aby pobrać metadane uprawnień z blobów.
Tworzenie źródła danych
Typ źródła danych musi mieć wartość
azureblob.Użyj domyślnego trybu analizowania w konfiguracji indeksatora.
Źródło danych musi mieć
indexerPermissionOptionszrbacScope.W przypadku
rbacScopeskonfiguruj łańcuch połączenia w formacie tożsamości zarządzanej.W przypadku parametrów połączenia, używając tożsamości zarządzanej przypisanej przez użytkownika, należy również określić właściwość
identity.
Przykład JSON z zarządzaną przez system tożsamością i indexerPermissionOptions:
{
"name" : "my-blob-datasource",
"type": "azureblob",
"indexerPermissionOptions": ["rbacScope"],
"credentials": {
"connectionString": "ResourceId=/subscriptions/<your subscription ID>/resourceGroups/<your resource group name>/providers/Microsoft.Storage/storageAccounts/<your storage account name>/;"
},
"container": {
"name": "<your-container-name>",
"query": "<optional-query-used-for-selecting-specific-blobs>"
}
}
Przykład schematu JSON z tożsamością zarządzaną przez użytkownika w parametry połączenia:
{
"name" : "my-blob-datasource",
"type": "azureblob",
"indexerPermissionOptions": ["rbacScope"],
"credentials": {
"connectionString": "ResourceId=/subscriptions/<your subscription ID>/resourceGroups/<your resource group name>/providers/Microsoft.Storage/storageAccounts/<your storage account name>/;"
},
"container": {
"name": "<your-container-name>",
"query": "<optional-query-used-for-selecting-specific-blobs>"
},
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-assigned-managed-identity-name}"
}
}
Tworzenie pól uprawnień w indeksie
W Foundry IQ upewnij się, że indeks zawiera definicje pól metadanych uprawnień. Metadane uprawnień można indeksować, gdy indexerPermissionOptions jest określony w definicji źródła danych.
W przypadku bezpośredniego standardowego indeksatora Blob RBAC nie potrzebujesz metadata_storage_path, aby obliczyć zakres kontenera. To wymaganie różni się od pozyskiwania informacji o uprawnieniach ADLS Gen2, które wymaga tego pola nawet w przypadku pozyskiwania wyłącznie na potrzeby RBAC. Wygenerowane potoki źródła wiedzy obiektów blob nadal zawierają ścieżkę źródłową dla ich schematu i kontekstu źródłowego. Zobacz macierz metadanych źródłowych.
Użyj następujących atrybutów dla zakresu kontroli dostępu opartej na rolach:
- Pole zakresu RBAC z wartością
rbacScopepermissionFilter. - Właściwość
permissionFilterOptionumożliwiająca filtrowanie w czasie wykonywania zapytań. - Użyj pól tekstowych dla metadanych uprawnień
- Ustaw
filterablewartość true we wszystkich polach.
Zwróć uwagę, że retrievable jest to fałsz. Można ustawić wartość true podczas programowania, aby sprawdzić, czy uprawnienia są obecne, ale pamiętaj, aby ustawić je z powrotem na wartość false przed wdrożeniem w środowisku produkcyjnym, aby tożsamości podmiotu zabezpieczeń nie są widoczne w wynikach.
Przykład schematu JSON:
{
"name": "my-blob-rbac-index",
"fields": [
{ "name": "id", "type": "Edm.String", "key": true },
{
"name": "RbacScope",
"type": "Edm.String",
"permissionFilter": "rbacScope",
"filterable": true,
"retrievable": false
}
],
"permissionFilterOption": "enabled"
}
Konfigurowanie indeksatora
Mapowania pól w indeksatorze ustawiają ścieżkę danych na pola w indeksie. Pola docelowe i miejsca docelowe, które różnią się w zależności od nazwy lub typu danych, wymagają jawnego mapowania pól. Następujące pola metadanych w Azure Blob Storage mogą wymagać mapowania pól, jeśli nazwa pola jest różna:
-
metadata_rbac_scope (
Edm.String) — zakres kontroli RBAC kontenera.
Określ fieldMappings w indeksatorze, aby skierować metadane uprawnień do pól docelowych podczas indeksowania.
Użyj pochodzącego z łącznika metadata_rbac_scope w tym obsługiwanym przepływie pozyskiwania i sprawdź, jak jego zakres kontenera pozostaje skojarzony z końcowym kluczem dokumentu i zawartością. Nie traktuj podobnie nazwanej wartości ze zwykłej zawartości ani niestandardowych metadanych jako podstawy do udzielenia dostępu. Adnotacja permissionFilter określa, w jaki sposób jest oceniana przechowywana wartość; nie jest to kontrola własności dokumentu.
Sprawdź, kto może zapisywać zawartość źródłową i kto może zmieniać klucze, mapowania i wartości uprawnień. Postępuj zgodnie z listą kontrolną tożsamości i uprawnień obiektów blob, w tym niejawnymi mapowaniami kluczy i wszystkimi projektowanymi elementami podrzędnymi. Zachowaj domyślny tryb analizowania wymagany przez ten przepływ; przykłady analizowania w formacie JSON nie oznaczają obsługi importu natywnych uprawnień obiektu blob.
Przykład schematu JSON:
{
"fieldMappings": [
{ "sourceFieldName": "metadata_rbac_scope", "targetFieldName": "RbacScope" }
]
}
Uruchamianie indeksatora
Po skonfigurowaniu indeksatora, źródła danych i indeksu uruchom indeksator, aby rozpocząć proces. Jeśli wystąpi problem z konfiguracją lub uprawnieniami, te problemy pojawią się w tym kroku.
Domyślnie indeksator jest uruchamiany natychmiast po opublikowaniu go w usłudze IQ usługi Foundry, ale jeśli konfiguracja indeksatora ma disabled wartość true, indeksator jest publikowany w stanie wyłączonym, aby można było uruchomić indeksator ręcznie.
Zalecamy uruchomić indeksator z portalu Azure, aby móc monitorować stan i komunikaty.
Przy założeniu, że indeks nie zawiera żadnych błędów, jest teraz wypełniany i można przejść do przodu za pomocą zapytań i testów.
Utrzymuj aktualne zakresy i autoryzację
Zmiany przypisania roli usługi Storage wpływają na autoryzację w czasie wykonywania zapytania, a nie na identyfikator zasobu indeksowanego kontenera. Uwzględnij propagację autoryzacji magazynu i odpowiednie pamięci podręczne po przyznaniu lub usunięciu. Ponowne indeksowanie lub ponowna synchronizacja listy ACL nie wymusza odświeżania pamięci podręcznych autoryzacji.
refreshAllAcls dotyczy pozyskiwania list ACL usługi ADLS, a nie standardowego pozyskiwania RBAC obiektów blob.
Jeśli używasz projekcji indeksów, mapuj /document/metadata_rbac_scope bezpośrednio na pole fragmentu z adnotacją rbacScope w każdym chronionym fragmencie. Zachowaj wygenerowane mapowania ścieżek źródłowych podczas korzystania ze źródła wiedzy. Poprawianie schematu lub mapowania nie powoduje wypełnienia istniejących rekordów; po skorygowaniu potoku ponownie przetwórz zawartość, której dotyczy problem.
Przetestuj dozwolonego użytkownika i użytkownika bez obsługiwanego uprawnienia kontenera, a następnie przetestuj usunięcie uprawnienia oddzielnie od indeksowania zmian. Sprawdź, czy nie ma innych obsługiwanych uprawnień przed interpretacją nieoczekiwanego wyniku. Aby zapoznać się z zagadnieniami dotyczącymi udostępniania, świeżości i czyszczenia, zobacz Synchronizowanie uprawnień.
Śledzenie usuwania
Aby skutecznie zarządzać usuwaniem obiektów blob, upewnij się, że włączono śledzenie usuwania przed uruchomieniem indeksatora po raz pierwszy. Ta funkcja umożliwia systemowi wykrywanie usuniętych obiektów blob ze źródła i usuwanie odpowiedniej zawartości z indeksu.