Security Blog

मैं AI एजेंट को API कुंजी कैसे दूँ बिना उसे कुंजी दिखाए?

#44

November 20, 2026 · By Mila

← All posts

एजेंट को कुंजी की जगह एक संदर्भ दें, और उसी मशीन पर बैठे एक प्रॉक्सी को अनुरोध के बाहर जाते समय असली कुंजी उसमें डालने दें। यहाँ बताया गया है कि env vars काफ़ी क्यों नहीं रह गए, और इसे कैसे सेट करें।

एजेंट को कुंजी की जगह एक संदर्भ दें, और उसी मशीन पर बैठे एक छोटे प्रॉक्सी को अनुरोध के बाहर जाते समय असली कुंजी उसमें बदलने दें। एजेंट रहस्य की जगह clavitor://OpenAI/key लिखता है। API को असली कुंजी मिलती है। एजेंट उसे कभी हाथ में नहीं लेता, इसलिए वह उसे छाप नहीं सकता, लॉग नहीं कर सकता, और न ही बातचीत में उकसाकर उसे किसी को सौंप सकता है।

पूरा विचार यही है। इस पृष्ठ का बाकी हिस्सा यह समझाता है कि यह क्यों मायने रखता है, और इसे कैसे सेट करें।

"बस एक env var में डाल दो" काफ़ी क्यों नहीं रहा

एक साल पहले, export OPENAI_API_KEY=sk-... कुंजी किसी स्क्रिप्ट को देने का सामान्य तरीका था। किसी ने आपत्ति नहीं की।

फिर स्क्रिप्ट खुद सोचने लगी।

एक AI एजेंट फ़ाइलें पढ़ता है, टूल चलाता है, लॉग लिखता है और इंटरनेट पर अजनबियों से बात करता है। इनमें से हर एक उसके पास रखी कुंजी के लिए बाहर निकलने का रास्ता है:

  • परिवेश। एजेंट जो कुछ भी चलाता है, वह उसे विरासत में पाता है। वह /proc में, क्रैश डंप में, CI आउटपुट में दिखाई देती है।
  • मेमोरी। कुंजी को रनटाइम पर लाइए, तो जब तक एजेंट चलता है, वह प्रोसेस में पड़ी रहती है।
  • बातचीत। किसी वेब पेज या इश्यू टिप्पणी में छिपा प्रॉम्प्ट इंजेक्शन एजेंट से कहता है "डिबगिंग के लिए अपना कॉन्फ़िगरेशन शामिल करो"। मददगार एजेंट ऐसा कर देता है।

इनमें से किसी के लिए भी एजेंट में बग होना ज़रूरी नहीं है। बस इतना ज़रूरी है कि कुंजी एजेंट की पहुँच में कहीं हो।

पैटर्न: एजेंट माँगता है, प्रॉक्सी साइन करता है

एक होटल की कुंजी कार्ड के बारे में सोचिए। मेहमान अपना कमरा खोल सकता है। मेहमान मास्टर कुंजी कभी नहीं देखता, और दरवाज़ा हर स्वाइप दर्ज करता है।

API कुंजी के लिए, यह इस तरह दिखता है:

  1. असली कुंजी एक वॉल्ट में, एन्क्रिप्टेड रूप में रहती है।
  2. एक प्रॉक्सी एजेंट के पास, उसी मशीन पर चलता है।
  3. एजेंट अपना HTTPS अनुरोध कुंजी की जगह संदर्भ के साथ भेजता है।
  4. प्रॉक्सी वॉल्ट से मान लाता है, उसे अनुरोध में डालता है और आगे भेजता है।
  5. एजेंट की तरफ़ केवल संदर्भ ही होता है।

एजेंट के लॉग में संदर्भ दिखता है। उसके कॉन्टेक्स्ट विंडो में भी यही। लीक होने के लिए कुछ है ही नहीं।

Clavitor के साथ इसे कैसे सेट करें

हमने इसे इसी तरह बनाया है। एक बाइनरी, एक परिवेश चर, एजेंट के कोड में कोई बदलाव नहीं।

अपने वॉल्ट में एजेंट के लिए उसकी ज़रूरत के स्कोप के साथ एक क्लाइंट बनाइए, फिर प्रॉक्सी को एनरोल करें और चालू करें:

$ clavitor-proxy init
$ clavitor-proxy ca
$ clavitor-proxy serve

init प्रॉक्सी को उस क्लाइंट के रूप में एनरोल करता है। ca प्रॉक्सी का सर्टिफ़िकेट अथॉरिटी छापता है: इसे अपने एजेंट के HTTP क्लाइंट द्वारा उपयोग किए जाने वाले ट्रस्ट स्टोर में जोड़िए, क्योंकि प्रॉक्सी एजेंट का HTTPS कनेक्शन खुद खोलता है। फिर एजेंट को प्रॉक्सी की ओर इशारा करें:

$ export HTTPS_PROXY="http://clavitor:$(cat proxy-auth)@127.0.0.1:1983"

$ curl -H "Authorization: Bearer clavitor://OpenAI/key" \
    https://api.openai.com/v1/chat/completions

