Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Uwaga
Foundry IQ (Wyszukiwanie AI platformy Azure) udostępnia bezpośrednie interfejsy API indeksowania i zapytań, a także interfejsy API wyższego poziomu dla źródeł wiedzy i baz wiedzy do zarządzanego pobierania. Użyj portalu Azure, interfejsów API REST lub Azure SDKs, aby skonfigurować te możliwości lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.
Ważne
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 IQ usługi Foundry (Wyszukiwanie AI platformy Azure), zobacz Funkcje wersji zapoznawczej.
Włączenie kluczy zarządzanych przez klienta (CMK) dodaje dodatkowe zabezpieczenia do domyślnego szyfrowania danych w stanie spoczynku, gdy używane są klucze zarządzane przez Microsoft. Po włączeniu klucza głównego klienta (CMK) masz kontrolę nad kluczami szyfrowania używanymi do ochrony danych, w tym masz możliwość:
- Obracanie kluczy zgodnie z harmonogramem zdefiniowanym przez klienta
- Wyłącz lub odwołaj klucze, aby zablokować dostęp do zaszyfrowanej zawartości (klucze buforowane mogą być utrwalane przez maksymalnie 60 minut)
- Monitorowanie użycia klucza za pomocą logowania w Azure Key Vault
Usługa Foundry IQ (Wyszukiwanie AI platformy Azure) używa Twojego klucza CMK jako klucza szyfrowania kluczy (KEK), aby opakowywać i odpakowywać klucze szyfrowania danych, które chronią Twoją zawartość. Nie używa klucza cmK do szyfrowania ani odszyfrowywania zawartości bezpośrednio.
Klucze można tworzyć, przechowywać i nimi zarządzać przy użyciu:
Azure Key Vault
Azure Key Vault zarządzany moduł HSM (sprzętowy moduł zabezpieczeń). Azure Key Vault Managed HSM to zweryfikowany moduł HSM FIPS 140-2 Poziom 3. Aby przeprowadzić migrację z Azure Key Vault do modułu HSM, przekręć klucze i wybierz Zarządzane HSM dla magazynu.
Azure Key Vault Managed HSM — zarządzanie kluczami zewnętrznymi (EKM). W przeciwieństwie do kluczy przechowywanych w zarządzanym module HSM klucze zewnętrzne pozostają w module HSM obsługiwanym przez klienta poza infrastrukturą Microsoft. Zarządzane moduły HSM kierują operacje opakowania i odpakowania do tego modułu HSM przez serwer proxy EKM.
W tym artykule opisano, jak skonfigurować CMK w celu zapewnienia dodatkowej ochrony zaszyfrowanych danych w usłudze Foundry IQ.
Ważne
- Dodanie klucza zarządzanego przez klienta ma zastosowanie do szyfrowania danych w stanie spoczynku. Jeśli chcesz chronić dane w użyciu, rozważ użycie poufnego przetwarzania.
Wymagania wstępne
Foundry IQ w warstwie płatnej (Basic lub wyższa, w dowolnym regionie).
Azure Key Vault i magazyn kluczy z włączoną ochroną usuwania nietrwałego i trwałym usunięciem. Lub Azure Key Vault Managed HSM, w tym zarządzanie kluczami zewnętrznymi. Ten zasób może znajdować się w dowolnej subskrypcji i w innej dzierżawie. W tych instrukcjach zakłada się istnienie jednego dzierżawcy. Aby uzyskać informacje o konfiguracji między dzierżawcami, zobacz Konfigurowanie kluczy zarządzanych przez użytkownika w różnych dzierżawach.
W przypadku zarządzania kluczami zewnętrznymi wymagane są: zarządzany moduł HSM z włączoną funkcją EKM w ramach subskrypcji, działający serwer proxy EKM oraz klucz RSA w zewnętrznym module HSM. Aby uzyskać informacje o wymaganiach dotyczących konfiguracji, zobacz Tworzenie pierwszego klucza zewnętrznego przy użyciu Azure CLI.
Jeśli planujesz skonfigurować klucz zarządzany przez klienta (CMK) na poziomie usługi, użyj interfejsu API REST usługi Search Management w wersji 2026-03-01-preview lub nowszej. Aby sprawdzić, czy obiekt dziedziczy klucz poziomu usługi, użyj interfejsu API warstwy danych w wersji 2026-05-01-preview lub nowszej.
Możliwość konfigurowania uprawnień dostępu klucza i przypisywania ról. Aby utworzyć klucze, należy użyć Key Vault Crypto Officer w Azure Key Vault lub Managed HSM Crypto User w Azure Key Vault Managed HSM.
Aby przypisać role Azure Key Vault, musisz być Owner subskrypcji, User Access Administrator, Role-based Access Control Administrator lub mieć przypisaną rolę niestandardową z uprawnieniem Microsoft.Authorization/roleAssignments/write. Dostęp do klucza zarządzanego HSM wymaga oddzielnych lokalnych uprawnień do przypisywania ról RBAC.
Konfigurowanie klucza CMK dla obiektów Foundry IQ
Obiekty z zaszyfrowanymi danymi, które można skonfigurować za pomocą klucza zarządzanego przez klienta (CMK), obejmują indeksy, listy synonimów, indeksatory, źródła danych, wektoryzatory i zestawy umiejętności. Szyfrowanie jest kosztowne obliczeniowo przy odszyfrowywaniu, dlatego szyfrowana jest tylko wrażliwa zawartość.
Szyfrowanie jest wykonywane za pośrednictwem:
Cała zawartość w indeksach i listach synonimów.
Zawartość wrażliwa w indeksatorach, źródłach danych, zestawach funkcji i wektoryzatorach. Zawartość wrażliwa obejmuje parametry połączenia, opisy, tożsamości, klucze i dane wejściowe użytkownika. Na przykład zestawy umiejętności mogą zawierać klucze dla połączonych usług, a niektóre umiejętności akceptują dane wejściowe użytkownika, takie jak jednostki niestandardowe. W obu przypadkach klucze i dane wejściowe użytkownika są szyfrowane. Wszelkie odwołania do zasobów zewnętrznych, takich jak Azure źródła danych lub modele Azure OpenAI, również są szyfrowane.
Dodanie klucza zarządzanego przez klienta do obiektu musi nastąpić po utworzeniu obiektu. Należy pamiętać o:
Nie można wstecznie dodać CMK do istniejącego obiektu. Jeśli chcesz dodać klucz zarządzany przez klienta do istniejącego obiektu, musisz usunąć i ponownie utworzyć ten obiekt z włączonym szyfrowaniem.
Po skonfigurowaniu CMK (klucza zarządzanego przez klienta) szyfrowanie odbywa się za każdym razem, gdy usługa zapisuje dane, w tym dane w spoczynku (magazyn długoterminowy) oraz tymczasowe dane buforowane (magazyn krótkoterminowy). W przypadku obiektów, takich jak źródła danych, indeksatory i zestawy umiejętności, definicja obiektu jest szyfrowana. W przypadku indeksów same dokumenty indeksowane (nie tylko schemat indeksu) są szyfrowane.
Możesz zmienić istniejącą konfigurację klucza zarządzanego przez klienta, w tym przełączyć się na inny Key Vault lub magazyn HSM. Aby użyć magazynu kluczy w innej dzierżawie, skonfiguruj CMK między dzierżawami.
Szyfrowanie za pomocą klucza głównego zarządzanego przez klienta (CMK) jest nieodwracalne. Klucze można obracać i zmieniać konfigurację CMK, ale szyfrowanie indeksu trwa przez cały czas jego istnienia. Po szyfrowaniu za pomocą klucza CMK indeks jest dostępny tylko wtedy, gdy usługa Foundry IQ ma dostęp do klucza. Jeśli odwołasz dostęp do klucza przez usunięcie lub zmianę przypisania roli, indeks jest bezużyteczny i nie można skalować usługi do czasu usunięcia indeksu lub przywrócenia dostępu do klucza. Jeśli usuniesz lub obrócisz klucze, najnowszy klucz jest buforowany przez maksymalnie 60 minut.
Jeśli potrzebujesz klucza CMK w usłudze Foundry IQ, ustaw zasady wymuszania.
Wymuszanie CMK przy użyciu Azure Policy oraz konfiguracja CMK na poziomie usługi (obecnie dostępna w wersji zapoznawczej) to niezależne ustawienia. W zależności od potrzeb możesz użyć obu tych opcji. Konfiguracja klucza CMK na poziomie usługi stosuje domyślny klucz do nowych obiektów, a wymuszanie zasad Azure Policy gwarantuje, że wszystkie obiekty spełniają wymagania dotyczące szyfrowania. Jeśli włączysz zasady wymuszania klucza CMK bez klucza na poziomie usługi, wszystkie obiekty obsługujące CMK muszą określić własny klucz szyfrowania w momencie tworzenia. Żądania tworzenia obiektów, które pomijają konfigurację cmK, kończą się niepowodzeniem.
Domyślnie włącz klucze CMK na poziomie usługi dla nowych obiektów (wersja zapoznawcza)
Począwszy od wersji 2026-03-01-preview, można skonfigurować klucz zarządzany przez klienta na poziomie usługi w samej usłudze IQ rozwiązania Foundry. Ta funkcja umożliwia skonfigurowanie klucza raz i zastosowanie go do wszystkich nowo utworzonych obiektów domyślnie. Ta ochrona zapewnia bezpieczeństwo poufnych danych w usłudze Foundry IQ za pomocą klucza, który kontrolujesz, bez konieczności określania informacji o kluczu za każdym razem, gdy tworzysz obiekt. W wersji 2026-05-01-preview i nowszych interfejsu API warstwy danych właściwość encryptionKey w obiekcie isServiceLevelKey pomaga określić, czy obiekt dziedziczy klucz na poziomie usługi, czy używa jawnego klucza obiektu.
Włączenie klucza zarządzanego przez klienta (CMK) na poziomie usługi oznacza:
Wszystkie nowe obiekty utworzone w usłudze IQ usługi Foundry automatycznie używają klucza zarządzanego przez klienta na poziomie usługi, więc nie trzeba już jawnie określać szczegółów klucza szyfrowania za każdym razem, gdy tworzysz obiekt.
Ta funkcja jest opcjonalna i możesz nadal konfigurować CMK na podstawie poszczególnych obiektów. Można również zastąpić klucz poziomu usługi dla poszczególnych obiektów i niezależnie obracać klucz poziomu usługi, co pozwala na używanie różnych kluczy dla różnych obiektów zgodnie z potrzebami.
Ten klucz domyślny można zastąpić, określając nowy klucz dla tworzonego obiektu. Klucz na poziomie obiektu, który określasz, zastępuje domyślny klucz poziomu usługi dla tego obiektu.
Wybór między kluczem CMK na poziomie usługi a kluczem CMK na poziomie obiektu
Użyj domyślnie klucza CMK na poziomie usługi, aby zastosować jeden klucz do wszystkich obiektów. Klucz należy skonfigurować raz, a nowe obiekty dziedziczą te zabezpieczenia automatycznie.
Użyj klucza CMK na poziomie obiektu dla obciążeń, które wymagają niezależnego cyklu życia klucza. Istniejące konfiguracje cmK na poziomie obiektu nadal działają bez zmian. CMK na poziomie usługi upraszcza zarządzanie kluczami, ale nie zastępuje CMK na poziomie obiektu.
Typowym wzorcem przedsiębiorstwa jest skonfigurowanie klucza poziomu usługi dla większości obiektów (indeksów, indeksatorów, źródeł danych, zestawów umiejętności, wektoryzatorów i map synonimów). Obciążenia z bardziej rygorystycznymi wymaganiami dotyczącymi zgodności mogą konfigurować klucz na poziomie obiektu w celu niezależnego zarządzania dostępem, rotacją i odwoływaniem.
Krok 1. Tworzenie klucza szyfrowania
Utwórz klucz w Azure Key Vault lub Azure Key Vault Managed HSM albo zarejestruj odwołanie do klucza zewnętrznego w Azure Key Vault Managed HSM. Szyfrowanie IQ usługi Foundry obsługuje klucze RSA o rozmiarach 2048, 3072 i 4096. Te wymagania dotyczą również kluczy obcych. Aby uzyskać więcej informacji na temat obsługiwanych typów kluczy, zobacz About keys (Informacje o kluczach).
Przed rozpoczęciem zalecamy przejrzenie tych wskazówek .
Klucz musi zezwalać na operacje zawijania klucza i odwijania klucza. Usługa Foundry IQ nie wymaga operacji Encrypt ani Decrypt dla klucza CMK.
Możesz utworzyć magazyn kluczy przy użyciu portalu Azure, Azure CLI lub Azure PowerShell.
Przejdź do magazynu kluczy w portalu Azure.
Wybierz Obiekty>Klucze po lewej stronie, a następnie wybierz Generuj/Importuj.
W okienku Tworzenie klucza z listy Opcje wybierz pozycję Generuj , aby utworzyć nowy klucz.
Wprowadź nazwę klucza i zaakceptuj wartości domyślne innych właściwości klucza.
Opcjonalnie ustaw politykę rotacji kluczy, aby włączyć automatyczne obracanie.
Wybierz pozycję Utwórz , aby rozpocząć wdrażanie.
Po utworzeniu klucza pobierz jego identyfikator klucza. Wybierz klucz, wybierz bieżącą wersję, a następnie skopiuj identyfikator klucza. Składa się z identyfikatora URI magazynu kluczy, nazwy klucza i wersji klucza. Potrzebny jest identyfikator do zdefiniowania zaszyfrowanego indeksu w usłudze Foundry IQ.
Krok 2. Tworzenie podmiotu zabezpieczeń
Utwórz podmiot zabezpieczeń używany przez usługę Foundry IQ w celu uzyskania dostępu do klucza szyfrowania. Możesz użyć tożsamości zarządzanej i przypisania roli lub zarejestrować aplikację i udostępnić identyfikator aplikacji dla żądań w usłudze Foundry IQ.
Użyj tożsamości zarządzanej i ról. Można użyć tożsamości zarządzanej przez system lub tożsamości zarządzanej przez użytkownika. Tożsamość zarządzana umożliwia usłudze Foundry IQ uwierzytelnianie za pośrednictwem Microsoft Entra ID bez przechowywania poświadczeń (ApplicationID lub ApplicationSecret) w kodzie. Cykl życia tego typu tożsamości zarządzanej jest powiązany z cyklem życia usługi Foundry IQ, która może mieć tylko jedną tożsamość zarządzaną przypisaną przez system. Aby uzyskać więcej informacji na temat sposobu działania tożsamości zarządzanych, zobacz Co to są tożsamości zarządzane dla zasobów Azure.
Włącz tożsamość zarządzaną przypisaną przez system dla usługi IQ usługi Foundry. Jest to operacja kliknięcia dwukrotnego: włączanie i zapisywanie.
Krok 3. Udzielanie uprawnień
Udziel podmiotowi zabezpieczeń usługi Foundry IQ tych minimalnych uprawnień dostępu do kluczy: Pobierz (odczyt metadanych klucza), Opakuj klucz i Odpakuj klucz. Te uprawnienia dotyczą Azure Key Vault, zarządzanego modułu HSM i kluczy zewnętrznych, do których odwołuje się zarządzany moduł HSM.
Następujące role zapewniają te uprawnienia do danych klucza bez udzielania uprawnień szyfrowania, odszyfrowywania lub zarządzania kluczami:
| Przechowywanie kluczy | Rola jednostki usługi Foundry IQ | Model uprawnień |
|---|---|---|
| Azure Key Vault | Użytkownik szyfrowania usługi Crypto Service w Key Vault | kontrola dostępu oparta na rolach Azure |
| Zarządzany moduł HSM, w tym zewnętrzne zarządzanie kluczami | Użytkownik szyfrowania usługi kryptograficznej Managed HSM | Zarządzany HSM z lokalną kontrolą dostępu opartą na rolach |
Kontrola dostępu oparta na rolach jest zalecana ponad model uprawnień polityki dostępu. Aby uzyskać więcej informacji lub kroków migracji, zacznij od Azure kontroli dostępu opartej na rolach (Azure RBAC) a zasady dostępu (starsza wersja).
Jeśli używasz starszych zasad dostępu usługi Key Vault, przyznaj podmiotowi zabezpieczeń tylko uprawnienia Get, Wrap Key i Unwrap Key.
W przypadku Azure Key Vault wykonaj następujące kroki, aby przypisać rolę do tożsamości zarządzanej usługi Foundry IQ:
Przejdź do magazynu kluczy w portalu Azure.
Wybierz pozycję Kontrola dostępu (Zarządzanie dostępem i tożsamościami) i wybierz pozycję Dodaj przypisanie roli.
Wybierz pozycję Użytkownik szyfrowania usługi Key Vault.
Wybierz pozycję Tożsamości zarządzane, wybierz członków, a następnie wybierz tożsamość zarządzaną usługi IQ usługi Foundry. Jeśli testujesz na lokalnym komputerze, przypisz tę rolę do siebie.
Wybierz pozycję Przejrzyj i przypisz.
Poczekaj kilka minut, aż przypisanie roli stanie się funkcjonalne.
W przypadku zarządzanego modułu HSM, w tym odwołań do kluczy zewnętrznych, przypisz Managed HSM Crypto Service Encryption User za pomocą zarządzanej lokalnej kontroli dostępu opartej na rolach modułu HSM. Możesz ograniczyć zakres przypisania do /keys/<key-name>, aby przyznać dostęp tylko do klucza zarządzanego przez klienta i jego wersji. Aby uzyskać instrukcje dotyczące przypisywania ról, zobacz Kontrola dostępu dla zarządzanego modułu HSM.
Zapora usługi Key Vault i dostęp z sieci wirtualnej dla CMK
Usługa Foundry IQ musi mieć dostęp do klucza szyfrowania w Azure Key Vault.
Jeśli magazyn kluczy używa ograniczeń zapory lub sieci wirtualnej, skonfiguruj jedną z następujących opcji:
- Zezwalaj na dostęp z wybranych sieci, które obejmują usługę Foundry IQ.
- Włącz Allow trusted usługi firmy Microsoft to obejście tej zapory.
Po włączeniu obejścia zaufanych usług usługa Foundry IQ może uzyskać dostęp do klucza jako zaufanej usługi przy użyciu tożsamości zarządzanej, nawet jeśli dostęp do sieci publicznej jest ograniczony.
Jeśli zapora blokuje dostęp i obejście zaufanych usług nie jest włączone, Foundry IQ nie może pobrać klucza, a operacje zależne od CMK kończą się niepowodzeniem.
Krok 4. Dodawanie informacji o kluczu szyfrowania do obiektów IQ usługi Foundry
Podczas tworzenia zaszyfrowanego obiektu wprowadź identyfikator URI magazynu kluczy, nazwę klucza i wersję klucza. Jeśli używasz aplikacji Microsoft Entra ID do uwierzytelniania, wprowadź również identyfikator aplikacji i wpis tajny.
W przypadku kluczy zewnętrznych ustaw istniejące właściwości CMK na punkt końcowy usługi Managed HSM (keyVaultUri), nazwę odwołania do klucza (keyVaultKeyName) i wersję (keyVaultKeyVersion). Nie używaj adresu URL serwera proxy EKM ani identyfikatora klucza zewnętrznego. Skonfiguruj klucze zewnętrzne za pomocą interfejsów API REST IQ usługi Foundry, a nie portalu.
Aby dodać klucz zarządzany przez klienta do obiektu wyszukiwania, może to być indeks, indeksator, źródło danych, zestaw umiejętności, wektoryzator lub mapa synonimów, można skonfigurować klucz na poziomie usługi lub na poziomie obiektu.
Poziom usługi: Skonfigurowanie klucza zarządzanego przez klienta na poziomie usługi powoduje, że jest on domyślnie stosowany do wszystkich nowo utworzonych obiektów wyszukiwania. Nie ma zastosowania do istniejących obiektów wyszukiwania.
Poziom obiektu: można również zdefiniować nowy, unikatowy klucz na poziomie obiektu podczas tworzenia nowego obiektu wyszukiwania. Ta definicja klucza na poziomie obiektu zastępuje domyślny klucz poziomu usługi.
Uwaga
Podczas aktualizowania konfiguracji klucza zarządzanego przez klienta między definicją klucza na poziomie usługi lub obiektu zachowaj zasoby z poprzedniej konfiguracji, dopóki aktualizacja nie będzie propagowana w całej usłudze. Usunięcie tożsamości, usunięcie magazynów kluczy lub cofnięcie kluczy zbyt szybko może uniemożliwić niektórym składnikom usługi odszyfrowywanie danych, które nadal opierają się na poprzedniej konfiguracji.
Aby skonfigurować klucz do zarządzania klientem (CMK) na obiekcie, użyj portalu Azure, Search Service REST APIs lub Azure SDK.
Podczas tworzenia nowego obiektu w portalu Azure można określić z góry ustalony klucz zarządzany przez klienta w sejfie kluczy. Portal Azure umożliwia włączenie szyfrowania za pomocą klucza zarządzanego przez klienta (CMK) do:
- Indeksy
- Źródła danych
- Indeksatory
Aby można było korzystać z portalu Azure, magazyn kluczy i klucz muszą istnieć i należy wykonać poprzednie kroki w celu uzyskania autoryzowanego dostępu do klucza.
W portalu Azure zestawy umiejętności są definiowane w widoku JSON. Użyj kodu JSON pokazanego w przykładach interfejsu API REST, aby udostępnić klucz zarządzany przez klienta w zestawie umiejętności.
Przejdź do Twojej usługi Foundry IQ w portalu Azure.
W obszarze Zarządzanie wyszukiwaniem wybierz pozycję Indeksy, Indeksatory lub Źródła danych.
Dodaj nowy obiekt. W definicji obiektu wybierz pozycję szyfrowanie zarządzane przez Microsoft.
Wybierz Klucze zarządzane przez klienta, a następnie określ subskrypcję, magazyn, klucz i wersję.
Ważne
Zaszyfrowana zawartość w usłudze Foundry IQ jest skonfigurowana do używania określonego klucza z określoną wersją. Jeśli zmienisz klucz lub wersję, obiekt musi zostać zaktualizowany, aby był używany przed usunięciem poprzedniego. Nieudane wykonanie tej czynności powoduje, że obiekt staje się bezużyteczny. Nie będzie można odszyfrować zawartości, jeśli klucz zostanie utracony.
Skonfiguruj CMK na poziomie usługi (wersja zapoznawcza)
Aby włączyć konfigurację klucza zarządzanego przez klienta (CMK) na poziomie usługi, użyj interfejsu API REST Search Management lub pakietu Azure SDK zaktualizowanego tak, aby obsługiwał interfejs API REST Search Management w wersji 2026-03-01-preview lub nowszej. Portal Azure nie obsługuje jeszcze tej funkcji. Po włączeniu klucza cmK na poziomie usługi nie dodajesz szyfrowania do istniejących obiektów, ale domyślnie stosujesz ten sam klucz do wszystkich nowo utworzonych obiektów w usłudze, chyba że określisz inny klucz na poziomie obiektu, aby zastąpić wartość domyślną poziomu usługi.
Obecnie portal Azure nie obsługuje szyfrowania na poziomie usługi. Bezpośrednio użyj interfejsu API REST.
Sprawdź, czy obiekt wyszukiwania dziedziczy klucz CMK na poziomie usługi
Aby sprawdzić, czy obiekt wyszukiwania używa klucza zarządzanego przez klienta skonfigurowanego na poziomie usługi jako domyślnego lub unikatowego klucza zarządzanego przez klienta skonfigurowanego na poziomie obiektu, sprawdź stan odziedziczonego szyfrowania przy użyciu isServiceLevelKey właściwości .
Obecnie portal Azure nie obsługuje szyfrowania na poziomie usługi. Bezpośrednio użyj interfejsu API REST.
Krok 5. Testowanie szyfrowania
Aby sprawdzić, czy szyfrowanie działa, odwołaj klucz szyfrowania, wykonaj zapytanie względem indeksu (powinno być bezużyteczne), a następnie przywrócić klucz szyfrowania.
W przypadku kluczy przechowywanych w Azure Key Vault użyj portalu Azure na potrzeby tego testu. Upewnij się, że masz przypisanie roli, które udziela dostępu do odczytu do klucza.
Na stronie Azure Key Vault wybierz pozycję Objects>Keys.
Wybierz utworzony klucz, a następnie wybierz pozycję Usuń.
Na stronie IQ rozwiązania Foundry wybierz pozycję Zarządzanie wyszukiwaniem>.
Wybierz indeks i użyj Eksploratora wyszukiwania, aby uruchomić zapytanie. Powinien zostać wyświetlony błąd.
Wróć do strony Azure Key Vault Objects>Keys.
Wybierz pozycję Zarządzaj usuniętymi kluczami.
Wybierz klucz, a następnie wybierz pozycję Odzyskaj.
Wróć do indeksu w usłudze Foundry IQ i uruchom ponownie zapytanie. Powinny zostać wyświetlone wyniki wyszukiwania. Jeśli nie widzisz natychmiastowych wyników, poczekaj minutę i spróbuj ponownie.
Ustawienie zasad wymuszających zgodność z CMK
Azure zasady pomagają wymuszać standardy organizacyjne i oceniać zgodność na dużą skalę. Usługa Foundry IQ ma dwie opcjonalne wbudowane zasady związane z kluczem CMK. Te zasady dotyczą nowych i istniejących usług IQ platformy Foundry.
| Efekt | Opis |
|---|---|
| AuditIfNotExists | Sprawdza zgodność zasad: czy obiekty mają zdefiniowany klucz zarządzany przez klienta i czy zawartość jest zaszyfrowana. Ten efekt dotyczy istniejących usług z zawartością. Jest obliczany za każdym razem, gdy obiekt jest tworzony lub aktualizowany albo zgodnie z harmonogramem oceny. Dowiedz się więcej... |
| Odmów | Sprawdza wymuszanie zasad: czy usługa Foundry IQ ma właściwość SearchEncryptionWithCmk ustawioną na Enabled. Ten efekt dotyczy tylko nowych usług, które należy utworzyć z włączonym szyfrowaniem. Istniejące usługi pozostają operacyjne, ale nie można ich aktualizować, chyba że usługa zostanie poprawiona. Żadne z narzędzi używanych do aprowizacji usług nie uwidacznia tej właściwości, dlatego należy pamiętać, że ustawienie zasad ogranicza konfigurację programową. |
Przypisz zasady
W portalu Azure przejdź do zasad wbudowanych, a następnie wybierz pozycję Przypisz.
Oto przykład zasad AuditIfExists w portalu Azure:
Ustaw zakres zasad , wybierając subskrypcję i grupę zasobów. Wyklucz wszystkie usługi Foundry IQ, dla których zasady nie powinny być stosowane.
Zaakceptuj lub zmodyfikuj wartości domyślne. Wybierz Przejrzyj i utwórz, a następnie wybierz Utwórz.
Włącz wymuszanie zasad CMK
Po przypisaniu zasad do grupy zasobów w ramach subskrypcji będzie ona obowiązywać natychmiast. Zasady inspekcji oznaczają zasoby jako niezgodne, ale zasady odmowy uniemożliwiają tworzenie i aktualizowanie niezgodnych usług Foundry IQ. W tej sekcji wyjaśniono, jak utworzyć zgodną usługę IQ rozwiązania Foundry lub zaktualizować usługę, aby była zgodna. Aby zapewnić zgodność obiektów, zacznij od kroku jednego z tego artykułu.
Utwórz zgodną usługę Foundry IQ
W przypadku nowych usług Foundry IQ utwórz je za pomocą polecenia SearchEncryptionWithCmk ustawionego na wartość Enabled.
Ani witryna Azure Portal, ani narzędzia wiersza polecenia (Azure CLI i Azure PowerShell) nie udostępniają natywnie tej właściwości, ale można użyć Management REST API do aprowizacji usługi Foundry IQ z definicją zasad CMK.
Ten przykład pochodzi z artykułu Manage your Foundry IQ service with REST APIs, który został zmodyfikowany w celu uwzględnienia właściwości SearchEncryptionWithCmk.
### Create a search service (provide an existing resource group)
@resource-group = my-rg
@search-service-name = my-search
PUT https://management.azure.com/subscriptions/{{subscriptionId}}/resourceGroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2025-05-01 HTTP/1.1
Content-type: application/json
Authorization: Bearer {{token}}
{
"location": "North Central US",
"sku": {
"name": "basic"
},
"properties": {
"replicaCount": 1,
"partitionCount": 1,
"hostingMode": "default",
"encryptionWithCmk": {
"enforcement": "Enabled"
}
}
}
Zaktualizuj istniejącą usługę Foundry IQ
W przypadku istniejących usług Foundry IQ, które są obecnie niezgodne, popraw je za pomocą Services - Update API lub polecenia Azure CLI az resource update. Poprawianie usług przywraca możliwość aktualizowania właściwości usługi Foundry IQ.
PATCH https://management.azure.com/subscriptions/<your-subscription-Id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name>?api-version=2025-05-01
{
"properties": {
"encryptionWithCmk": {
"enforcement": "Enabled"
}
}
}
Obracanie lub aktualizowanie kluczy szyfrowania
Skorzystaj z poniższych instrukcji, aby obrócić klucze lub przeprowadzić migrację z Azure Key Vault do sprzętowego modułu zabezpieczeń (HSM).
W przypadku rotacji kluczy użyj funkcji automatycznej rotacji w Azure Key Vault. Jeśli używasz autorotacji, pomiń wersję klucza w definicjach obiektów. Używany jest najnowszy klucz, a nie określona wersja.
Po zmianie klucza lub jego wersji zaktualizuj dowolny obiekt, który używa klucza do używania nowych wartości przed usunięciem starych wartości. W przeciwnym razie obiekt staje się bezużyteczny, ponieważ nie można go odszyfrować.
W przypadku skonfigurowania klucza CMK na poziomie usługi rotacja klucza na poziomie usługi ma zastosowanie do nowo utworzonych obiektów od teraz. Obiekty, które już odziedziczyły poprzedni klucz poziomu usługi, automatycznie pobierają nowy klucz, więc nie trzeba ich aktualizować. Jeśli jednak masz obiekty skonfigurowane przy użyciu klucza na poziomie obiektu, który również chcesz obrócić, musisz zaktualizować te obiekty, aby użyć nowego klucza.
Klucze są buforowane przez 60 minut. Pamiętaj o tym podczas testowania i rotacji kluczy.
Utwórz nowy klucz w magazynie kluczy, ale pozostaw dostępny oryginalny klucz. W tym kroku możesz przełączyć się z magazynu kluczy do modułu bezpieczeństwa sprzętowego (HSM).
Zaktualizuj właściwości encryptionKey w indeksie lub mapie synonimów, aby użyć nowych wartości. W celu użycia innej wartości można zaktualizować tylko obiekty, które zostały pierwotnie utworzone za pomocą tej właściwości.
Wyłącz lub usuń poprzedni klucz w składnicy kluczy. Monitoruj dostęp do klucza, aby sprawdzić, czy nowy klucz jest używany.
Ze względu na wydajność usługa IQ usługi Foundry buforuje klucz przez maksymalnie kilka godzin. Jeśli wyłączysz lub usuniesz klucz bez podawania nowego, zapytania będą nadal działać tymczasowo do momentu wygaśnięcia pamięci podręcznej. Jednak gdy usługa IQ usługi Foundry nie może już odszyfrować zawartości, zostanie wyświetlony następujący komunikat: "Access forbidden. The query key used might have been revoked - please retry."
porady dotyczące Key Vault
Jeśli dopiero zaczynasz pracę z Azure Key Vault, zapoznaj się z tym Szybkim startem, aby dowiedzieć się o podstawowych zadaniach: Ustawianie i pobieranie sekretu z Azure Key Vault przy użyciu PowerShell.
Użyj jak najwięcej magazynów kluczy, ile potrzebujesz. Klucze zarządzane mogą znajdować się w różnych magazynach kluczy. Usługa IQ rozwiązania Foundry może mieć wiele zaszyfrowanych obiektów, z których każdy jest zaszyfrowany przy użyciu innego klucza szyfrowania zarządzanego przez klienta, przechowywanych w różnych magazynach kluczy.
Użyj tego samego Azure tenant, aby można było pobrać zarządzany klucz za pomocą przypisań ról, łącząc się przez tożsamość systemu lub zarządzaną przez użytkownika. Aby uzyskać więcej informacji na temat tworzenia dzierżawy, zobacz Konfigurowanie nowej dzierżawy.
Jeśli Azure Key Vault jest zabezpieczony za pomocą zapory, upewnij się, że włączono opcję Zezwalaj zaufanym usługi firmy Microsoft na omijanie tej zapory, aby usługa Foundry IQ mogła uzyskać dostęp do klucza.
Włącz ochronę przed trwałym usunięciem i usuwanie nieostateczne w magazynie kluczy. Ze względu na charakter szyfrowania za pomocą kluczy zarządzanych przez klienta nikt nie może pobrać danych, jeśli klucz Azure Key Vault zostanie usunięty. Aby zapobiec utracie danych spowodowanej przypadkowym usunięciem kluczy w magazynie kluczy, należy włączyć usuwanie nietrwałe i ochronę przed czyszczeniem w Key Vault. Miękkie usuwanie jest domyślnie włączone, więc problemy pojawią się tylko wtedy, gdy celowo je wyłączysz. Ochrona przed usuwaniem trwałym nie jest domyślnie włączona, ale jest wymagana do szyfrowania za pomocą klucza zarządzanego przez klienta w usłudze Foundry IQ.
Włącz rejestrowanie w magazynie kluczy, aby można było monitorować użycie kluczy.
Włącz autorotację kluczy lub postępuj zgodnie ze ścisłymi procedurami podczas rutynowej rotacji kluczy magazynu kluczy, wpisów tajnych aplikacji oraz rejestracji aplikacji. Zawsze aktualizuj całą zaszyfrowaną zawartość, aby używać nowych sekretów i kluczy przed usunięciem starych. Jeśli przegapisz ten krok, nie można odszyfrować zawartości.
Praca z zaszyfrowaną zawartością
Używając CMK, możesz zauważyć opóźnienie zarówno przy indeksowaniu, jak i zapytaniach, ze względu na dodatkowy proces szyfrowania/odszyfrowywania. Usługa Foundry IQ nie rejestruje aktywności szyfrowania, ale można monitorować dostęp do klucza za pomocą rejestrowania w magazynie kluczy.
Zalecamy włączenie rejestrowania w ramach konfiguracji Key Vault.
Dodaj ustawienie diagnostyczne w magazynie kluczy, które korzysta z obszaru roboczego do przechowywania danych.
Wybierz audit lub allLogs jako kategorię, nazwij ustawienie diagnostyczne i zapisz je.
FAQs
Czy mogę zmienić obiekt wyszukiwania między kluczem zarządzanym przez klienta zdefiniowanym na poziomie usługi i kluczem zarządzanym przez klienta zdefiniowanym na poziomie obiektu?
- Yes. Podczas konfigurowania CMK na poziomie usługi, każdy nowy obiekt wyszukiwania domyślnie używa tego klucza. Jeśli skonfigurujesz inny klucz w definicji na poziomie obiektu, klucz poziomu obiektu ma priorytet nad kluczem poziomu usługi. Jeśli usuniesz definicję klucza na poziomie obiektu, obiekt wyszukiwania zostanie domyślnie przywrócony do klucza zarządzanego przez klienta zdefiniowanego na poziomie usługi.
Następne kroki
Jeśli nie znasz architektury bezpieczeństwa Azure, zapoznaj się z dokumentacją Azure Security, a w szczególności z tym artykułem: