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.
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 funkcje lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.
Ważna
Funkcje lub możliwości oznaczone (wersja zapoznawcza) w tym artykule znajdują się w publicznej wersji zapoznawczej i podlegają dodatkowym warunkom użytkowania Microsoft Azure w wersji zapoznawczej. Aby uzyskać warunki wersji zapoznawczej specyficzne dla Foundry IQ (Wyszukiwanie AI platformy Azure), zobacz Funkcje wersji zapoznawczej.
Pozyskiwanie list ACL i filtrowanie uprawnień w czasie wykonywania zapytania w usłudze SharePoint, listy ACL/RBAC usługi ADLS Gen2 oraz standardowy model RBAC kontenera obiektów blob są ogólnie dostępne za pomocą interfejsu API REST płaszczyzny danych 2026-10-01. Pozyskiwanie ACL metodą push jest również ogólnie dostępne. Microsoft Purview wymuszanie etykiet poufności pozostaje w wersji zapoznawczej.
Usługa Foundry IQ (Wyszukiwanie AI platformy Azure) obsługuje kontrolę dostępu na poziomie dokumentu, umożliwiając organizacjom wymuszanie precyzyjnych uprawnień na poziomie dokumentu, od pozyskiwania danych przez wykonywanie zapytań. Ta funkcja jest niezbędna do tworzenia bezpiecznych systemów agentowych sztucznej inteligencji, uzasadniania danych, ekstrakcji rozszerzonej generacji (RAG) oraz rozwiązań do wyszukiwania w przedsiębiorstwie, które wymagają kontroli autoryzacji na poziomie dokumentu.
Metody kontroli dostępu na poziomie dokumentu
Usługa Foundry IQ udostępnia pięć podstawowych metod wymuszania uprawnień na poziomie dokumentu, z których każdy jest odpowiedni dla różnych źródeł danych i modeli tożsamości.
| Podejście | Opis |
|---|---|
| Filtry zabezpieczeń | Porównanie ciągów. Aplikacja przekazuje tożsamość użytkownika lub grupy jako ciąg, który wypełnia filtr zapytania, z wyłączeniem wszystkich dokumentów, które nie są zgodne z ciągiem. Filtry zabezpieczeń to technika osiągnięcia kontroli dostępu na poziomie dokumentu. Takie podejście nie jest powiązane z interfejsem API, więc można użyć dowolnej wersji lub pakietu. |
| Zakresy ACL typu POSIX / RBAC | Tożsamość Microsoft Entra użytkownika delegowanego jest oceniana względem obsługiwanych metadanych uprawnień. Lista ACL usługi ADLS Gen2 i pozyskiwanie zakresów RBAC kontenera kontenera obiektów blob, standardowe pozyskiwanie zakresu RBAC kontenera obiektów blob i filtrowanie uprawnień zapytań są ogólnie dostępne w interfejsie API 2026-10-01REST. Pozyskiwanie ACL wypychanych przez klienta jest również ogólnie dostępne. Inne funkcje zachowują udokumentowaną dostępność; nie wszystkie zasady autoryzacji usługi Storage są obsługiwane. Aby uzyskać wskazówki dotyczące interfejsu API i zestawu SDK, zobacz Pobieranie metadanych uprawnień listy ACL. |
| Microsoft Purview etykiety poufności (wersja zapoznawcza) | Indeksator wyodrębnia etykiety poufności zdefiniowane w Microsoft Purview z obsługiwanych źródeł danych (Azure Blob Storage, ADLS Gen2, SharePoint w Microsoft 365, OneLake). Te etykiety są przechowywane jako metadane i oceniane podczas zapytań, aby wymusić dostęp użytkowników na podstawie tokenów Microsoft Entra i przypisań polityk Purview. Etykiety są również udostępniane za pośrednictwem źródeł wiedzy i odpowiedzi generowanej przez wyszukiwanie agentowe, co umożliwia agentom AI i aplikacjom czatowym korzystającym z bazy wiedzy otrzymywanie takiego samego filtrowania uwzględniającego etykiety. Takie podejście jest zgodne z autoryzacją Foundry IQ i modelem Microsoft Information Protection stosowanym w przedsiębiorstwie. |
| SharePoint w listach ACL Microsoft 365 | Indeksatory IQ foundry wyodrębniają obsługiwane metadane uprawnień i używają ich do sprawdzania dostępu w czasie zapytań za pomocą interfejsu API 2026-10-01REST. Aby zapoznać się z podzbiorem uprawnień indeksowanych, limitami grup, zachowaniem synchronizacji i konfiguracją, zobacz Używanie indeksatora SharePoint do pozyskiwania metadanych uprawnień. |
| Uprawnienia źródła usługi OneLake (wersja zapoznawcza) | Używa indeksowanych lokalizacji źródłowych i autoryzacji jednorazowej usługi OneLake, a nie kopiowanych list ACL użytkowników i grup. Zobacz Zachowywanie uprawnień usługi OneLake. |
W przypadku indeksowanych źródeł wiedzy nie można używać jednocześnie opcji ingestionPermissionOptions i assetStore. W związku z tym obsługa obrazów (wersja zapoznawcza) nie jest dostępna, gdy jest włączone natywne pozyskiwanie uprawnień na poziomie dokumentu.
Obsługiwane analizowanie i wyodrębnianie zawartości na potrzeby pozyskiwania uprawnień
Po włączeniu natywnych uprawnień na poziomie dokumentu dla SharePoint, ADLS Gen2 lub Blob Storage używaj standardowego lub domyślnego parsowania dokumentów i wyodrębniania zawartości. Zachowaj metadane uprawnień i kontekst źródła dla każdego elementu źródłowego podczas całego procesu pozyskiwania.
Możesz również użyć wyodrębniania opartego na usłudze Content Understanding, gdzie jest obsługiwane przez źródło danych i interfejs API. Skonfiguruj każdy wygenerowany fragment, aby zachować wymagane metadane uprawnień i kontekst źródłowy. Obsługiwane dzielenie na fragmenty po stronie odbiorcy nie jest tym samym co wybieranie wyspecjalizowanego trybu analizowania źródła.
W przypadku interfejsu API REST 2026-10-01 użyj ustawień zasobu, który konfigurujesz:
| Zasób | Właściwość REST | Configuration |
|---|---|---|
| SharePoint, ADLS Gen2 lub indeksator obiektów blob | parameters.configuration.parsingMode |
Użyj default do standardowego analizowania dokumentów. |
| Źródło wiedzy Blob, w tym ADLS Gen2 | azureBlobParameters.ingestionParameters.contentExtractionMode |
minimal jest domyślną opcją wyodrębniania; standard oznacza wyodrębnianie oparte na usłudze Content Understanding. Zachowaj wygenerowane uprawnienia i mapowania kontekstu źródłowego. |
| Indeksowane źródło wiedzy SharePoint | indexedSharePointParameters.ingestionParameters.contentExtractionMode |
minimal jest domyślną opcją wyodrębniania; użyj funkcji standard do wyodrębniania opartego na usłudze Content Understanding tam, gdzie jest obsługiwana. Skonfiguruj wyodrębnianie za pomocą interfejsu API źródła wiedzy, a nie przez zmianę wygenerowanych ustawień analizatora. |
Źródło contentExtractionMode wiedzy i indeksator parsingMode są różnymi ustawieniami. W szczególności minimal nie jest wyspecjalizowanym trybem analizowania zwykłego tekstu. Aby zapoznać się z definicjami REST, zobacz Indexers - Create i Knowledge Sources - Create or Update.
Inne tryby analizowania wybrane przez klienta nie są obecnie obsługiwane z uprawnieniami na poziomie dokumentu. Nie wybieraj:
- Parsowanie JSON (
json). - Analizowanie tablic JSON (
jsonArray) lub analizowanie wielu dokumentów JSON do oddzielnych rekordów. - Analizowanie JSON Lines (
jsonLines). - Analizowanie tekstu w formacie CSV lub tekstu rozdzielanego separatorami (
delimitedText). - Analizowanie tekstu zwykłego (
text). - Parsowanie specyficzne dla Markdown (
markdown). - Każdy inny tryb, który tworzy, dzieli, zmienia lub mapuje wiele rekordów logicznych z jednego elementu źródłowego bez obsługiwanego kontraktu propagacji uprawnień.
Te ograniczenia dotyczą trybów analizowania, a nie rozszerzeń plików ani formatu wyodrębnionej zawartości. Na przykład plik w postaci zwykłego tekstu przetworzony za pomocą default analizy nie korzysta z trybu wyspecjalizowanego text . Dane wyjściowe w formacie Markdown z usługi Content Understanding nie są trybem analizy źródłowej markdown.
Aby uzyskać mapowania fragmentów i wymagane metadane źródłowe, zobacz wskazówki dotyczące uprawnień SharePoint, wskazówki dotyczące uprawnień usługi ADLS Gen2 i wskazówki dotyczące zakresu RBAC obiektów blob.
Ufaj źródle uprawnień indeksowanych
Filtrowanie uprawnień w czasie zapytania ocenia metadane uprawnień skojarzone z indeksowanym rekordem. Oddzielnie projekt procesu importu danych musi ustalić, kto ma uprawnienia do wybrania tożsamości tego rekordu oraz do przyznawania dostępu do jego zawartości. Klucz dokumentu wybiera rekord aktualizacji lub scalania; nie jest granicą autoryzacji.
W przypadku pozyskiwania przez łączniki natywne postępuj zgodnie z konfiguracją specyficzną dla źródła i zachowaj skojarzenie między zawartością źródłową, tożsamością i uprawnieniami pochodnymi od łącznika. W przypadku pozyskiwania wypychanego zarządzanego przez klienta autoryzowany wydawca dostarcza wartości klucza i uprawnień. Filtrowanie ciągów znaków zarządzane przez aplikację również zależy od uwierzytelniania aplikacji i sposobu tworzenia filtra przez aplikację.
Nie traktuj zwykłych zawartości o niższym zaufaniu jako autoryzowanych metadanych uprawnień tylko dlatego, że nazwa pola się zgadza. Przejrzyj autorów źródeł, administratorów pozyskiwania danych, mapowania niejawne i jawne, dane wyjściowe wzbogacania i projektowane elementy podrzędne. W przypadku pozyskiwania obiektów blob użyj listy kontrolnej dotyczącej tożsamości i konfiguracji uprawnień. Ta recenzja jest odrębna od aktualności uprawnień.
Wybieranie podejścia
Użyj poniższych kryteriów, aby zidentyfikować podejście, które najlepiej pasuje do źródła danych, modelu tożsamości i wymagań dotyczących zgodności.
| Scenario | Zalecane podejście | Dlaczego |
|---|---|---|
| Niestandardowy system tożsamości lub struktura zabezpieczeń firmy Microsoft. | Filtry zabezpieczeń | Niezależny od interfejsu API, ogólnie dostępny i oparty na prostym dopasowaniu ciągów. |
| Microsoft Entra uprawnienia użytkowników i grup wypychane do indeksu, indeksowane listy ACL usługi ADLS Gen2 lub indeksowane zakresy RBAC kontenera z usługi ADLS Gen2 i Azure Blob Storage. | Zakresy ACL typu POSIX / RBAC | Używa natywnych metadanych uprawnień do egzekwowania podczas wykonywania zapytania. Schemat, indeksowanie wypychane i wymuszanie zapytań są ogólnie dostępne w interfejsie API 2026-10-01REST; pozyskiwanie specyficzne dla źródła ma oddzielne wymagania dotyczące dostępności. |
| Zawartość przedsiębiorstwa podlega już zasadom ochrony informacji Microsoft Purview. | Etykiety poufności Microsoft Purview | Ponownie używa scentralizowanych przypisań klasyfikacji i zasad w usłudze Foundry IQ. |
| Zawartość źródłowa z SharePoint w Microsoft 365 (biblioteki, listy, strony witryny ASPX). | SharePoint w listach ACL Microsoft 365 | Ocenia obsługiwany podzbiór uprawnień zsynchronizowany do usługi Search. W przypadku pobierania w czasie żądania po stronie źródłowej lub przesyłania aktualizacji sterowanego przez klienta porównaj metody pobierania SharePoint i świeżość. |
Wzorzec ograniczania dostępu za pomocą filtrów
W przypadku scenariuszy, w których integracja natywnych zakresów ACL/RBAC nie jest opłacalna, użyj filtrów ciągów zabezpieczeń, aby przyciąć wyniki na podstawie kryteriów wykluczania. Wzorzec zawiera następujące składniki:
- Aby przechowywać tożsamości użytkowników lub grup, utwórz pole ciągu w indeksie.
- Załaduj indeks przy użyciu dokumentów źródłowych, które zawierają skojarzone ACL.
- Uwzględnij wyrażenie filtrujące w logice zapytania w celu dopasowania ciągu.
- Podczas kwerendy uzyskaj tożsamość podmiotu wywołującego.
- Przekaż tożsamość obiektu wywołującego jako ciąg filtru.
- Wyniki są przycinane, aby wykluczyć wszystkie dopasowania, które nie zawierają ciągu tożsamości użytkownika lub grupy.
Możesz użyć interfejsów API modelu push lub pull. Ponieważ takie podejście jest niezależne od interfejsu API, wystarczy potwierdzić, że indeks i zapytanie mają prawidłowe ciągi (tożsamości) dla kroku filtrowania.
Takie podejście jest przydatne w przypadku systemów z niestandardowymi modelami dostępu lub strukturami zabezpieczeń innych niż Microsoft. Aby uzyskać więcej informacji na temat tego podejścia, zobacz Filtry zabezpieczeń dotyczące przycinania wyników w funkcji IQ rozwiązania Foundry.
Wzorzec natywnej obsługi uprawnień ACL typu POSIX i uprawnień zakresu RBAC
Natywne filtrowanie uprawnień używa indeksowanych identyfikatorów obiektów użytkowników i grup Microsoft Entra oraz zakresów kontroli dostępu opartej na rolach kontenera magazynu.
usługa Azure Data Lake Storage (ADLS) Gen2 obsługuje listy ACL w katalogach i plikach. Użyj indeksatora usługi ADLS Gen2 lub źródła wiedzy obiektu blob skonfigurowanego dla usługi ADLS Gen2 w celu pozyskiwania obsługiwanych list ACL i zakresów RBAC kontenerów za pomocą interfejsu API 2026-10-01REST. W przypadku standardowych Blob Storage indeksator Blob lub źródło wiedzy pozyskuje zakresy kontroli dostępu opartej na rolach kontenera, a nie listy ACL dla plików.
W przypadku treści zabezpieczonych mechanizmem ACL używaj dostępu grupowego zamiast indywidualnego dostępu użytkowników, aby ułatwić zarządzanie. Wzorzec zawiera następujące składniki:
- Zacznij od dokumentów lub plików, które mają przypisania listy ACL.
- Włącz filtry uprawnień w indeksie.
- Dodaj filtr uprawnień do odpowiedniego pola ciągu lub kolekcji ciągów w indeksie.
- Załaduj indeks z dokumentami źródłowymi, które mają skojarzone listy kontroli dostępu.
- Wykonaj zapytanie względem indeksu, dodając
x-ms-query-source-authorizationw nagłówku żądania.
Natywne zapytania filtrowane według uprawnień odróżniają podmiot wywołujący od użytkownika, którego uprawnienia do dokumentu są oceniane:
-
Authorizationprzenosi token elementu wywołującego dla mechanizmu RBAC usługi Search. Nazwana jednostka usługi aplikacji lub tożsamość zarządzana może wywoływać usługę Search z odpowiednią rolą, taką jak Search Index Data Reader lub Search Index Data Contributor. -
x-ms-query-source-authorizationprzekazuje token delegowanego użytkownika na potrzeby oceny uprawnień dostępu do dokumentu. Grupy są metadanymi uprawnień, a nie tożsamościami zawierającymi token.
Aplikacja, która może wywoływać Search, niekoniecznie jest obsługiwana jako podmiot uprawnień do dokumentów. Na przykład autoryzowana aplikacja może używać odczytu z podwyższonym poziomem uprawnień w indeksie spoza usługi Purview, ale obejście administracyjne nie ocenia członkostwa w listach ACL aplikacji. Aby uzyskać informacje o obsługiwanych przepływach tokenów i limitach specyficznych dla operacji, zobacz Granice tokenów aplikacji.
Użyj przepływu pracy interfejsu API push, aby załadować zawartość i natywne metadane uprawnień.
Użyj interfejsów API modelu pull (indeksatora) dla list ACL i zakresów kontenerów usługi ADLS Gen2 lub standardowych zakresów kontenerów obiektów blob z interfejsem API REST 2026-10-01.
Pobieranie metadanych uprawnień listy ACL podczas importowania
Sposób pobierania uprawnień ACL różni się w zależności od tego, czy przesyłasz zestaw danych dokumentów, czy też używasz indeksatora usługi ADLS Gen2.
W przypadku importowania uprawnień usługi ADLS Gen2 i standardowego obiektu blob użyj interfejsu API REST 2026-10-01. Sprawdź dzienniki zmian zestawu SDK pod kątem obsługi tego interfejsu API i wymaganych właściwości. Dostępność ogólnie dostępnej wersji REST nie oznacza gotowości pakietu SDK.
Import ACL wypychania jest ogólnie dostępny.
Przewodnik dotyczący wypychania obejmuje 2026-10-01 przepływ pracy REST. Sprawdź dzienniki zmian zestawu SDK pod kątem obsługi filtrów uprawnień i pozyskiwania list ACL/RBAC:
-
Interfejs API
2026-10-01REST używany w przykładach. - Dziennik zmian Azure SDK for Python.
- Dziennik zmian Azure SDK dla platformy .NET.
- Dziennik zmian Azure SDK for Java.
W przypadku podejścia modelu wypychania:
- Utwórz schemat indeksu z filtrami uprawnień przy użyciu interfejsu API REST lub pakietu Azure SDK obsługującego wymagane właściwości.
- Rozważ użycie zestawu SDK Microsoft Graph w celu uzyskania tożsamości grup lub użytkowników.
- Użyj interfejsu API Index lub równoważnego interfejsu API Azure SDK, aby wypchnąć dokumenty i skojarzone z nimi metadane uprawnień do indeksu wyszukiwania.
W przypadku modelu ściągania indeksatora ADLS Gen2 lub obiektu blob źródła wiedzy (ADLS Gen2):
- Sprawdź, czy pliki w katalogu są zabezpieczone przy użyciu modelu kontroli dostępu usługi ADLS Gen2.
- Użyj Indexers - Create (REST API), Knowledge Sources - Create (REST API) lub równoważnego interfejsu API zestawu Azure SDK, aby utworzyć indeksator, indeks i źródło danych.
Jeśli zestaw umiejętności fragmentuje dokumenty usługi ADLS lub obiekty blob, wypełnij uprawnienia na każdym chronionym fragmencie za pośrednictwem projekcji indeksu, nie tylko mapowania pól indeksatora.
Metadane źródłowe na potrzeby pozyskiwania uprawnień
Kontekst źródłowy i nadania uprawnień służą różnym celom. Zachowaj ścieżki źródłowe jako surowe wartości, a nie jako zakodowane klucze, adresy URL cytowań ani wygenerowane identyfikatory nadrzędne.
| Źródło i scenariusz | Metadane i przeznaczenie źródła | Mapowanie i dostępność |
|---|---|---|
| ACL-e nazwanych użytkowników/grup usługi ADLS | Wymagane metadata_storage_path (Edm.String) identyfikują źródło.
metadata_user_ids i metadata_group_ids zawierają obowiązujące listy ACL. |
Mapuj listy ACL na pola Collection(Edm.String) opatrzone adnotacjami userIds i groupIds. Zachowaj ścieżkę w rekordach i fragmentach. Ogólna dostępność w 2026-10-01. |
| Tylko RBAC w usłudze ADLS |
metadata_storage_path jest wymagany w przypadku importowania uprawnień usługi ADLS, nawet bez pól listy ACL.
metadata_rbac_scope identyfikuje kontener. |
Zamapuj zakres na pole Edm.String oznaczone rbacScope. Wymagana ścieżka nie jest używana do kopiowania przypisań ról. Ogólna dostępność w 2026-10-01. |
| Mieszane ACL/RBAC w ADLS | Ścieżka źródłowa, efektywne listy ACL użytkownika/grupy i zakres kontenera. | Zachowaj wszystkie skonfigurowane pola w rekordach i projekcjach fragmentów. Każde niezależne obsługiwane uprawnienie może autoryzować dostęp. Ogólna dostępność w 2026-10-01. |
| RBAC dla standardowych obiektów blob |
metadata_rbac_scope identyfikuje kontener; ścieżka dla dokumentu nie jest wymagana do obliczenia tego zakresu. Wygenerowane potoki źródła wiedzy nadal zawierają element metadata_storage_path. |
Zamapuj zakres skalarny na pole opatrzone adnotacją rbacScope w dokumentach i fragmentach. Brak wnioskowania listy ACL plików usługi ADLS. Ogólna dostępność w 2026-10-01. |
| listy ACL w SharePoint |
metadata_spo_item_path udostępnia kontekst elementu; metadata_spo_site_url udostępnia kontekst witryny. Listy i strony także używają metadata_spo_site_asset_item_id. |
Skorzystaj ze wskazówek dotyczących schematu i projekcji SharePoint specyficznych dla źródła. Dostępność SharePoint i wymagania są niezależne od zakresu GA usługi Storage. |
Aby uzyskać informacje o definicjach schematu bezpośredniego, mapowaniach autorytatywnych, wygenerowanych potokach i korygowaniu istniejących rekordów, zobacz Pozyskiwanie uprawnień ADLS i pozyskiwanie zakresu RBAC obiektów blob.
W przypadku źródłowych list ACL usługi ADLS, które udzielają szerokiego dostępu z wykluczeniem nazwanych tożsamości, zobacz Nieobsługiwane niejawne uprawnienia blocklists.
Wzorzec pozyskiwania podstawowych uprawnień ACL dla SharePoint w Microsoft 365
W przypadku zawartości indeksowanej SharePoint funkcja IQ usługi Foundry może przechowywać obsługiwane uprawnienia źródła jako metadane i używać ich do filtrowania wyników zapytania. Użyj indeksatora SharePoint w Microsoft 365 z interfejsem API REST 2026-10-01 dla tej konfiguracji uprawnień lub pakietu SDK obsługującego tę funkcję.
Aby uzyskać informacje o wymaganiach dotyczących uprawnień, obsługiwanych relacjach grup, synchronizacji uprawnień i ograniczeniach, zobacz Używanie indeksatora SharePoint do pozyskiwania metadanych uprawnień.
Jeśli zestaw umiejętności dzieli dokumenty na fragmenty (na przykład za pomocą umiejętności Text Split na potrzeby zintegrowanego wektoryzowania), pola ACL są przenoszone z mapowań pól indeksatora do projekcji indeksu. Zobacz Wybór miejsca wypełniania pól ACL.
Wzorzec etykiet klasyfikacji poufności Microsoft Purview (wersja zapoznawcza)
Po włączeniu pozyskiwania etykiet usługa Foundry IQ wyodrębnia metadane poufności z obsługiwanych źródeł danych. Te źródła danych obejmują Azure Blob Storage, Azure Data Lake Storage Gen2 (ADLS Gen2), SharePoint w Microsoft 365 i Microsoft OneLake. Wyodrębnione etykiety są przechowywane w indeksie wraz z zawartością dokumentu.
W czasie wykonywania zapytania usługa Foundry IQ sprawdza etykietę poufności każdego dokumentu, token Microsoft Entra użytkownika i zasady usługi Purview organizacji w celu określenia dostępu. System zwraca dokumenty tylko wtedy, gdy tożsamość użytkownika i uprawnienia oparte na etykietach zezwalają na dostęp zgodnie ze skonfigurowanymi zasadami usługi Purview.
Ten wzorzec zawiera następujące składniki:
- Skonfiguruj indeks, źródło danych i indeksator (do celów planowania) przy użyciu interfejsu API
2026-11-01-previewREST lub zestawu SDK w wersji zapoznawczej obsługującego pozyskiwanie etykiet usługi Purview. - Włącz tożsamość zarządzaną przypisaną przez system w usłudze Foundry IQ. Tożsamości zarządzane przypisane przez użytkownika nie są obsługiwane na potrzeby wyodrębniania etykiet Purview — podwyższone uprawnienia Purview musi mieć własna tożsamość usługi. Następnie administrator globalny dzierżawy lub administrator ról uprzywilejowanych przyznać wymagany dostęp, aby umożliwić usłudze Foundry IQ uwierzytelnianie za pomocą Microsoft Purview i wyodrębnianie metadanych etykiet.
- Zastosuj etykiety poufności do dokumentów przed indeksowaniem, aby system mógł je rozpoznać i zachować podczas importowania.
- W czasie zapytania dołącz prawidłowy token Microsoft Entra za pośrednictwem nagłówka
x-ms-query-source-authorizationdo każdego żądania zapytania. Usługa Foundry IQ ocenia token i skojarzone metadane etykiety w celu wymuszania kontroli dostępu opartej na etykietach.
Wymuszanie etykiet poufności usługi Purview jest ograniczone do scenariuszy z pojedynczą dzierżawą i wymaga uwierzytelniania opartego na mechanizmie RBAC. W wersji zapoznawczej jest obsługiwana tylko za pośrednictwem interfejsu API REST i Azure SDKs. Interfejsy API funkcji Autocomplete i Suggest nie są obecnie dostępne dla indeksów z włączoną usługą Purview.
Gdzie są wyświetlane etykiety poufności
Zanim system będzie mógł wymusić etykiety w czasie zapytania lub zwrócić je w odpowiedziach, należy najpierw zsynchronizować metadane etykiety z indeksem. Obie ścieżki zużycia opisane w tej sekcji zależą od tego kroku synchronizacji. Etykiety można synchronizować, konfigurując indeksator IQ usługi Foundry bezpośrednio w obsługiwanym źródle danych lub włączając równoważną opcję pozyskiwania podczas tworzenia źródła wiedzy. W obu przypadkach środowisko musi spełniać wymagania wstępne konfiguracji synchronizacji metadanych etykiety poufności (tożsamość zarządzana, kontrola dostępu oparta na rolach w usłudze IQ rozwiązania Foundry oraz wymagane uprawnienia Microsoft Purview i źródła danych). Aby skonfigurować indeksator od początku do końca, zobacz Używanie indeksatorów Foundry IQ do pozyskiwania etykiet poufności Microsoft Purview. W przypadku pozyskiwania danych sterowanego źródłem wiedzy ustaw ingestionPermissionOptions tak, aby uwzględniało sensitivityLabel podczas tworzenia źródła wiedzy.
Po zsynchronizowaniu etykiet dwie ścieżki zapytania używają tych samych metadanych etykiety indeksowanej. Wybierz ścieżkę zgodną ze sposobem, w jaki aplikacja wywołuje Foundry IQ:
Interfejs API zapytań bezpośrednich (
/docs/search): Dołącz token Microsoft Entra użytkownika wx-ms-query-source-authorization. Administratorzy mogą również składać żądania odczytu z podwyższonymi uprawnieniami na potrzeby dochodzeń podlegających audytowi. Informacje o konfiguracji i przykłady można znaleźć w artykule Wymuszanie etykiet poufności Microsoft Purview w czasie wykonywania zapytania.Źródła wiedzy i pobieranie agentowe (MCP): ustaw wartość
ingestionPermissionOptions, aby uwzględnićsensitivityLabelw źródle wiedzy. Operacja pobierania i narzędzie MCPknowledge_base_retrievezwracają informacje dla każdego odwołaniasensitivityLabelInfooraz na poziomie odpowiedzimetadata.responseSensitivityLabelInfo, których klienci mogą używać do wyświetlania banerów i egzekwowania zasad. Informacje dotyczące konfiguracji można znaleźć w sekcjach Tworzenie źródła wiedzy i Inspekcja metadanych etykiety poufności w odpowiedziach pobierania.
Jeśli źródło wiedzy wskazuje na fragmentowany indeks, na przykład zasilany za pomocą zintegrowanej wektoryzacji lub niestandardowej umiejętności Text Split, zestaw umiejętności musi również przypisać etykietę poufności do każdego wiersza fragmentu. Bez tej projekcji odwołania na poziomie fragmentu nie są filtrowane.
Aby uzyskać więcej informacji, zobacz Use Foundry IQ indexers to ingest Microsoft Purview sensitivity labels.
Wymuszanie uprawnień na poziomie dokumentu w czasie wykonywania zapytania
Wymuszanie wykonywania zapytań na podstawie tokenów to funkcja przekrojowa, która ma zastosowanie do zakresów ACL podobnych do POSIX i RBAC, etykiet poufności Microsoft Purview oraz wzorców list ACL programu SharePoint w Microsoft 365. Korzystając z natywnych zapytań opartych na tokenach, funkcja Foundry IQ weryfikuje token Microsoft Entra obiektu wywołującego dla każdego żądania i przycina zestawy wyników tylko do dokumentów, do których obiekt wywołujący ma uprawnienia do odczytu zgodnie z listami ACL dokumentów, o ile metadane listy ACL dokumentu są synchronizowane z indeksem.
Po dołączeniu tokenu użytkownika do żądania zapytania za pośrednictwem nagłówka x-ms-query-source-authorization Foundry IQ:
- Wyodrębnia z tokenu atrybuty użytkownika, grupy i zakresu.
- Porównuje te oświadczenia z metadanymi dotyczącymi uprawnień przechowywanymi wraz z indeksowanymi dokumentami (wpisy ACL, zakresy RBAC, przypisania etykiet usługi Purview lub listy ACL platformy SharePoint).
- Zwraca tylko dokumenty, których zsynchronizowane metadane uprawnień przyznają dostęp osobie wywołującej.
Świeżość uprawnień
Egzekwowanie podczas wykonywania zapytania używa przechowywanych metadanych uprawnień, ale świeżość zależy od typu uprawnień. Listy ACL użytkowników i grup usługi ADLS to indeksowane migawki: zmiany wyłącznie w listach ACL korzystają z domyślnie włączonego, mniej więcej codziennego automatycznego odświeżania w przypadku kwalifikujących się zwykłych uruchomień lub jawnej ponownej synchronizacji uprawnień. Zakresy RBAC kontenera identyfikują zasoby, a nie przypisania ról; autoryzacja delegowanego użytkownika jest oceniana oddzielnie w czasie zapytania z propagacją i pamięciami podręcznymi. Rozpoznawanie członkostwa w grupie ma również własne zachowanie propagacji i buforowania.
W przypadku SharePoint przetwarzanie przyrostowe obejmuje wykryte zmiany na poziomie elementu i obsługiwane zmiany uprawnień inne niż zmiany dotyczące folderu głównego, w tym niezmienione elementy podrzędne. Inne zakresy lub nieodebrane powiadomienia mogą wymagać jawnego odświeżania. Zobacz Synchronizowanie uprawnień między zawartością indeksowaną i źródłową, aby zapoznać się z tabelą scenariuszy i ograniczeniami czasowymi.
Odświeżanie uprawnień nie zapewnia natychmiastowego odwołania ani umowy SLA dotyczącej aktualności całego korpusu. Aby uzyskać informacje na temat kroków operacyjnych, niepowodzeń, spójności fragmentów i oczyszczania, zobacz Synchronizacja usług ADLS, świeżość zakresu obiektów blob i synchronizacja SharePoint. Niestandardowe pozyskiwanie przez wypychanie pozostaje odpowiedzialne za synchronizowanie własnych metadanych.
Aby uzyskać kroki implementacji zapytań od początku do końca, zobacz ACL w czasie wykonywania zapytania i wymuszanie kontroli dostępu opartej na rolach w usłudze Foundry IQ.
Zalety kontroli dostępu na poziomie dokumentu
Natywna kontrola dostępu na poziomie dokumentu w technologii Foundry IQ zapewnia konkretne zalety w porównaniu z filtrowaniem po stronie aplikacji:
- Zmniejsza niestandardowy kod uprawnień: Usługa Foundry IQ obsługuje obsługiwane rozpoznawanie grup i filtrowanie uprawnień podczas wykonywania zapytania.
- Jest zgodna z istniejącymi mechanizmami kontroli zgodności: Ponowne używanie Microsoft Entra, Microsoft Purview i SharePoint metadanych uprawnień pomaga zachować dopasowanie wyników wyszukiwania do systemu tożsamości źródłowej. Przejrzyj model synchronizacji uprawnień dla każdego źródła, aby zrozumieć jego ograniczenia.
- Uwzględnia uprawnienia źródła po każdej synchronizacji ACL: W przypadku metod opartych na tokenach (ACL, zakresach RBAC, etykietach Purview, ACL platformy SharePoint) egzekwowanie uprawnień w czasie wykonywania zapytania wykorzystuje metadane uprawnień, które udokumentowany, specyficzny dla danego źródła mechanizm synchronizacji (uruchomienie indeksatora, aktualizacja przez interfejs Push API lub odświeżenie usługi Purview) już zapisał w indeksie.
- Poprawia wydajność w porównaniu z przycinaniem po zapytaniu: Filtrowanie wewnątrz potoku wyszukiwania jest szybsze niż ładowanie większych zestawów wyników do aplikacji i przycinanie tam, szczególnie w przypadku dużych woluminów zapytań.
- Ponownie używa istniejącej infrastruktury tożsamości: Microsoft Entra i tożsamości SharePoint pozostają źródłem prawdziwych decyzji dotyczących dostępu, co zmniejsza duplikowanie tożsamości i nakład pracy związany z utrzymywaniem równoległego magazynu uprawnień.
Samouczki i przykłady
Zapoznaj się z kontrolą dostępu na poziomie dokumentu w usłudze Foundry IQ w większej liczbie artykułów i przykładów.
- Samouczek: indeksowanie metadanych uprawnień usługi ADLS Gen2 przy użyciu indeksatora
- azure-search-rest-samples/acl
- azure-search-python-samples/Quickstart-Document-Permissions-Push-API
- azure-search-python-samples/Quickstart-Document-Permissions-Pull-API
- Aplikacja demonstracyjna: pozyskiwanie i honorowanie etykiet poufności
Powiązana zawartość
- Indeksowanie list ACL dokumentów przy użyciu wypychanych interfejsów API REST
- Jak indeksować uprawnienia na poziomie dokumentu przy użyciu indeksatora usługi ADLS Gen2
- Jak indeksować uprawnienia na poziomie dokumentu przy użyciu indeksatora SharePoint w Microsoft 365
- Jak indeksować etykiety poufności przy użyciu indeksatorów (wersja zapoznawcza)
- Jak wykonywać zapytania dotyczące indeksu z obsługą etykiet poufności (wersja zapoznawcza)
- Jak wykonywać zapytania przy użyciu uprawnień opartych na tokenach Microsoft Entra