Wymagania wstępne
Zakładamy, że Twój zewnętrzny klucz KMS został już zarejestrowany w OpenAI zgodnie z jednym z tych przewodników
Kluczowe terminy
Rotacja klucza i unieważnienie klucza służą różnym celom. Upewnij się, że wybierasz właściwe działanie dla swojego przypadku użycia.
Rotacja klucza: wygenerowanie nowego materiału kryptograficznego do szyfrowania nowych danych przy jednoczesnym umożliwieniu odszyfrowania starszych danych zaszyfrowanych poprzednimi kluczami
Rotacja klucza nie wpływa na dostęp do danych OpenAI
Unieważnienie klucza: cofnięcie dostępu do wszystkich danych zaszyfrowanych poprzednimi kluczami.
Unieważnienie klucza cofa dostęp do danych OpenAI
Jak sprawdzić, czy Twój klucz KMS jest używany
Twój dostawca chmury powinien udostępniać dzienniki:
Jak przeprowadzić rotację klucza
Opcje rotacji zależą od dostawcy i typu klucza. Postępuj zgodnie z poniższymi instrukcjami dostawcy. Automatyczna rotacja może wymagać obsługiwanego klucza lub odpowiedniej konfiguracji magazynu kluczy.
AWS - https://docs.aws.amazon.com/kms/latest/developerguide/rotate-keys.html
GCP - https://cloud.google.com/kms/docs/rotate-key#automatic
Azure - https://learn.microsoft.com/en-us/azure/key-vault/keys/how-to-configure-key-rotation
Do sprawdzenia: ta zmiana nie wpłynie na Twój dostęp do danych w OpenAI
Wymiana klucza odzyskiwania PSP jest niezależna od rotacji EKM. Zarejestruj nowy klucz RSA i jego wersję, a następnie wybierz jego identyfikator rejestracji w psp_decryption_key_id. Po zmianie wersji klucza w chmurze rejestracje kluczy odzyskiwania nadal korzystają z pierwotnie zapisanej kopii klucza publicznego. Zachowaj dostęp do starszych wersji klucza prywatnego, aby móc odzyskać starsze dane. Instrukcje konfiguracji znajdziesz tutaj: Konfigurowanie kluczy asymetrycznych.
Jak unieważnić klucz
Poniższa procedura unieważniania EKM dotyczy klucza, który szyfruje Twoje klucze szyfrowania danych. Wybór klucza odzyskiwania PSP ma osobny cykl życia: zmiana uprawnień do odczytu klucza w chmurze nie usuwa z OpenAI zapisanego już publicznego klucza odzyskiwania.
Dostęp OpenAI do Twojego klucza można cofnąć na wiele sposobów — wystarczy przerwać proces uwierzytelniania lub autoryzacji:
Cofnąć roli OpenAI dostęp do klucza KMS
Usunąć uprawnienia do szyfrowania i odszyfrowywania przy użyciu klucza KMS
Jeśli używasz aliasu klucza AWS (co nie jest zalecane), zmienić ARN klucza KMS, na który wskazuje alias. To działanie bywa mylone z rotacją klucza, ale w rzeczywistości oznacza jego unieważnienie. Nie zalecamy go, chyba że masz pewność, że właśnie o to Ci chodzi.
Poprosić OpenAI o aktualizację ARN klucza KMS używanego w Twojej przestrzeni roboczej ChatGPT Enterprise
Aby sprawdzić, czy klucz został unieważniony:
Odczekaj godzinę, aż wygasną wszystkie wpisy w pamięci podręcznej po stronie OpenAI, a następnie przetestuj unieważnienie
Jeśli korzystasz z ChatGPT Enterprise, utracisz możliwość odczytu wcześniejszych rozmów, wyszukiwanie rozmów nie pokaże wyników z wcześniejszych rozmów, a dostęp do wcześniejszych niestandardowych GPT nie będzie możliwy.
Jeśli korzystasz z API, utracisz możliwość pobierania wcześniejszych plików wsadowych, korzystania z wcześniej dostrojonych modeli i odwoływania się do wcześniejszych odpowiedzi utworzonych za pomocą Responses API.
Jeśli korzystasz z API, możesz też od razu sprawdzić, czy OpenAI przetworzyło unieważnienie klucza i czy wejdzie ono w życie w ciągu godziny
Utwórz klucz API administratora (nie zwykły klucz API):
Pobierz identyfikator klucza zewnętrznego OpenAI (extkey_xxx) powiązanego z Twoją przestrzenią roboczą lub projektem, wykonując polecenie curl -X GET -H "Authorization: Bearer $ADMIN_API_KEY" https://api.openai.com/v1/organization/external_keys
Teraz wykonaj polecenie curl -X POST -H "Authorization: Bearer $ADMIN_API_KEY" "https://api.openai.com/v1/organization/external_keys/extkey_xxx/validate"
Najlepsze praktyki dotyczące unieważniania kluczy
Jeśli używasz API
Zarchiwizuj projekt API, którego dane zostały przez Ciebie uczynione niedostępnymi. Następnie skonfiguruj nowy klucz KMS i utwórz nowy projekt API powiązany z nowym kluczem KMS.
Pamiętaj, że nie możesz zamienić klucza KMS powiązanego ze starym projektem API, w którym wykonano unieważnienie klucza — musisz zarchiwizować stary projekt. Projekt, dla którego wydano unieważnienie klucza, nie powinien pozostać w użyciu. API bardzo ułatwia tworzenie nowych projektów, więc skorzystaj z tej funkcji.
Jeśli używasz ChatGPT Enterprise
Skontaktuj się z pomocą techniczną OpenAI po wykonaniu unieważnienia klucza.
Będziemy współpracować z Tobą, aby uruchomić nową przestrzeń roboczą. Nie użyjemy ponownie starej przestrzeni roboczej, próbując zaktualizować ją tak, aby korzystała z nowego klucza KMS. Dzieje się tak, ponieważ gdy unieważnienie klucza działa zgodnie z założeniami, wcześniejsze dane zaszyfrowane unieważnionym kluczem stają się niedostępne.