Panoramica di OpenAI Enterprise Key Management (EKM)

Scopri come funziona EKM, quali provider sono supportati e da dove iniziare

Aggiornato: 2 days ago

Panoramica

Enterprise Key Management (EKM) consente di crittografare i contenuti dei clienti presso OpenAI utilizzando chiavi gestite dal proprio Key Management System (KMS) esterno, ed è disponibile sia per ChatGPT Enterprise sia per le API.

OpenAI supporta la crittografia Bring Your Own Key (BYOK), con account esterni su AWS KMS, Google Cloud (GCP), Azure Key Vault e Oracle Cloud Infrastructure (OCI) Vault.

Come funziona la crittografia EKM di OpenAI

Flusso principale

  1. Generiamo una chiave di crittografia dei dati (DEK) per il tuo provider cloud.

  2. Il tuo KMS nel cloud gestisce una chiave di crittografia della chiave (KEK) principale, che può essere conservata nel tuo cloud oppure all’esterno. L'implementazione spetta a te.

  3. Richiediamo la crittografia della DEK dal tuo cloud per ottenere una DEK crittografata (eDEK). Se la tua KEK è archiviata esternamente, il tuo cloud effettua semplicemente un passaggio aggiuntivo verso il tuo archivio esterno, in una fase che risulta opaca per OpenAI.

Crittografia

Durante la crittografia, i tuoi dati vengono crittografati con la DEK, e la eDEK viene archiviata come metadati del file.

EKM encryption flow where OpenAI requests a DEK from your KMS, encrypts data, and stores encrypted data with eDEK

Decrittografia

Durante la decrittografia, richiediamo che il tuo KMS cloud decrittografi l'eDEK nella DEK, e utilizziamo la DEK per decrittare i dati.

EKM decryption flow where OpenAI requests a DEK from your KMS to decrypt encrypted data for download

Termini chiave

  • Chiave di crittografia dei dati (DEK): la chiave utilizzata per crittografare i tuoi dati.

  • Chiave di crittografia dei dati crittografata (eDEK) - la DEK crittografata, generata dal tuo KMS

  • Chiave di crittografia della chiave (KEK) - la chiave principale che gestisci e che crittografa la DEK -> eDEK e decrittografa eDEK -> DEK. Questa chiave rimane sempre al di fuori dei sistemi di OpenAI.

Requisiti di alto livello per l'implementazione

Nel tuo provider cloud

  1. Crea una chiave KMS utilizzando AWS, Azure, GCP o OCI Vault (solo per i progetti API).

  2. Crea una policy personalizzata e limitata con autorizzazioni di crittografia/decrittografia nel KMS

  3. Configura l'accesso di OpenAI tramite una policy di attendibilità AWS, un'identità del carico di lavoro (Workload Identity) GCP, un'entità servizio (service principal) Azure o una policy IAM di accesso tra tenancy OCI.

  4. Assegna a OpenAI un ruolo con la policy limitata per accedere al tuo KMS

Sulle piattaforme OpenAI

ChatGPT Enterprise

Crea un'area di lavoro sandbox di ChatGPT a scopo di test.

API

Registra la tua chiave e crea un progetto di test tramite l'API di gestione (Management API). Segui la guida all'integrazione del tuo provider riportata di seguito.

Funzioni specifiche del provider

Per AWS, OpenAI:

  • Chiama AssumeRole con un ExternalID

Per GCP, OpenAI:

  • Chiama il tuo endpoint STS da un account OpenAI GCP

  • Usa il token di accesso GCP per eseguire la crittografia o decrittografia sul tuo KMS.

Per Azure, OpenAI:

  • Richiede un token di accesso per il vault del tuo tenant di Azure

  • Usa quel token di accesso per eseguire la crittografia o decrittografia nel tuo Key Vault.

Per OCI, OpenAI eseguirà le seguenti operazioni:

  • Utilizzerà la propria identità OCI di produzione per crittografare e decrittografare con la chiave AES autorizzata dalla tua policy di accesso tra tenancy.

Informazioni di cui hai bisogno da OpenAI

Autenticazione

