Użyj indeksatora Foundry IQ (Wyszukiwanie AI platformy Azure) do pozyskiwania etykiet poufności Microsoft Purview i egzekwowania zabezpieczeń na poziomie dokumentu (wersja zapoznawcza)

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:

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: true lub 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

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_id cią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.