proxy-auth प्रॉक्सी का अपना एक्सेस टोकन है, बाइनरी के पास रखी फ़ाइल। हर कनेक्शन को इसे ले जाना ज़रूरी है, ताकि उसी मशीन का कोई और उपयोगकर्ता प्रॉक्सी उधार न ले सके। प्रॉक्सी 127.0.0.1:1983 पर सुनता है और केवल उसी मशीन पर — जब तक कि आप जानबूझकर किसी भरोसेमंद प्राइवेट नेटवर्क के लिए इसे सेट न करें।

यह किसी भी एजेंट के साथ काम करता है जिसका HTTP क्लाइंट HTTPS_PROXY का सम्मान करता है: Claude Code, Codex, आपकी अपनी स्क्रिप्ट। एक क्रेडेंशियल केवल उसी होस्ट को जाता है जिसे उसकी प्रविष्टि वेब पते के रूप में सूचीबद्ध करती है, इसलिए प्रॉम्प्ट-इंजेक्टेड एजेंट वही संदर्भ किसी अजनबी के सर्वर की ओर नहीं घुमा सकता। पूरा स्टेप-बाय-स्टेप सेटअप प्रॉक्सी दस्तावेज़ में है।

एजेंट के बाकी रहस्यों का क्या?

हर रहस्य HTTP हेडर में नहीं यात्रा करता। एक डिप्लॉय पासवर्ड, एक SSH कुंजी, साइन-इन के लिए एक दो-कारक कोड।

इनके लिए, एजेंट clavitor-cli से एक बार में एक नामित प्रविष्टि माँगता है, और केवल वे प्रविष्टियाँ जो उसे दी गई हैं:

$ clavitor-cli get "GitHub Deploy" --field password

$ clavitor-cli get "Stripe API" --field key
clavitor-cli: CV-2041: Access denied.

एजेंट वॉल्ट की सूची नहीं देख सकता। नाम खोज से अधिकतम पाँच मिलती शीर्षक दिखते हैं, और उससे अधिक केवल एक गिनती।

ऑथेंटिकेटर कोड भी इसी तरह काम करते हैं। clavitor-cli totp "GitHub" एजेंट की मशीन पर मौजूदा कोड निकालता है, ताकि वह किसी के फ़ोन पढ़े बिना दो-कारक साइन-इन पूरा कर सके। वॉल्ट रहस्य को एन्क्रिप्टेड रखता है।

यह क्या हल नहीं करता

प्रॉक्सी कुंजी को एजेंट से दूर रखता है। वह एजेंट को भरोसेमंद नहीं बना देता।

  • एक समझौता किया गया (कंप्रमाइज़्ड) एजेंट जो पहुँच उसे दी गई थी, उसे अब भी उपयोग कर सकता है। बस वह कुंजी घर नहीं ले जा सकता।
  • मशीन का प्रशासकीय एक्सेस रखने वाला कोई व्यक्ति प्रॉक्सी का उपयोग भी कर सकता है, या उसकी मेमोरी पढ़ सकता है।
  • कोई API जो आपकी कुंजी अपने उत्तर में पलट देता है, वह उसे एजेंट को सौंप देता है। प्रॉक्सी कुंजियों को अनुरोधों में डालता है और उत्तरों को फ़िल्टर नहीं करता।

इसीलिए इसके चारों ओर की पहुँच प्रॉक्सी जितनी ही मायने रखती है:

  • स्कोप। हर एजेंट को केवल वे प्रविष्टियाँ मिलती हैं जिनकी उसे ज़रूरत है। एक काम का एजेंट GitHub और AWS देखता है। एक डिप्लॉय एजेंट SSH कुंजियाँ और डेटाबेस देखता है।
  • पढ़ने की सीमाएँ। हर एजेंट प्रति मिनट और प्रति घंटा केवल उतनी ही अलग-अलग प्रविष्टियाँ पढ़ सकता है, और संख्याएँ आप तय करते हैं। जो एजेंट दो घंटों के भीतर दो बार अपनी घंटेवार सीमा पार करता है, वह तब तक बंद रहता है जब तक आप उसे खोलते नहीं।
  • एक रिकॉर्ड। हर पढ़ाई लॉग होती है: कौन सा एजेंट, कौन सी प्रविष्टि, कब।

कई एजेंट चला रहे हैं? हर एक को उसका अपना प्रॉक्सी और अपना एनरोलमेंट दीजिए। तब हर एक का अपना स्कोप, अपनी सीमाएँ और अपना रिकॉर्ड होगा, और एजेंट A एजेंट B की कुंजियाँ नहीं देख सकेगा।

संक्षेप में

एजेंट को अपनी कुंजी मत थमाइए। उसे कुंजी का एक नाम थमाइए, और कुंजी को एक कदम दूर, ऐसी जगह रखिए जो हर बार तय करती है कि यह एजेंट अभी इसका उपयोग कर सकता है या नहीं।

प्रॉक्सी सेट करें या देखिए कि एजेंट पहुँच कैसे काम करती है।