Передумови
Передбачається, що ви вже зареєстрували свій зовнішній ключ KMS в OpenAI за одним із цих посібників
Ключові терміни
Ротація ключа та відкликання ключа мають різні цілі. Переконайтеся, що ви вибрали правильну дію для свого сценарію використання.
Ротація ключа: створення нового криптографічного матеріалу для шифрування нових даних із можливістю розшифровувати старі дані, зашифровані попередніми ключами
Ротація ключа не впливає на доступ до даних OpenAI
Відкликання ключа: відкликання доступу до всіх даних, зашифрованих попередніми ключами.
Відкликання ключа відкликає доступ до даних OpenAI
Як перевірити, що ваш ключ KMS використовується
У вашого хмарного постачальника мають бути журнали:
Як виконати ротацію ключа
Доступні варіанти ротації залежать від постачальника й типу ключа. Дотримуйтеся наведених нижче інструкцій постачальника; для автоматичної ротації може знадобитися ключ або конфігурація сховища з підтримкою цієї функції.
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
Для перевірки: ця зміна не вплине на ваш доступ до даних OpenAI
Заміна ключа відновлення PSP виконується окремо від ротації EKM. Зареєструйте новий ключ RSA та його версію, а потім виберіть його реєстраційний ідентифікатор у psp_decryption_key_id. Після зміни версії хмарного ключа реєстрації ключів відновлення й далі використовують початковий знімок відкритого ключа. Зберігайте старі версії закритого ключа доступними для відновлення старіших даних. Інструкції з налаштування див. у розділі Налаштування асиметричних ключів.
Як відкликати ключ
Наведена нижче процедура відкликання EKM стосується ключа, який шифрує ваші ключі шифрування даних. Вибір ключа відновлення PSP має окремий життєвий цикл: зміна дозволів на читання хмарного ключа не видаляє з OpenAI вже збережений відкритий ключ відновлення.
Доступ OpenAI до вашого ключа можна відкликати багатьма способами — достатньо будь-якого порушення процесу автентифікації та авторизації:
Якщо ви відкличете доступ ролі OpenAI до ключа KMS
Якщо ви видалите дозволи на шифрування та розшифрування за допомогою ключа KMS
Якщо ви використовуєте псевдонім ключа AWS (не рекомендовано) і зміните ARN ключа KMS, на який він указує. Цю дію іноді плутають із ротацією ключа, але насправді це його відкликання. Тому її не рекомендовано виконувати, якщо ви не впевнені, що саме цього хочете.
Якщо ви попросите OpenAI оновити ARN ключа KMS, який використовується для вашого робочого простору ChatGPT Enterprise
Щоб перевірити відкликання ключа:
Зачекайте одну годину, доки завершиться термін дії всіх записів кешу на боці OpenAI, а потім перевірте відкликання
Якщо ви використовуєте ChatGPT Enterprise, ви більше не зможете читати попередні розмови, пошук не показуватиме результатів із них, а доступ до раніше створених власних GPT буде втрачено.
Якщо ви використовуєте API, ви більше не зможете завантажувати попередні файли пакетної обробки, використовувати раніше донавчені моделі чи посилатися на попередні відповіді, створені за допомогою Responses API.
Якщо ви використовуєте API, ви також можете відразу перевірити, що OpenAI обробила відкликання ключа й воно набуде чинності протягом години
Створіть ключ API адміністратора (не звичайний ключ API):
Отримайте ідентифікатор зовнішнього ключа OpenAI (extkey_xxx), пов’язаного з вашим робочим простором або проєктом, виконавши команду curl -X GET -H "Authorization: Bearer $ADMIN_API_KEY" https://api.openai.com/v1/organization/external_keys
Тепер виконайте команду curl -X POST -H "Authorization: Bearer $ADMIN_API_KEY" "https://api.openai.com/v1/organization/external_keys/extkey_xxx/validate"
Рекомендації щодо відкликання ключа
Якщо ви використовуєте API
Заархівуйте API-проєкт, дані якого ви зробили недоступними. Потім налаштуйте новий ключ KMS і створіть новий API-проєкт, пов’язаний із новим ключем KMS.
Зверніть увагу: ви не можете замінити ключ KMS, пов’язаний зі старим API-проєктом, у якому ви виконали відкликання ключа, — старий проєкт потрібно заархівувати. Проєкт, для якого було видано відкликання ключа, не має залишатися у використанні. API значно спрощує створення нових проєктів, тож скористайтеся цією можливістю.
Якщо ви використовуєте ChatGPT Enterprise
Зверніться до служби підтримки OpenAI після того, як виконаєте відкликання ключа.
Ми співпрацюватимемо з вами, щоб розгорнути новий робочий простір. Ми не будемо повторно використовувати старий робочий простір, намагаючись оновити його для використання нового ключа KMS. Це пов’язано з тим, що коли відкликання ключа працює належним чином, попередні дані, зашифровані відкликаним ключем, стають недоступними.
