OpenAI
Tato stránka byla přeložena strojově. Zobrazit původní článek v angličtině.

Pokyny k integraci OpenAI / Azure EKM

Podrobné pokyny k zprovoznění Azure a aktivaci EKM

Aktualizováno: 12 hours ago

Přehled

Enterprise Key Management (EKM) umožňuje OpenAI šifrovat data pomocí hlavního klíče, který spravujete vy. Aby OpenAI mohlo volat operace šifrování/dešifrování ve vašem Key Vaultu, musíme získat přístup. Tento dokument ukazuje, jak nastavit váš účet Azure, aby OpenAI mohlo převzít roli s oprávněními Key Vaultu.

Azure EKM flow where OpenAI EKM uses Microsoft Entra ID to access your Key Vault and master KEK

Kroky

1. Vytvořte ve svém účtu instanční objekt služby pro OpenAI

  1. Získejte přístupový token

az account get-access-token --resource https://graph.microsoft.com
--tenant YOUR_TENANT_ID

2. Vytvořte instanční objekt služby – appId v níže uvedeném požadavku je ID klienta aplikace OpenAI. Tím se vytvoří objekt se zobrazovaným názvem „EKM - OpenAI Azure“ – zapamatujte si ho pro další kroky.

Pokyny k integraci OpenAI / Azure EKM – Vytvoření instančního objektu služby

curl -X POST https://graph.microsoft.com/v1.0/servicePrincipals \
-H "Authorization: Bearer $TOKEN_FROM_ABOVE" \
-H "Content-Type: application/json" \
–d '{"appId": "20a14814-5ab7-4612-a671-1382b412bf93"}'

2. Vytvořte vlastní roli pro omezený přístup ke KMS

  1. Přejděte do Subscriptions -> Access Control (IAM)

  2. V rozbalovací nabídce + Add vyberte Add custom role

  3. Přejděte na kartu JSON, klikněte na Edit a přidejte následující

    1. Libovolný název role – zapamatujte si zvolený název

    2. Následující oprávnění v dataActions

      1. Microsoft.KeyVault/vaults/keys/encrypt/action

      2. Microsoft.KeyVault/vaults/keys/decrypt/action

      3. Microsoft.KeyVault/vaults/keys/read

        OpenAI / Azure EKM Integration Instructions Custom Role

3. Vytvořte Key Vault + Key

Pokud jej ještě nemáte, vytvořte nový Key Vault ve stejném předplatném , kde jste právě vytvořili vlastní roli

V tomto Key Vaultu vytvořte nový klíč:

  1. Přejděte do Key Vault -> Objects -> Keys a potom klikněte na Generate/Import

  2. V části Options vyberte Generate

    Azure Key Vault Keys page with Generate/Import highlighted to add a key

  3. Jako šifrovací algoritmus vyberte RSA .

  4. Můžete vybrat libovolnou velikost klíče RSA

  5. Zadejte název klíče v následujícím formátu: <org-xxx>--<any_name>, kde org-xxx je ID vaší organizace OpenAI, které najdete na adrese https://platform.openai.com/settings/organization/general

    Azure Key Vault key generation form with RSA selected and key name org-abcdefg--test-keyvault-key

Pokud nemůžete zobrazit nebo vytvořit klíč, ujistěte se, že máte roli Key Vault Administrator. Ta je potřeba, i když máte roli Owner. Pro přiřazení role:

  1. Přejděte do Key Vault->Access Control (IAM)

  2. Klikněte na Add-> Add role assignment

    Azure Key Vault Access control (IAM) page with Add menu open to Add role assignment

4. Vytvořte přiřazení role pro instanční objekt služby OpenAI + novou vlastní KMS + nový klíč

  1. Přejděte do Key Vault -> Objects -> Keys a klikněte na řádek klíče, který jste vytvořili

  2. Přejděte do Access control (IAM) pro klíč, na který jste právě klikli (nikoli pro váš Key Vault).

  3. V rozbalovací nabídce + Add vyberte Add role assignment

    Azure Key Vault Access control (IAM) page with Add menu open to Add role assignment

  4. Na kartě Role vyberte název vlastní role, kterou jste právě vytvořili.

    Azure role list filtered for openai- with the openai-azure-kms-role entry

  5. Na kartě Members:

    1. Klikněte na „+ Select members“

    2. Do vyhledávacího pole zadejte „ekm -“ a poté by se měl načíst instanční objekt služby OpenAI, který jste vytvořili v kroku 1

      Azure role assignment Members step with EKM - OpenAI Azure Application selected as a member

5. Uplatněte případná další omezení v souladu se svými bezpečnostními postupy

Výše jsou uvedeny minimální požadované informace, které OpenAI potřebuje k nastavení EKM. Můžete použít další zásady klíčů nebo omezení v souladu se svými interními bezpečnostními postupy, pokud bude OpenAI schopno volat operace šifrování a dešifrování ve vašem KMS. Když zavoláte koncový bod registrace klíče u OpenAI, který je popsán níže, ověříme vaše nastavení.

Po dokončení výše uvedených kroků

ChatGPT Enterprise

Obraťte se prosím na svůj kontakt v OpenAI a sdílejte následující:

  • "tenant_id": "<YOUR_AZURE_TENANT_UUID>"

    • UUID vašeho tenantu Azure

  • "vault_uri": "https://<YOUR_KEYVAULT_NAME>.vault.azure.net/"

    • URI trezoru Azure obsahujícího hlavní klíč, který spravujete

  • "key_name": "<YOUR_KEY_NAME>"

    • Název hlavního klíče Azure Key Vault, který spravujete

    • Název klíče musí mít tvar <org-xxx>--<any_name>, kde org-xxx je ID vaší organizace OpenAI, které najdete na adrese https://platform.openai.com/settings/organization/general

Povolíme EKM pro vaši organizaci/pracovní prostor ChatGPT.

API

Zaregistrujte svůj externí klíč u OpenAI

Postupujte podle pokynů v této referenci API Externí klíče v Management API

  • Nejprve zaregistrujte svůj externí klíč na úrovni organizace OpenAI, čímž se vygeneruje ID externího klíče ve tvaru extkey_xxx

  • V tomto kroku ověříme, že je váš vstup platný a že se můžeme ověřit vůči vašemu KMS.

  • Tím se do vašeho projektu OpenAI zatím nepřidá EKM. 

# Tím se vygeneruje ID externího klíče ve tvaru extkey_xxx

curl -X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer $TOKEN" \
"https://api.openai.com/v1/organization/external_keys" \
-d '{
  "type": "azure",
  "name": "<ANY_FRIENDLY_NAME>",
  "tenant_id": "<YOUR_AZURE_TENANT_UUID>",
  "vault_uri": "https://<YOUR_KEYVAULT_NAME>.vault.azure.net/",
  "key_name": "<YOUR_KEY_NAME>"
}'

  • Poté vytvořte projekt OpenAI přidružený k externímu klíči. Poté se ve vašem projektu aktivuje EKM.

  • Tělo odpovědi tohoto volání API vám poskytne ID projektu (proj_xxx)

    Pokyny k integraci OpenAI / Azure EKM – Vytvoření projektu

curl -X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer $TOKEN" \
"https://api.openai.com/v1/organization/projects" \
-d '{
   "name": "Some Project",
   "external_key_id": "extkey_xxxx"
}'

Byl tento článek užitečný?