Używanie indeksatora usługi ADLS Gen2 do pozyskiwania metadanych uprawnień

Note

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.

usługa Azure Data Lake Storage Gen2 obsługuje dostęp poszczególnych użytkowników do katalogów i plików za pośrednictwem list kontroli dostępu (ACL) i kontroli dostępu opartej na rolach (RBAC Azure). Kontrola dostępu oparta na atrybutach (Azure ABAC) nie jest obsługiwana.

Foundry IQ (Wyszukiwanie AI platformy Azure) pozyskuje obsługiwane wpisy list ACL i zakresy RBAC kontenerów wraz z zawartością dokumentu. Filtrowanie uprawnień pozyskiwania i czasu zapytania jest ogólnie dostępne w interfejsie API 2026-10-01REST. Ten obsługiwany podzestaw nie zapewnia pełnej parzystości z każdymi zasadami autoryzacji magazynu. Jest to jedna z kilku strategii kontroli dostępu na poziomie dokumentu w usłudze Foundry IQ.

W tym artykule wyjaśniono, jak skonfigurować indeksator usługi ADLS Gen2 lub źródło wiedzy obiektu blob usługi ADLS Gen2 w celu automatycznego ściągnięcia metadanych uprawnień do indeksu wyszukiwania. Uzupełnia dane indeksu z usługi ADLS Gen2 i Utwórz źródło wiedzy obiektu blob dla usługi ADLS Gen2 z informacjami specyficznymi dla pozyskiwania uprawnień. Aby ręcznie wysyłać metadane uprawnień, zobacz Indeksowanie list ACL dokumentów przy użyciu interfejsu API wysyłania.

Diagram architektury przedstawiający przycięte zabezpieczeń rozwiązanie RAG, na którym indeksator USŁUGI ADLS Gen2 pozyska dokumenty i listy ACL i RBAC metadane uprawnień z kontenera usługi ADLS Gen2, przechowuje je w indeksie IQ rozwiązania Foundry, a orkiestrator RAG filtruje wyniki zapytań, aby każdy użytkownik pobierał tylko dokumenty, do których mają uprawnienia dostępu.

Wymagania wstępne

Ograniczenia

Nieobsługiwane niejawne blocklists

Funkcja IQ usługi Foundry nie obsługuje niejawnych blocklists: źródłowych konfiguracji listy ACL, które zapewniają szeroki dostęp za pomocą Other, przy jednoczesnym wykluczeniu nazwanych użytkowników lub grup. Nie może reprezentować tych konfiguracji jako "wszystkich z wyjątkiem tych tożsamości".

Następująca źródłowa lista ACL jest nieobsługiwaną konfiguracją, a nie zaleceniem konfiguracji. Łączy on Other uprawnienie do odczytu z nazwanymi wpisami użytkownika i grupy, które nie mają uprawnień:

user::rw-
user:22222222-2222-2222-2222-222222222222:---
group::r--
group:bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb:---
mask::r--
other::r--

W przypadku tej konfiguracji indeksator rejestruje wartość braku dostępu none zarówno w metadata_user_ids, jak i w metadata_group_ids. Żaden użytkownik ani grupa nie uzyskuje dostępu za pośrednictwem indeksowanych list ACL. Nie jest to odmowa dla całego dokumentu: niezależne obsługiwane udzielanie kontroli dostępu opartej na rolach może nadal autoryzować dostęp. Nie oznacza to, że zawartość pliku musi nie być pozyskiwana.

