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 funkcje lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.
Ważne
Microsoft Purview pozyskiwanie etykiet poufności jest w publicznej wersji zapoznawczej i podlega dodatkowym warunkom użytkowania Microsoft Azure w wersji zapoznawczej. Aby zapoznać się z terminami wersji zapoznawczej specyficznymi dla tej funkcji, zobacz Funkcjonalność w wersji zapoznawczej.
Dodaj obsługę etykiet poufności Microsoft Purview (wersja zapoznawcza) do istniejącego potoku indeksatora Foundry IQ (Wyszukiwanie AI platformy Azure). Skonfiguruj wyodrębnianie etykiet, opatrz adnotacjami docelowe pola metadanych i mapowanie tych wartości na każdy indeksowany dokument lub fragment. Usługa Foundry IQ używa indeksowanych etykiet do wymuszania dostępu na poziomie dokumentu w czasie wykonywania zapytań zgodnie z zasadami Microsoft Purview.
Ta funkcja jest dostępna dla następujących źródeł danych:
- Azure Blob Storage
- Azure Data Lake Storage Gen2
- SharePoint w usłudze Microsoft 365
- Microsoft OneLake
W przykładach z trzema polami w tym artykule użyto metadanych potwierdzonych dla plików w bibliotece dokumentów (dysku) SharePoint w Microsoft 365. Pozyskiwanie etykiet poufności nie obsługuje elementów list SharePoint ani stron witryny.
Wymagania wstępne
Istniejące źródło danych i indeksator skonfigurowany przy użyciu wskazówek dotyczących łącznika, do których link znajduje się w poprzedniej sekcji. Jeśli potok indeksuje fragmenty, skonfiguruj zestaw umiejętności i projekcje indeksu przed dodaniem mapowań etykiet.
Indeks docelowy utworzony za pomocą
purviewEnabled: truelub plan utworzenia nowego indeksu z obsługą usługi Purview i zmiany elementu docelowego istniejącego potoku zgodnie z opisem w kroku 4.Skonfiguruj zasady etykiet poufności Microsoft Purview i zastosuj je do dokumentów przed indeksowaniem.
Mieć role administrator globalny lub administrator ról uprzywilejowanych w dzierżawie Microsoft Entra, aby przyznać usłudze Foundry IQ dostęp do interfejsów API usługi Purview i etykiet poufności.
Zarówno usługa Foundry IQ, jak i użytkownik wystawiający zapytanie muszą znajdować się w tej samej dzierżawie Microsoft Entra.
Używaj dokumentów źródłowych z typami plików, które są obsługiwane przez etykiety poufności usługi Purview i obsługiwane przez indeksatory IQ usługi Foundry.
Użyj interfejsu API REST w wersji 2026-11-01-preview lub równoważnego pakietu zestawu SDK w wersji zapoznawczej.
Usługa Foundry IQ musi używać przypisanej przez system tożsamości zarządzanej do uwierzytelniania za pomocą Microsoft Purview. Ta funkcja nie obsługuje tożsamości zarządzanych przypisanych przez użytkownika.
Ograniczenia
Portal Azure nie obsługuje tej funkcji.
Autouzupełnianie i interfejsy API Suggest nie są obsługiwane w przypadku indeksów z obsługą usługi Purview, ponieważ nie mogą jeszcze wymuszać kontroli dostępu opartej na etykietach.
Konta gościa i zapytania między dzierżawami nie są obsługiwane.
Następujące funkcje indeksatora nie obsługują dokumentów z etykietami poufności. Jeśli używasz żadnej z tych funkcji w zestawie umiejętności lub indeksatorze, dokumenty z etykietami poufności nie są przetwarzane.
Magazyn wiedzy, w tym magazyn zasobów wymagany do obsługi obrazów (wersja zapoznawcza) w przypadku wyszukiwania agentowego. W związku z tym obsługa udostępniania obrazów nie jest dostępna dla źródeł wiedzy, które importują etykiety poufności.
Jak działa wymuszanie zasad
Obsługa etykiet poufności ma dwie fazy: indeksowanie i wymuszanie czasu zapytania.
Indeksowanie
Indeksator wyodrębnia zawartość dokumentu i metadane etykiety poufności. W kolejnych uruchomieniach aktualizuje indeksowane wartości, gdy wykryje zmiany w etykiecie, zawartości lub metadanych dokumentu.
Indeks nie odzwierciedla zmian etykiet w dokumentach źródłowych do momentu następnego pomyślnego uruchomienia indeksatora.
Wymuszanie czasu wykonywania zapytań
W czasie wykonywania zapytania usługa Foundry IQ ocenia etykiety poufności i wymusza kontrolę dostępu na poziomie dokumentu na podstawie tokenu Microsoft Entra ID użytkownika i zasad etykiet Microsoft Purview. Tylko użytkownicy upoważnieni do dostępu do treści z prawem do odczytu pod daną etykietą mogą pobierać odpowiednie dokumenty w wynikach wyszukiwania.
Aby uzyskać informacje o wymaganiach dotyczących uwierzytelniania i autoryzacji zapytań, zobacz Wykonywanie zapytań względem indeksu z obsługą etykiet poufności. Aby zapoznać się z badaniami administracyjnymi i inspekcją, zobacz Podwyższony odczyt.
1. Włącz tożsamość zarządzaną usługi Foundry IQ
Włącz tożsamość zarządzaną przypisaną przez system dla usługi IQ usługi Foundry. Indeksator używa własnej tożsamości usługi do uwierzytelniania za pomocą Microsoft Purview i wykonywania operacji uprzywilejowanychEXTRACT, w tym odczytywania zaszyfrowanej zawartości i klasyfikacji informacji. Przypisz wymagane role bezpośrednio do tej tożsamości w kroku 3.
2. Włącz kontrolę dostępu opartą na rolach (RBAC) w usłudze Foundry IQ
Włącz kontrolę dostępu opartą na rolach (RBAC) w usłudze IQ rozwiązania Foundry. Indeksy z obsługą usługi Purview wymagają uwierzytelniania RBAC na potrzeby operacji na dokumentach, w tym indeksowania zawartości i wykonywania zapytań. Zachowaj włączoną zarówno kontrolę dostępu opartej na rolach, jak i klucze interfejsu API, jeśli inne operacje usługi opierają się na kluczach interfejsu API. Ta konfiguracja nie zezwala na operacje na dokumentach przy użyciu klucza API w indeksach z obsługą usługi Purview.
3. Przyznaj dostęp do pobierania etykiet poufności
Uzyskiwanie dostępu do metadanych etykiety poufności Microsoft Purview obejmuje wysoce uprzywilejowane operacje. Zaangażuj zespoły ds. bezpieczeństwa lub zgodności i uzyskaj zatwierdzenie za pośrednictwem procesu zapewniania ładu w organizacji przed przypisaniem uprawnień.
Po zatwierdzeniu skontaktuj się z Global Administrator lub Privileged Role Administrator, aby przypisać te role do przypisanej przez system tożsamości zarządzanej usługi Foundry IQ:
- Content.SuperUser na potrzeby wyodrębniania etykiet i zawartości.
- UnifiedPolicy.Tenant.Read do uzyskiwania dostępu do metadanych zasad i etykiet usługi Purview.
Przypisywanie ról przy użyciu programu PowerShell
Przypisz te role tylko do przypisanej przez system tożsamości zarządzanej usługi Foundry IQ, a nie tożsamości zarządzanej przypisanej przez użytkownika, oddzielnej jednostki usługi aplikacji lub pojedynczego konta użytkownika. Skrypt programu PowerShell automatycznie pobiera identyfikator obiektu tożsamości zarządzanej z zasobu usługi.
Administrator globalny lub administrator ról uprzywilejowanych powinien użyć następującego skryptu programu PowerShell, aby udzielić wymaganych uprawnień. Uzyskaj zgodę administratora dla delegowanych zakresów AppRoleAssignment.ReadWrite.All Microsoft Graph i Application.Read.All zgodnie z zatwierdzonym procesem zarządzania. Sama rola administratora dzierżawy nie dostarcza tych zakresów tokenów.
Po zainstalowaniu modułów pokazanych w poniższej sekcji ustanów oddzielny uwierzytelniony kontekst Azure PowerShell w tej samej sesji programu PowerShell przed uruchomieniem pozostałych poleceń. Użyj polecenia Connect-AzAccount, aby zalogować się do dzierżawy usługi Foundry IQ, a polecenia Set-AzContext, aby wybrać właściwą dzierżawę i subskrypcję. Konto Azure musi mieć uprawnienia do odczytywania zasobu usługi Foundry IQ, takie jak rola Czytelnik.
Connect-Entra nie ustanawia tego kontekstu Az.
Zastąp symbole zastępcze rzeczywistym identyfikatorem dzierżawy, identyfikatorem subskrypcji, grupą zasobów i nazwą usługi Foundry IQ.
Install-Module -Name Az -Scope CurrentUser
Install-Module -Name Microsoft.Entra -AllowClobber
Import-Module Az.Resources
Connect-Entra -TenantId "<tenantId>" `
-Scopes 'AppRoleAssignment.ReadWrite.All', 'Application.Read.All'
$resourceIdWithManagedIdentity = (
"/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/" +
"providers/Microsoft.Search/searchServices/<searchServiceName>"
)
$managedIdentityObjectId = (Get-AzResource `
-ResourceId $resourceIdWithManagedIdentity).Identity.PrincipalId
# Microsoft Information Protection (MIP)
$MIPResourceSP = Get-EntraServicePrincipal `
-Filter "appID eq '870c4f2e-85b6-4d43-bdda-6ed9a579b725'"
New-EntraServicePrincipalAppRoleAssignment `
-ServicePrincipalId $managedIdentityObjectId `
-PrincipalId $managedIdentityObjectId `
-ResourceId $MIPResourceSP.Id `
-Id "8b2071cd-015a-4025-8052-1c0dba2d3f64"
# Microsoft Rights Management Services (MRMS) - policy read
$MRMSResourceSP = Get-EntraServicePrincipal `
-Filter "appID eq '00000012-0000-0000-c000-000000000000'"
New-EntraServicePrincipalAppRoleAssignment `
-ServicePrincipalId $managedIdentityObjectId `
-PrincipalId $managedIdentityObjectId `
-ResourceId $MRMSResourceSP.Id `
-Id "7347eb49-7a1a-43c5-8eac-a5cd1d1c7cf0"
Dokumentacja: Connect-Entra, Get-AzResource, Get-EntraServicePrincipal, New-EntraServicePrincipalAppRoleAssignment i Microsoft Graph uprawnienia do przypisywania roli aplikacji.
Skrypt przypisuje role aplikacji w następujących jednostkach usługi zasobów do tożsamości zarządzanej usługi Foundry IQ:
| identyfikator aplikacji | Podmiot usługi zasobu |
|---|---|
870c4f2e-85b6-4d43-bdda-6ed9a579b725 |
usługa synchronizacji Microsoft Info Protection |
00000012-0000-0000-c000-000000000000 |
Usługi zarządzania prawami firmy Microsoft |
4. Skonfiguruj indeks, aby włączyć etykietę wrażliwości Purview
Użyj wersji 2026-11-01-preview interfejsu API REST, aby wprowadzić zmiany konfiguracji w poniższych krokach.
Ważne
Właściwość purviewEnabled musi być ustawiona na true podczas tworzenia indeksu. To ustawienie jest trwałe i nie można go później modyfikować.
Jeśli istniejący indeks nie ma purviewEnabled: true, utwórz nowy indeks z włączoną obsługą usługi Purview i zmień indeksator i wszystkie selektory projekcji tak, aby wskazywały na niego. Nie można włączyć tej właściwości w istniejącym indeksie.
W przypadku indeksu z obsługą usługi Purview tylko uwierzytelnianie RBAC jest obsługiwane dla wszystkich interfejsów API operacji dokumentów. Dostęp za pomocą klucza interfejsu API jest ograniczony do pobierania schematu indeksu (lista i pobieranie).
We wszystkich obsługiwanych źródłach danych etykiet poufności metadata_sensitivity_label zawiera jeden identyfikator etykiety jako ciąg GUID. Zdefiniuj pole indeksu docelowego jako Edm.String, a nie kolekcję. Wartość może być nieobecna lub mieć wartość null, gdy dokument jest nieoznaczony lub wyodrębnianie etykiet jest celowo pomijane.
Dodaj te trzy pola ciągów do indeksu docelowego. Jeśli fragmenty są dokumentami przeszukiwalnymi, dodaj pola do indeksu fragmentów.
| Pole metadanych źródła | Docelowe pole indeksu | Typ i adnotacja |
|---|---|---|
metadata_sensitivity_label |
sensitivity_label_id |
Edm.StringIdentyfikator GUID; sensitivityLabelId: true, retrievable: true, filterable: true. |
metadata_sensitivity_label_name |
sensitivity_label_name |
Edm.String nazwa etykiety; sensitivityLabelName: true, retrievable: true. |
metadata_source_document_id |
source_document_id |
Edm.String identyfikator audytu; sourceDocumentId: true, retrievable: true. |
Pole source_document_id identyfikuje dokument źródłowy na potrzeby inspekcji. Nie jest to klucz indeksu wyszukiwania ani klucz nadrzędny projekcji.
Ostrzeżenie
Następujące fragmenty JSON to różnice konfiguracji, a nie kompletne ciała żądań PUT. Scal je z definicjami pełnych zasobów przed przesłaniem żądań. Operacja create-or-update PUT zastępuje definicję zasobu. Zachowaj istniejące pola i tablice, mapowania, opcje, selektory, poświadczenia i inną konfigurację; Nie zamieniaj pełnej definicji ani tablicy na fragment.
Właściwość tworzenia indeksu: Uwzględnij tę właściwość w pełnej definicji tworzenia nowego indeksu. Jeśli istniejący indeks już go zawiera, pozostaw go bez zmian.
{
"purviewEnabled": true
}
Dodatki pól indeksu: Dołącz te obiekty do tablicy fields w pełnej definicji indeksu, zachowując istniejący schemat i układ indeksowania.
[
{
"name": "sensitivity_label_id",
"type": "Edm.String",
"filterable": true,
"retrievable": true,
"sensitivityLabelId": true
},
{
"name": "sensitivity_label_name",
"type": "Edm.String",
"retrievable": true,
"sensitivityLabelName": true
},
{
"name": "source_document_id",
"type": "Edm.String",
"retrievable": true,
"sourceDocumentId": true
}
]
Odwołanie: Definicja indeksu.
W przypadku mapowań na poziomie dokumentu, postępuj zgodnie z krokiem 7. W przypadku fragmentów podrzędnych postępuj zgodnie z krokiem 6.
5. Konfigurowanie źródła danych
Delta opcji źródła danych: Dodaj sensitivityLabel element do indexerPermissionOptions w skonfigurowanym źródle danych. Jeśli inne opcje uprawnień są już włączone, zachowaj je i dołącz tę opcję zamiast zastępować tablicę.
{
"indexerPermissionOptions": ["sensitivityLabel"]
}
Odniesienie: Definicja źródła danych.
Ta opcja umożliwia wyodrębnianie etykiet. Różni się on od adnotacji pól indeksu sensitivityLabelId, sensitivityLabelName i sourceDocumentId. Zachowaj istniejące poświadczenia łącznika, wybór kontenera i inne ustawienia.
6. Konfigurowanie projekcji indeksów w zestawie umiejętności (jeśli dotyczy)
Jeśli potok indeksuje fragmenty, rozszerz istniejący selektor projekcji indeksu. Zastosuj wymagania dotyczące dodawania pól i indeksu z obsługą usługi Purview z kroku 4 do indeksu chunków.
Dodatki mapowania projekcji: Dodaj na końcu te wpisy do tablicy odpowiedniego selektora mappings wewnątrz elementu indexProjections.selectors. Te dodatki nie są kompletnym wyborem ani zestawem umiejętności.
[
{
"name": "sensitivity_label_id",
"source": "/document/metadata_sensitivity_label"
},
{
"name": "sensitivity_label_name",
"source": "/document/metadata_sensitivity_label_name"
},
{
"name": "source_document_id",
"source": "/document/metadata_source_document_id"
}
]
Odwołanie: definicja zestawu umiejętności.
Zachowaj fragment selektora targetIndexName, parentKeyFieldName i fragment sourceContext, z wyjątkiem przypisania nowego indeksu, jeśli jest to wymagane. Zachowaj inne selektory, mapowania zawartości i wektorów oraz istniejący tryb projekcji. Jawnie zmapuj każde podrzędne pole niebędące kluczem; powyższe trzy uzupełnienia nie stanowią pełnego zestawu mapowań.
Te ścieżki na poziomie głównym kopiują zamapowane wartości ciągów dostępne w obiekcie nadrzędnym na każdy fragment. Rzuty generują klucz podrzędny i powiązanie elementu nadrzędnego na potrzeby śledzenia zmian. Nie mapuj ręcznie wygenerowanych kluczy, takich jak chunk_id lub parent_id, w projekcjach ani w mechanizmie dzielenia indeksatora na fragmenty fieldMappings.
Jeśli umiejętność dzielenia tekstu emituje nieprzetworzone ciągi w obszarze chunks, użyj /document/chunks/* dla mapowania selektora sourceContext i zawartości, a nie ścieżki podrzędnej /id lub /text.
Za pomocą polecenia skipIndexingParentDocuments bezpośredni indeksator fieldMappings nie tworzy dokumentów podrzędnych. Projekcja identyfikatora etykiety jest wymagana do wymuszania zapytań na poziomie fragmentu i powiązanych metadanych odpowiedzi etykiety. Aby uzyskać informacje na temat obsługi odpowiedzi, zobacz Sprawdź metadane etykiety poufności w odpowiedzi.
W przypadku układu dwóch indeksów nadrzędny-podrzędny użyj mapowań bezpośrednich w kroku 7 , aby wypełnić indeks nadrzędny i te projekcje w celu wypełnienia indeksu podrzędnego. Aby uzyskać informacje na temat semantyki mapowania, zobacz Przejrzyj mapowania pól.
7. Konfigurowanie indeksatora
Aby mieć po jednym dokumencie wyszukiwania dla każdego dokumentu źródłowego, dodaj mapowania metadanych bezpośrednich do istniejącego indeksatora. Używaj nieprzetworzonych nazw pól źródłowych bez prefiksu /document/ .
Dodawanie mapowania pól bezpośrednich: Dołącz te wpisy do tablicy indeksatora fieldMappings . Zachowaj mapowanie klucza konektora, inne mapowania, źródło danych i połączenia zestawu umiejętności, indeks docelowy i konfigurację, z wyjątkiem przekierowania na nowy indeks, jeśli jest to wymagane.
[
{
"sourceFieldName": "metadata_sensitivity_label",
"targetFieldName": "sensitivity_label_id"
},
{
"sourceFieldName": "metadata_sensitivity_label_name",
"targetFieldName": "sensitivity_label_name"
},
{
"sourceFieldName": "metadata_source_document_id",
"targetFieldName": "source_document_id"
}
]
Odwołanie: Definicja indeksatora.
W przypadku fragmentów zachowaj istniejący indeksator połączony ze swoim zestawem umiejętności; mapowania selektora w kroku 6 wypełniają metadane podrzędne.
Zweryfikuj import etykiet
Po scaleniu zmian w pełne definicje zasobów wykonaj początkowe uzupełnienie, jeśli istniejący indeksator przetworzył już pliki źródłowe. Włączenie wyodrębniania, dodawania pól metadanych lub przekierowania potoku nie powoduje, że pliki bez zmian kwalifikują się do normalnego uruchomienia przyrostowego. Aby ponownie przetworzyć te pliki, zresetuj indeksator, a następnie uruchom go. Reset usuwa śledzenie zmian, a kolejne uruchomienie ponownie przetwarza wszystkie dokumenty źródłowe; uwzględnij to obciążenie.
Jeśli pliki nie zostały jeszcze zindeksowane, uruchom indeksator bez resetowania. Użyj Pobierz stan indeksatora, aby potwierdzić pomyślne wykonanie i sprawdzić błędy i ostrzeżenia dokumentu. Zaakceptowane żądanie uruchomienia nie jest dowodem ukończonego importu.
Korzystając z autoryzowanej tożsamości zapytania i przewodnika po zapytaniach, sprawdź znany dokument z etykietą i jego fragmenty:
- Oznakowany plik z dowolnego obsługiwanego źródła wypełnia element
sensitivity_label_idciągiem identyfikatora GUID. W przypadku pliku z etykietą w bibliotece dokumentów SharePoint (dysku) sprawdź również nazwę etykiety i identyfikator audytu dokumentu źródłowego w powiązanych polach; w przypadku innych źródeł sprawdź odpowiednie wartości, jeśli metadane dla tego źródła są dostępne. - Dokument bez etykiety lub dokument z celowo pominiętym wyodrębnianiem etykiet ma nieobecny lub zerowy identyfikator etykiety.
- Każdy fragment podrzędny dziedziczy zamapowane wartości metadanych dostępne w obiekcie nadrzędnym, a wygenerowane klucze podrzędne i nadrzędne pozostają nienaruszone.
Jeśli brakuje oczekiwanych metadanych, sprawdź błędy wykonywania i ostrzeżenia, opcję wyodrębniania źródła danych w kroku 5 oraz mapowania bezpośrednie lub mapowania projekcji w krokach 6 i 7. Upewnij się, że backfill przetworzył określony plik.
W przypadku późniejszego odświeżania przyrostowego uruchom lub zaplanuj indeksator w celu przetworzenia wykrytych zmian źródłowych; nie resetuj go dla każdego odświeżania indeksu. Zmiany etykiety źródłowej nie są widoczne w indeksie, dopóki pomyślne uruchomienie indeksatora ich nie przetworzy. Aby uzyskać informacje na temat odświeżania cyklicznego, zobacz Zaplanuj indeksator.