OpenAI

OpenAI / Azure EKM इंटीग्रेशन के निर्देश

Azure को प्रोविज़न करने और EKM को सक्रिय करने के लिए क्रमिक निर्देश

अपडेट किया गया: 3 days ago

अवलोकन

एंटरप्राइज़ की मैनेजमेंट (EKM), OpenAI को आपके नियंत्रण में मास्टर कुंजी का उपयोग करके डेटा एन्क्रिप्ट करने की अनुमति देता है. आपके Key Vault पर OpenAI को एन्क्रिप्ट/डिक्रिप्ट ऑपरेशन कॉल करने के लिए हमें एक्सेस प्रदान करनी होगी. यह दस्तावेज़ दिखाता है कि अपने Azure अकाउंट को कैसे सेट अप करें, ताकि OpenAI Key Vault अनुमतियों के साथ एक भूमिका ग्रहण कर सके.

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

चरण

एक. अपने अकाउंट में OpenAI के लिए एक सर्विस प्रिंसिपल बनाएं.

  1. एक्सेस टोकन प्राप्त करें

az account get-access-token --resource https://graph.microsoft.com
--tenant YOUR_TENANT_ID (पहुंच टोकन प्राप्त करें)

  1. सर्विस प्रिंसिपल बनाएँ - नीचे दिए गए अनुरोध में appId OpenAI का एप्लिकेशन क्लाइंट id है. यह “EKM - OpenAI Azure” डिस्प्ले नाम के साथ एक प्रिंसिपल बनाएगा - इसे बाद के चरणों के लिए याद रखें.

OpenAI / Azure EKM इंटीग्रेशन निर्देश - सर्विस प्रिंसिपल बनाएँ

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. सीमित KMS एक्सेस के लिए कस्टम भूमिका बनाएँ

  1. Go Subscriptions -> Access Control (IAM)

  2. + जोड़ें ड्रॉपडाउन मेनू में, कस्टम भूमिका जोड़ें चुनें

  3. JSON टैब पर जाएँ, एडिट करें पर क्लिक करें, और निम्नलिखित जोड़ें:

    1. कोई भी रोल का नाम - आपने जो नाम चुना है, उसे याद रखें.

    2. 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. Key Vault + कुंजी बनाएं

अगर आपके पास पहले से कोई Key Vault नहीं है, तो उसी सब्सक्रिप्शन में एक नया Key Vault बनाएं, जहाँ आपने अभी-अभी अपनी कस्टम भूमिका बनाई है.

उस Key Vault में, एक नई कुंजी बनाएँ:

  1. Go Key Vault -> Objects -> Keys, फिर Generate/Import पर क्लिक करें

  2. विकल्पों के अंतर्गत जनरेट करें चुनें

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

  1. एन्क्रिप्शन एल्गोरिदम के लिए RSA का चुनें.

  2. आप कोई भी RSA कुंजी आकार चुन सकते हैं

  3. निम्नलिखित फ़ॉर्मैट में एक कुंजी नाम प्रदान करें: <org-xxx>--<any_name>, जहाँ org-xxx आपकी OpenAI संगठन ID है, जिसे आप https://platform.openai.com/settings/organization/general पर पा सकते हैं

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

अगर आप किसी कुंजी को देख या बना नहीं पा रहे हैं, तो सुनिश्चित करें कि आपके पास Key Vault Administrator की भूमिका है. यह तब भी ज़रूरी है, भले ही आपके पास ओनर की भूमिका हो. भूमिका असाइन करने के लिए:

  1. Key Vault -> Access Control (IAM) पर जाएँ

  2. जोड़ें -> भूमिका असाइनमेंट जोड़ें पर क्लिक करें

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

4. OpenAI सर्विस प्रिंसिपल + नए कस्टम KMS + नई कुंजी के लिए एक भूमिका असाइनमेंट बनाएं

  1. Key Vault -> Objects -> Keys पर जाएँ फिर आपके द्वारा बनाई गई कुंजी की पंक्ति पर क्लिक करें

  2. जिस कुंजी पर आपने अभी क्लिक किया है, उसके लिए एक्सेस नियंत्रण (IAM) पर जाएँ (अपने key vault पर नहीं).

  3. + जोड़ें ड्रॉपडाउन के अंतर्गत, भूमिका असाइनमेंट जोड़ेंचुनें

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

  1. रोल टैब में, उस कस्टम भूमिका का नाम चुनें जिसे आपने अभी-अभी बनाया है.

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

  1. सदस्य टैब में:

    1. “+ सदस्य चुनें” पर क्लिक करें

    2. सर्च बार में “ekm -” टाइप करें, फिर चरण 1 में आपने जो OpenAI सर्विस प्रिंसिपल बनाया था, वह लोड हो जाएगा

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

पाँच. अपनी खुद की सुरक्षा प्रथाओं के अनुरूप कोई भी अतिरिक्त प्रतिबंध लागू करें.

ऊपर दी गई जानकारी OpenAI को EKM सेट अप करने के लिए आवश्यक न्यूनतम जानकारी है. आप अपनी इंटरनल सिक्योरिटी प्रैक्टिसेज़ के अनुरूप अतिरिक्त key policies या restrictions लागू करने के लिए स्वतंत्र हैं, बशर्ते कि OpenAI आपके KMS पर encrypt और decrypt operations को कॉल कर सके. जब आप नीचे वर्णित OpenAI के की रजिस्ट्रेशन एंडपॉइंट को कॉल करते हैं, तो हम आपके सेटअप को वैलिडेट करेंगे.

ऊपर दिए गए चरणों को पूरा करने के बाद

ChatGPT Enterprise

कृपया अपने OpenAI संपर्क से संपर्क करें और निम्नलिखित साझा करें:

  • "tenant_id": "<YOUR_AZURE_TENANT_UUID>"

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

  • "key_name": "<YOUR_KEY_NAME>"

  • Azure Key Vault मास्टर कुंजी का नाम, जिसे आप प्रबंधित करते हो

  • की का नाम ` <org-xxx>--<any_name> ` इस रूप में होना चाहिए, जहाँ org-xxx आपकी OpenAI संगठन ID है, जिसे आप https://platform.openai.com/settings/organization/general पर पा सकते हैं

हम आपके ChatGPT संगठन/वर्कस्पेस के लिए EKM इनेबल करेंगे.

API

अपनी एक्सटर्नल कुंजी को OpenAI के साथ रजिस्टर करें.

इस API रेफ़रंस में दिए गए निर्देशों का पालन करें मैनेजमेंट API में बाहरी कुंजियाँ

  • सबसे पहले, अपनी बाहरी कुंजी को OpenAI संगठन स्तर पर रजिस्टर करें, जिससे extkey_xxxके रूप में एक बाहरी कुंजी आईडी जनरेट होगी

  • इस चरण में, हम यह सुनिश्चित करेंगे कि आपका इनपुट मान्य है और हम आपके KMS से प्रमाणित कर सकते हैं.

  • यह अभी आपके OpenAI प्रोजेक्ट में EKM नहीं जोड़ेगा.

# यह extkey_xxx के रूप में एक बाहरी कुंजी ID जनरेट करता है
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>"
}'

  • फिर, एक्सटर्नल कुंजी से संबद्ध एक OpenAI प्रोजेक्ट बनाएं. इसके बाद, आपके प्रोजेक्ट पर EKM सक्रिय हो जाता है.

  • इस API कॉल की प्रतिक्रिया बॉडी आपको प्रोजेक्ट ID (proj_xxx) प्रदान करेगी

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"
}'

क्या यह लेख मददगार था?