Aby skorygować zasady źródłowe i zaktualizować uprawnienia indeksowane:

  1. Zidentyfikuj zamierzone dozwolone i tożsamości z odmową dostępu, odpowiednie członkostwa w grupach, uprawnienia przechodzenia przez katalogi nadrzędne i niezależne granty kontroli dostępu opartej na rolach.
  2. Zastąp nieobsługiwaną niejawną konstrukcję blocklist obsługiwanymi nazwanymi użytkownikami i grupami allowlists dla tożsamości, które mają mieć dostęp. Nie usuwaj po prostu restrykcyjnych nazwanych wpisów, pozostawiając szerokie uprawnienie Other, ponieważ może to poszerzyć dostęp do źródła. Nie poszerzaj maski listy ACL ani nie dodawaj uprawnień RBAC jako obejścia.
  3. Zweryfikuj politykę źródłową przy użyciu reprezentatywnych tożsamości z dozwolonym i odrzuconym dostępem. Przejrzyj istniejące pliki i katalogi oddzielnie od domyślnych list ACL dla nowych elementów podrzędnych. Zmiana domyślnej listy ACL elementu nadrzędnego nie powoduje zaktualizowania istniejących elementów potomnych.
  4. Synchronizuj indeksowane uprawnienia. W przypadku celowego uzgadniania pełnego źródła zażądaj ponownej synchronizacji uprawnień, gdy indeksator jest w stanie bezczynności, a następnie uruchom go lub poczekaj na zaplanowane uruchomienie. Monitoruj zakończenie. Alternatywnie domyślnie włączone automatyczne odświeżanie ACL aktualizuje ACL-e podczas kwalifikujących się zwykłych uruchomień mniej więcej raz dziennie, a nie natychmiast ani przy każdym zaplanowanym uruchomieniu.
  5. Jeśli istniejące rekordy nie mają wymaganych ścieżek źródłowych lub mapowań fragmentów, popraw potok i przeprocesuj te rekordy. Ponowna synchronizacja tylko z uprawnieniami nie naprawia brakującego kontekstu źródłowego.
  6. Sprawdź dozwolone i niedozwolone wyniki wyszukiwania, w tym fragmenty, których to dotyczy. Przetestuj oddzielnie użytkownika korzystającego wyłącznie z ACL, bez alternatywnego nadania uprawnień, oraz użytkownika niezależnie autoryzowanego za pomocą RBAC. Sam pomyślny import lub odświeżenie nie stanowi dowodu, że naprawiona polityka zachowuje zamierzony dostęp.

Indeksator zgłasza ostrzeżenie, gdy napotka nieobsługiwane wykluczenia. Sprawdź historię wykonania, ostrzeżenia i błędy; nie zakładaj, że oddzielne ostrzeżenie wskazuje każdy plik, którego dotyczy. Wcześniej zindeksowane uprawnienia mogą utrzymywać się do czasu pomyślnej aktualizacji, a częściowe niepowodzenia mogą pozostawić niespójny stan aktualności. Po pomyślnym przetworzeniu brak dostępu wynikającego z list ACL w przypadku tego wzorca jest zamierzonym zachowaniem, a nie oznaką nieaktualnego indeksu. Nie wyłączaj wymuszania uprawnień ani nie używaj odczytów z podwyższonym poziomem uprawnień jako obejścia.

Obsługa modelu uprawnień

Ta sekcja porównuje funkcje kontroli dostępu na poziomie dokumentu między usługami ADLS Gen2 i Foundry IQ. Wyjaśniono w nim, które mechanizmy kontroli dostępu usługi Azure Data Lake Storage (ADLS) Gen2 są obsługiwane lub mapowane przez Foundry IQ. Pomaga to zrozumieć, jak uprawnienia są wymuszane na poziomie dokumentu.

Funkcja usługi ADLS Gen2 Opis Wspierane Notatki
RBAC Gruboziarnista kontrola dostępu na poziomie kontenera Tak Usługa Foundry IQ honoruje kontrolę dostępu opartą na rolach w celu uzyskania dostępu do wszystkich dokumentów w całym kontenerze.
ABAC Warunki oparte na atrybutach na podstawie kontroli dostępu opartej na rolach Nie Usługa Foundry IQ nie ocenia warunków abAC na potrzeby dostępu na poziomie dokumentu.
ACL Szczegółowe uprawnienia na poziomie katalogu/pliku (dokument) Tak Usługa Foundry IQ używa list ACL na poziomie dokumentu dla filtrów uprawnień.
Grupy zabezpieczeń Przypisania uprawnień oparte na grupach Tak Obsługiwane, jeśli grupy zabezpieczeń są mapowane w ACL na poziomie dokumentu.

