Vereisten
Hierbij gaan we ervan uit dat je je externe KMS-sleutel al bij OpenAI hebt geregistreerd aan de hand van een van deze handleidingen
Kernbegrippen
Rotatie van sleutels en intrekking van sleutels dienen verschillende doelen. Kies de juiste actie voor je gebruiksscenario.
Sleutelrotatie: genereer nieuw cryptografisch materiaal voor versleuteling van nieuwe gegevens, terwijl ontsleuteling van oudere gegevens die met eerdere sleutels zijn versleuteld mogelijk blijft
Sleutelrotatie heeft geen invloed op toegang tot OpenAI-gegevens
Sleutelintrekking: trek de toegang in tot alle gegevens die met eerdere sleutels zijn versleuteld.
Sleutelintrekking trekt de toegang tot OpenAI-gegevens in
Controleren of je KMS-sleutel wordt gebruikt
Je cloudprovider zou logboeken moeten hebben:
Je sleutel roteren
De rotatieopties zijn afhankelijk van de provider en het sleuteltype. Volg de onderstaande instructies van de provider; voor automatische rotatie is mogelijk een ondersteunde sleutel- of kluisconfiguratie vereist.
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
Ter controle: deze wijziging heeft geen invloed op je toegang tot OpenAI-gegevens
Het vervangen van een PSP-herstelsleutel staat los van EKM-rotatie. Registreer de vervangende RSA-sleutel en de versie ervan en selecteer vervolgens de registratie-ID in psp_decryption_key_id. Herstelregistraties blijven hun oorspronkelijke momentopname van de openbare sleutel gebruiken wanneer de versie van de cloudsleutel verandert. Houd oude versies van privésleutels beschikbaar om oudere gegevens te kunnen herstellen. Zie voor het instellen: Asymmetrische sleutels instellen.
Je sleutel intrekken
De onderstaande EKM-intrekkingsprocedure geldt voor de sleutel die je gegevensversleutelingssleutels versleutelt. De selectie van PSP-herstelsleutels heeft een aparte levenscyclus: als je de leesrechten voor cloudsleutels wijzigt, wordt een al bij OpenAI opgeslagen openbare herstelsleutel niet verwijderd.
Je kunt de toegang van OpenAI tot je sleutel op verschillende manieren intrekken, door het authenticatieproces te onderbreken:
Door de toegang van de OpenAI-rol tot de KMS-sleutel in te trekken
Door de rechten voor versleutelen en ontsleutelen met de KMS-sleutel te verwijderen
Door bij gebruik van een AWS-sleutelalias (niet aanbevolen) de onderliggende KMS-ARN te wijzigen. Deze actie wordt soms verward met sleutelrotatie, maar is in feite een sleutelintrekking. Dit wordt daarom afgeraden, tenzij je zeker weet dat je dit wilt.
Door OpenAI te vragen de KMS-ARN voor je ChatGPT Enterprise-werkruimte te wijzigen
Zo controleer je of je sleutel is ingetrokken:
Wacht één uur tot alle cache-items bij OpenAI zijn verlopen en test vervolgens de intrekking
Als je ChatGPT Enterprise gebruikt, kun je eerdere gesprekken niet meer lezen, levert zoeken in gesprekken geen resultaten uit eerdere gesprekken meer op en heb je geen toegang meer tot eerdere aangepaste GPT's.
Als je de API gebruikt, kun je eerdere batchbestanden niet meer downloaden, eerdere gefinetunede modellen niet meer gebruiken en niet meer verwijzen naar eerdere antwoorden die met de Responses API zijn gemaakt.
Als je de API gebruikt, kun je ook meteen controleren of OpenAI de intrekking van je sleutel heeft verwerkt en of deze binnen één uur van kracht wordt
Maak een Admin API-sleutel aan (geen gewone API-sleutel):
Haal de externe sleutel-ID van OpenAI (extkey_xxx) op die aan je werkruimte of project is gekoppeld door het volgende commando uit te voeren: curl -X GET -H "Authorization: Bearer $ADMIN_API_KEY" https://api.openai.com/v1/organization/external_keys
Voer nu het volgende commando uit: curl -X POST -H "Authorization: Bearer $ADMIN_API_KEY" "https://api.openai.com/v1/organization/external_keys/extkey_xxx/validate"
Best practices voor sleutelintrekking
Als je de API gebruikt
Archiveer het API-project waarvan je de gegevens ontoegankelijk hebt gemaakt. Stel vervolgens een nieuwe KMS-sleutel in en maak een nieuw API-project dat aan de nieuwe KMS-sleutel is gekoppeld.
Let op: je kunt de KMS-sleutel die is gekoppeld aan het oude API-project waarvoor je de sleutel hebt ingetrokken, niet vervangen - je moet het oude project archiveren. Een project waarvoor een sleutel is ingetrokken, mag niet in gebruik blijven. Met de API kun je heel eenvoudig nieuwe projecten maken, dus gebruik die functie.
Als je ChatGPT Enterprise gebruikt
Neem contact op met OpenAI-support nadat je een sleutel hebt ingetrokken.
We werken met je samen om een nieuwe werkruimte op te zetten. We zullen de oude werkruimte niet hergebruiken door te proberen deze bij te werken voor gebruik met een nieuwe KMS-sleutel. Dit komt doordat, wanneer sleutelintrekking werkt zoals bedoeld, eerdere gegevens die met de ingetrokken sleutel zijn versleuteld ontoegankelijk worden.