Dovrai configurare il riconoscimento dei token di identità federata di OpenAI per AWS e GCP. Per Azure, dovrai riconoscere l'ID applicazione di OpenAI relativo alla registrazione della sua applicazione. Per OCI, dovrai riconoscere la tenancy di OpenAI e il relativo gruppo EKM di produzione.

Riepilogo dei parametri di autenticazione

Principal AWS di OpenAIarn:aws:iam::790389265272:role/EnterpriseKeyManagement
ID dell'account di servizio GCP di OpenAI105900137572174660365
ID applicazione OpenAI Azure20a14814-5ab7-4612-a671-1382b412bf93
Tenancy OCI di OpenAIocid1.tenancy.oc1..aaaaaaaa4kzwe5jdr4gsxft7dfnwbnp3aozhxeskabsqo7czdkbp6fkh3uha
Gruppo EKM di produzione OCI di OpenAIocid1.group.oc1..aaaaaaaaerxukyeaxwqtbsxasnp54mem3sfgyokzdk7s27o7yvepluynxi5q

Informazioni richieste durante l'implementazione in base al provider cloud

  • Per AWS, configura una policy di attendibilità che riconosca il principal AWS di OpenAI indicato sopra.

  • Per GCP, configura un'identità del carico di lavoro (Workload Identity) che riconosca l'account di servizio GCP di OpenAI indicato sopra.

  • Per Azure, crea un'entità servizio (service principal) nel tuo tenant Azure per la registrazione dell'applicazione di OpenAI:

  • Per OCI, concedi a questo gruppo di produzione della tenancy OpenAI l'accesso tramite una policy limitata alle tue risorse. Per la policy, consulta: Configurazione di OCI Vault per la gestione delle chiavi aziendali.

Autorizzazione

Dovrai creare una policy che consenta all'identità di OpenAI di ottenere un accesso limitato al tuo KMS.

AWSGCPAzureOCI
kms:Decryptkms:Encryptcloudkms.cryptoKeyVersions.useToDecryptcloudkms.cryptoKeyVersions.useToEncryptMicrosoft.KeyVault/vaults/keys/encrypt/actionMicrosoft.KeyVault/vaults/keys/decrypt/actionVAULT_READKEY_READKEY_ENCRYPTKEY_DECRYPTLimita l'ambito agli OCID completi del vault e della chiave AES.

Altro

In Azure, per Tipo di chiave (algoritmo di crittografia della chiave) seleziona RSA, non EC.

Informazioni che OpenAI richiede da te

Segui le istruzioni in questo documento per registrare il tuo KMS con OpenAI. Ecco un riepilogo dei parametri che dovrai fornire.

AWSGCPAzureOCI
Relativo all'autenticazione ID tenant
Relativo a KMSARN KMS: (ad esempio: arn:aws:kms:REGION:ACCOUNT_NUMBER:key:KEY_UUID)ID del progetto KMS (esempio: adjective-noun-12345)

Nome del portachiavi KMS
Nome della chiave KMS
Posizione della chiave KMS (esempio: us-east1)
URI del vault (ad esempio: https://your-vault-name.vault.azure.net/)

Nome della chiave
Nome completo della regione (esempio: us-ashburn-1)OCID del vault completoOCID completo della chiave AES-256

Per OCI, la chiave deve avere un tag in formato libero chiamato openai_organization_id il cui valore deve corrispondere all'ID della tua organizzazione OpenAI. Registrala con tipo: "oci" e finalità: "ekm". Non includere key_version_ocid.

Dopo aver registrato il tuo KMS con OpenAI, continua a seguire le istruzioni nella documentazione per attivare la configurazione EKM su un progetto API. Crea un progetto API OpenAI nuovo a scopo di test.

Guide all'implementazione specifiche del provider

Per una guida passo dopo passo, consulta i link corrispondenti qui sotto. Tieni presente che questi si concentrano sui requisiti di integrazione con OpenAI e non sono intesi come una guida completa per il tuo intero ambiente

Funzionalità non supportate se EKM è abilitato

Le seguenti funzionalità non sono disponibili se EKM è abilitato:

  • Funzionalità non ancora disponibili al pubblico, comprese quelle in versione beta o alpha.

Questo articolo è stato utile?