W czasie wykonywania zapytania usługa Foundry IQ najpierw ocenia kontrolę RBAC na poziomie kontenera, a następnie sprawdza wpisy listy ACL na poziomie dokumentu. Dostęp jest udzielany, jeśli zezwala na to jakikolwiek mechanizm.

Schemat blokowy i tabela prawdy przedstawiające sposób oceniania autoryzacji przez sprawdzenie autoryzacji na poziomie kontenera przez sprawdzenie kontroli dostępu opartej na rolach na poziomie kontenera, a następnie wpisy ACL dla grup i użytkowników, udzielając dostępu, jeśli jakikolwiek mechanizm na to pozwala, i odmawia dostępu tylko wtedy, gdy wszystkie kontrole kończą się niepowodzeniem.

Informacje o hierarchicznych uprawnieniach ACL

Indeksatory i źródła wiedzy mogą pobierać przypisania ACL z określonego kontenera oraz ze wszystkich katalogów prowadzących do każdego pliku, stosując się do hierarchicznego schematu oceny dostępu ADLS Gen2. Ostateczne efektywne listy dostępu dla każdego pliku są obliczane, a różne kategorie dostępu są indeksowane w odpowiednich polach indeksu.

Na przykład w typowych scenariuszach usługi ADLS Gen2 związanych z uprawnieniami, takich jak ścieżka pliku /Oregon/Portland/Data.txt.

Operacja / Oregon/ Portland/ Data.txt
Odczytaj Data.txt --X --X --X R--

Indeksator lub źródło wiedzy zbiera listy ACL z każdego kontenera i katalogu. Następnie określa efektywny dostęp na niższych poziomach i kontynuuje, dopóki nie określi uprawnień dla każdego pliku.

/ assigned access vs Oregon/ assigned access
  => Oregon/ effective access vs Portland/ assigned access
    => Portland/ effective access vs Data.txt assigned access
      => Data.txt effective access

Konfigurowanie usługi ADLS Gen2

Indeksator lub źródło wiedzy może pobrać listy kontroli dostępu na koncie magazynowym, jeśli zostaną spełnione następujące kryteria. Aby uzyskać więcej informacji na temat przypisań ACL, zobacz ADLS Gen2 ACL przypisań.

Autoryzacja

W przypadku indeksowania tożsamość usługi Foundry IQ musi mieć uprawnienie Storage Blob Data Reader.

Jeśli testujesz lokalnie, musisz również mieć przypisanie roli 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.

Uprawnienia kontenera głównego

  1. Przypisz wszystkie zestawy Group i User (podmioty zabezpieczeń) na poziomie kontenera głównego / z uprawnieniami Read i Execute.

  2. Upewnij się, że zarówno Read jak i Execute są dodawane jako "Uprawnienia domyślne", aby automatycznie propagowały się do nowo utworzonych plików i katalogów.

Propagacja uprawnień w dół hierarchii plików

Mimo że nowe katalogi i pliki dziedziczą uprawnienia, istniejące katalogi i pliki nie dziedziczą automatycznie tych przypisań.

Użyj narzędzia ADLS Gen2, aby rekursywnie stosować listy kontroli dostępu (ACL) do propagacji przypisań w istniejącej zawartości. To narzędzie propaguje przypisania ACL kontenera głównego do wszystkich podkatalogów i plików.

Usuwanie nadmiarowych uprawnień

Po ponownym zastosowaniu list ACL przejrzyj uprawnienia dla każdego katalogu i pliku.

Usuń wszystkie zestawy Group lub User, które nie powinny mieć dostępu do określonych katalogów lub plików. Na przykład usuń User2 z folderu Portland/, a z folderu Idaho usuń Group2 i User2 z przypisań, i tak dalej.

Przykładowa struktura przydziałów ACL

Oto diagram struktury przypisywania ACL dla fikcyjnej hierarchii katalogów w dokumentacji usługi ADLS Gen2.

Diagram struktury przypisań ACL.

Aktualizowanie przypisań ACL z upływem czasu

Podczas dodawania lub modyfikowania przypisań listy ACL zastosuj je do właściwych katalogów i plików. Aby zaktualizować indeksowane uprawnienia bez ponownego przetwarzania niezmienionej zawartości, postępuj zgodnie z instrukcjami w sekcji Synchronizowanie uprawnień między indeksowaną i źródłową zawartością.

Skonfiguruj Foundry IQ

Pamiętaj, że usługa Foundry IQ musi mieć:

Autoryzacja

W przypadku indeksowania, klient wystawiający wywołanie interfejsu API musi mieć uprawnienia Współtwórcy usługi wyszukiwania do tworzenia obiektów, Współtwórcy danych indeksu wyszukiwania do importowania danych, oraz Czytelnika danych indeksu wyszukiwania do wykonywania zapytań dotyczących indeksu.

Jeśli testujesz lokalnie, musisz mieć te same przypisania ról. Aby uzyskać więcej informacji, zobacz Nawiązywanie połączenia z Foundry IQ przy użyciu ról.

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). Przypisania listy kontroli dostępu (ACL) są wykrywane i automatycznie uwzględniane 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:

  • isADLSGen2 jest ustawione na true, spełniając wymagania dotyczące źródła danych dla tego scenariusza.
  • ingestionPermissionOptions określa identyfikatory użytkowników i grup.
# 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": true,
        "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": [
                "userIds","groupIds"
                           ],
            "contentExtractionMode": "minimal",
            "aiServices": {
                "uri": "{{ai-endpoint}}",
                "apiKey": "{{ai-key}}"
            }
        }
    }
}
###

Konfigurowanie indeksowania opartego na indeksatorze

Jeśli używasz indeksatora, skonfiguruj go, źródło danych i indeks, aby pobrać metadane uprawnień z blobów danych usługi ADLS Gen2.

Tworzenie źródła danych

Ta sekcja uzupełnia sekcję Indeksowanie danych z usługi ADLS Gen2 o informacje specyficzne dla pozyskiwania informacji o uprawnieniach wraz z treścią dokumentów do indeksu Foundry IQ.

  • Typ źródła danych musi mieć wartość adlsgen2.

  • Źródło danych musi zawierać indexerPermissionOptions z userIds, groupIds i/lub rbacScope.

Przykład JSON z tożsamością zarządzaną przez system:

{
    "name" : "my-adlsgen2-acl-datasource",
    "type": "adlsgen2",
    "indexerPermissionOptions": ["userIds", "groupIds", "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-virtual-directory-name>"
    }
}

Przykład schematu JSON z tożsamością zarządzaną przez użytkownika w parametry połączenia:

{
    "name" : "my-adlsgen2-acl-datasource",
    "type": "adlsgen2",
    "indexerPermissionOptions": ["userIds", "groupIds", "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-virtual-directory-name>"
    },
    "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.

Dołącz pole o nazwie dokładnie metadata_storage_path z typem Edm.String. Zachowaj oryginalną ścieżkę źródłową bez funkcji mapowania. To pole jest wymagane do importowania uprawnień usługi ADLS Gen2, w tym konfiguracji tylko RBAC. Zakodowany klucz dokumentu, adres URL cytatu lub identyfikator nadrzędny nie zastępują tego pola.

Zalecane atrybuty schematu dla ACL (UserIds, GroupIds) i zakresu RBAC:

  • pole identyfikator użytkownika (ID) z wartością userIds permissionFilter.
  • Pole Identyfikatory grup z wartością groupIds permissionFilter.
  • Pole zakresu RBAC z wartością rbacScope permissionFilter.
  • Właściwość permissionFilterOption umożliwiająca filtrowanie w czasie wykonywania zapytań.
  • Użyj kolekcji ciągów dla identyfikatorów użytkowników i grup oraz ciągu skalarnego dla zakresu RBAC.
  • Ustaw filterable wartość 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 przed wdrożeniem w środowisku produkcyjnym przywrócić wartość false.

Poniższa kompletna minimalna definicja indeksu zawiera pola ścieżki źródłowej i uprawnień. Dodaj pola zawartości zgodnie z potrzebami.

{
  "name": "my-adlsgen2-acl-index",
  "fields": [
    { "name": "id", "type": "Edm.String", "key": true },
    { "name": "metadata_storage_path", "type": "Edm.String", "searchable": false, "filterable": true, "retrievable": true },
    { "name": "UserIds", "type": "Collection(Edm.String)", "permissionFilter": "userIds", "filterable": true, "retrievable": false },
    { "name": "GroupIds", "type": "Collection(Edm.String)", "permissionFilter": "groupIds", "filterable": true, "retrievable": false },
    { "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. W usłudze ADLS Gen2, następujące pola metadanych mogą wymagać mapowania, jeśli zmienisz nazwę pola.

  • metadata_user_ids (Collection(Edm.String)) — lista identyfikatorów użytkowników ACL.
  • metadata_group_ids (Collection(Edm.String)) — lista identyfikatorów grup ACL.
  • metadata_rbac_scope (Edm.String) — zakres kontroli RBAC kontenera.

Określ fieldMappings w indeksatorze, aby skierować metadane uprawnień do pól docelowych podczas indeksowania.

Poniższy fragment mapowania pól powinien znajdować się na najwyższym poziomie definicji indeksatora, wraz z elementem parameters.

{
  "fieldMappings": [
    { "sourceFieldName": "metadata_storage_path", "targetFieldName": "metadata_storage_path" },
    { "sourceFieldName": "metadata_user_ids", "targetFieldName": "UserIds" },
    { "sourceFieldName": "metadata_group_ids", "targetFieldName": "GroupIds" },
    { "sourceFieldName": "metadata_rbac_scope", "targetFieldName": "RbacScope" }
  ]
}

Zachowaj uprawnienia w rzutowanych fragmentach

Jeśli zestaw umiejętności używa projekcji indeksu, wypełnij indeks fragmentu za pomocą mapowań projekcji, a nie tylko mapowania pól indeksatora. Każdy fragment z możliwością wyszukiwania wymaga ścieżki źródłowej i wszystkich skonfigurowanych pól uprawnień. Mapuj pola z adnotacjami bezpośrednio z /document/metadata_user_ids, /document/metadata_group_ids i /document/metadata_rbac_scope; nie zastępuj wartości wygenerowanych przez umiejętności.

Na przykład dodaj następującą konfigurację projekcji do zestawu umiejętności, który już generuje /document/pages/*element . Indeks docelowy adls-chunks wymaga:

  • Edm.String klucz z analizatorem keyword.
  • Pole filtrowalne parent_id typu Edm.String, oddzielone od klucza.
  • Pole typu Edm.String, które można przeszukiwać chunk.
  • Wyświetlone wcześniej pola ścieżki i uprawnień z wartością permissionFilterOption ustawioną na enabled.
{
  "indexProjections": {
    "selectors": [
      {
        "targetIndexName": "adls-chunks",
        "parentKeyFieldName": "parent_id",
        "sourceContext": "/document/pages/*",
        "mappings": [
          { "name": "chunk", "source": "/document/pages/*" },
          { "name": "metadata_storage_path", "source": "/document/metadata_storage_path" },
          { "name": "UserIds", "source": "/document/metadata_user_ids" },
          { "name": "GroupIds", "source": "/document/metadata_group_ids" },
          { "name": "RbacScope", "source": "/document/metadata_rbac_scope" }
        ]
      }
    ],
    "parameters": {
      "projectionMode": "skipIndexingParentDocuments"
    }
  }
}

Nie mapuj wygenerowanego klucza fragmentu ani parent_id samodzielnie. Zachowaj możliwość filtrowania pola klucza nadrzędnego, aby przetwarzanie samych uprawnień mogło znaleźć istniejące fragmenty. Jeśli indeksujesz również dokumenty nadrzędne, wypełnij pola ścieżki i uprawnień oddzielnie.

Dodawanie pól lub mapowań nie powoduje wypełniania istniejących rekordów. Po skorygowaniu schematu, mapowań indeksatora i projekcji zresetuj i uruchom indeksator, aby ponownie wypełniać istniejące dokumenty i fragmenty. To ponownie przetwarza zawartość i wzbogacanie; Ponowne synchronizowanie tylko z uprawnieniami nie jest zamiennikiem brakującego kontekstu źródłowego.

Zalecenia i najlepsze rozwiązania

  • Przed utworzeniem folderów należy dokładnie zaplanować strukturę folderów usługi ADLS Gen2.

  • Organizuj tożsamości w grupy i używaj grup, jeśli to możliwe, zamiast udzielać dostępu bezpośrednio poszczególnym użytkownikom. Ciągłe dodawanie poszczególnych użytkowników zamiast stosowania grup zwiększa liczbę wpisów kontroli dostępu, które muszą być śledzone i oceniane. Nieprzestrzeganie tej najlepszej praktyki może prowadzić do częstszej aktualizacji metadanych zabezpieczeń wymaganych w indeksie, ponieważ zmieniają się te metadane, co powoduje zwiększone opóźnienia i nieefektywność w procesie odświeżania.

Synchronizowanie uprawnień między indeksowaną i źródłową zawartością

Indeks przechowuje obowiązujące listy ACL użytkowników i grup oraz zakresy zasobów kontenera. Nie przechowuje kopii przypisań ról Storage. Użyj ścieżki odświeżania odpowiadającej zmianie:

Zmiana Odśwież ścieżkę
Początkowe pozyskiwanie, nowe pliki lub zmieniona zawartość Normalne indeksowanie indeksuje zawartość i obsługiwane metadane uprawnień razem.
Tylko listy ACL dla pliku lub katalogu usługi ADLS Domyślnie włączone odświeżanie refreshAllAcls odświeża skądinąd niezmienione pliki podczas odpowiednich standardowych uruchomień, mniej więcej codziennie.
Pełne uzgadnianie ACL źródła na żądanie Zażądaj ponownej synchronizacji uprawnień, a następnie uruchom indeksator lub poczekaj na jego harmonogram i sprawdź ukończenie.
Przypisania ról RBAC magazynu Autoryzacja w czasie wykonywania zapytania ocenia dostęp delegowanego użytkownika do zapisanych zakresów kontenerów. Obowiązuje propagacja pamięci masowej i pamięci podręczne autoryzacji; ponowna synchronizacja listy ACL nie wymusza odświeżania tych pamięci podręcznych.
Brakujące pola lub mapowania w istniejących rekordach Popraw pipeline, a następnie zresetuj i przeprocesuj istniejące rekordy, w tym projektowane fragmenty.
Przenoszenie, zmienianie nazw lub usuwanie Użyj tożsamości specyficznej dla łącznika i śledzenia usuwania. Odświeżanie uprawnień nie czyści nieaktualnych kluczy ani osieroconych fragmentów.

Automatyczne odświeżanie listy ACL

refreshAllAcls to ustawienie indeksatora w obszarze parameters.configuration, dostępne w interfejsie REST API 2026-10-01. Wartość domyślna to true; pomiń ją, aby użyć wartości domyślnej. Aby go wyłączyć, podczas aktualizowania indeksatora ustaw wartość parameters.configuration.refreshAllAcls na false.

Automatyczne przeszukiwanie dotyczy tylko źródeł danych usługi ADLS Gen2, które pozyskują listy ACL użytkowników lub grup. Nie jest to okresowy mechanizm odświeżania RBAC dla standardowego pozyskiwania obiektów blob lub pozyskiwania danych ADLS wyłącznie przy użyciu RBAC. Zaplanuj lub ręcznie uruchom indeksator: ustawienie samo nie uruchamia przebiegów.

W przypadku kwalifikujących się przebiegów normalnych indeksator odświeża listy ACL dla niezmienionych plików w mniej więcej dziennym tempie. Nie jest on przeszukiwany przy każdym zaplanowanym przebiegu, a przebiegi reset-docs i resync nie są normalnymi przebiegami. Ta kadencja nie jest umową SLA świeżości ani gwarancją natychmiastowego cofnięcia.

Elementy tylko z aktualizacjami uprawnień aktualizują pola uprawnień bez wyodrębniania zawartości, uruchamiania skilli lub ponownego generowania embeddingów. Zmieniona zawartość w tym samym normalnym przebiegu może nadal przechodzić wyodrębnianie i wzbogacanie. Istniejące projektowane fragmenty otrzymują aktualizacje uprawnień za pomocą autorytatywnych mapowań projekcji.

Jeśli wyłączysz automatyczne odświeżanie, zmiany listy ACL mogą pozostać nieaktualne do momentu jawnej ponownej synchronizacji lub ponownego przetwarzania zawartości objętej zmianami. Aby przeprowadzić pełne uzgadnianie list ACL dla źródła bez czekania na automatyczny przebieg, postępuj zgodnie z instrukcjami Dotyczącymi ponownej synchronizacji i uruchamiania indeksatorów. Użyj funkcji reset-docs (wersja zapoznawcza) tylko wtedy, gdy potrzebujesz ukierunkowanego ponownego przetwarzania treści.

Monitorowanie i weryfikowanie synchronizacji

Użyj opcji Pobierz stan indeksatora , aby sprawdzić czas wykonywania, stan, liczbę elementów, ostrzeżenia i błędy. Samo pomyślne wykonanie standardowego przebiegu zawartości nie dowodzi, że wystąpiło automatyczne przeszukanie list ACL. Akceptacja żądania nie oznacza również ukończenia ponownej synchronizacji.

Po awarii lub anulowaniu niektóre rekordy mogą mieć nowsze uprawnienia niż inne. Rozwiąż błędy, ponów próbę obsługiwanej operacji odświeżania oraz reprezentatywnych dokumentów i fragmentów przed traktowaniem korpusu zgodnie z uzgodnieniami. Rejestruj identyfikatory żądań i czasy wykonywania na potrzeby rozwiązywania problemów; nie interpretuj liczby elementów jako sygnatury czasowej uprawnień dla całego korpusu.

Sprawdź zarówno dozwolonych użytkowników, jak i użytkowników bez dostępu po zmianie listy ACL pliku, przyznaniu/odebraniu uprawnień grupie oraz zmianie przechodzenia przez katalogi nadrzędne. W przypadku mieszanego przetwarzania ACL/RBAC przetestuj cofnięcie uprawnień ACL z użytkownikiem, który nie ma alternatywnego obsługiwanego przypisania RBAC. Niezależne przyznanie nadal może autoryzować dostęp. Testy kontroli dostępu opartej na rolach są przyznawane i usuwane oddzielnie, co pozwala na propagację autoryzacji i pamięci podręczne. Zobacz kroki weryfikacji samouczka.

Śledzenie usuwania

Aby efektywnie zarządzać usuwaniem obiektów blob, upewnij się, że śledzenie usuwania jest włączone przed pierwszym uruchomieniem indeksatora. Ta funkcja umożliwia systemowi wykrywanie usuniętych obiektów blob w Twoim źródle i usuwanie ich z indeksu.