API कुंजियाँ बनाएँ और सुरक्षित रखें
कम-से-कम आवश्यक अधिकार वाली live या sandbox कुंजी बनाएँ, ज़रूरत हो तो IP सीमाएँ लगाएँ और कुंजी सुरक्षित रूप से बदलें या रद्द करें।
- संदर्भ चुनेंव्यक्तिगत या संगठन workspace चुनें।
- अनुमतियाँ तय करेंकुंजी का नाम दें और केवल ज़रूरी scopes चुनें।
- स्रोत सीमित करेंवैकल्पिक रूप से मान्य caller IP पते या network दें।
- एक बार सुरक्षित करेंदिखाए गए secret को सुरक्षित secret manager में रखें।
- पहुँच बनाए रखेंबदलाव के लिए कुंजी rotate करें और पुरानी कुंजी रद्द करें।
Scopes और भूमिकाएँ
API Keys में account read, AI inference और training, AI hosting jobs, model transformation jobs, blockchain services तथा support-ticket अनुमतियों सहित समर्थित scopes का विवरण है। संगठन में owner और administrator कुंजियाँ सँभालते हैं; सदस्य उन्हें देख सकते हैं, प्रबंधित नहीं। जिस संदर्भ में credential चाहिए वही चुनें, क्योंकि दृश्यता और अधिकार उसी संदर्भ तक सीमित हैं।
- API Keys खोलने से पहले सही संगठन चुनें।
- Scope विवरण पढ़कर केवल आवश्यक operations चुनें।
- प्रबंधन उपलब्ध न हो तो owner या administrator से कहें।
Live कुंजी बनाएँ
सामान्य कुंजी के लिए 2–120 वर्ण का नाम, कम-से-कम एक सूचीबद्ध scope और वैकल्पिक IP allowlist चाहिए। मान्य IP पते या CIDR network, दिखाई गई सीमा के भीतर, हर पंक्ति में एक दें। खाली सूची किसी भी source IP की अनुमति देती है। कुंजी का पूरा plaintext केवल बनाने के बाद एक बार दिखता है; डेटाबेस में केवल hash रहता है, इसलिए बाद में वापस नहीं पाया जा सकता।
- अनुप्रयोग या काम के परिवेश के अनुसार नाम रखें।
- न्यूनतम scopes और आवश्यक स्थिर source पते चुनें।
- दिखाया मान स्वीकृत सुरक्षित भंडार में सीधे रखें।
Sandbox inference कुंजी
Dashboard ऐसी sandbox कुंजी बना सकता है जो केवल AI inference और वहाँ प्रकाशित मासिक अनुरोध सीमा तक सीमित हो। हर खाते या संगठन संदर्भ में एक ही सक्रिय sandbox कुंजी की अनुमति है। यदि पहले से है तो उसका उपयोग करें या नई बनाने से पहले पुरानी रद्द करें। Sandbox और live credentials अलग रखें; sandbox सीमा को उत्पादन सेवा की गारंटी न मानें।
- इस संदर्भ में सक्रिय sandbox कुंजी खोजें।
- Inference परीक्षण के लिए एक बनाएँ और अलग सुरक्षित रखें।
- सीमा देखते रहें और ज़रूरत खत्म होने पर रद्द करें।
Secret सुरक्षित रखें
पूरी कुंजी केवल बनाते या बदलते समय दिखाई जाती है; तभी कॉपी करें। उसे सीमित पहुँच वाले encrypted secret manager में रखें। Source code, browser code, logs, screenshots, सहायता tickets या chat में कभी न रखें। एक बार दिखाई कुंजी छूट जाए या न मिले तो उसे बदलें; सहायता plaintext वापस नहीं दे सकती।
- दिखाया मान सीधे सुरक्षित भंडार में रखें।
- उपभोक्ता अनुप्रयोग को उसके दस्तावेज़ित settings से configure करें।
- उजागर होने या खोने की आशंका हो तो तुरंत बदलें।
Rotate या revoke करें
Rotation पुरानी credential रद्द करके उसी नाम, tier, scopes और allowlist वाली नई कुंजी बनाता है। नया मान एक बार दिखता है; निर्भर सेवाएँ शीघ्र अपडेट करें क्योंकि पुरानी कुंजी काम करना बंद कर देती है। Revocation चुनी कुंजी को बिना बदले निष्क्रिय करता है। इनमें से कोई कदम भेजने से पहले सही कुंजी और संदर्भ की पुष्टि करें।
- नियमित rotation से पहले सभी उपभोक्ता खोजें।
- नया मान सुरक्षित रखकर निर्भर सेवाएँ अपडेट करें।
- पुरानी कुंजियाँ रद्द करें और dashboard स्थिति जाँचें।
अस्वीकृत अनुरोध का कारण खोजें
गलत स्वरूप या रद्द कुंजी, निष्क्रिय उपयोगकर्ता, allowlist से बाहर source IP या अनुपस्थित scope होने पर अनुरोध अस्वीकृत हो सकता है। Sandbox अनुरोध मासिक सीमा भी पार कर सकते हैं। संदर्भ, तैनात secret का संस्करण, caller का egress पता और आवश्यक scope जाँचें। मदद माँगते समय secret साझा न करें।
- पुष्टि करें कि कुंजी सक्रिय है और operation scope रखती है।
- वास्तविक source IP और sandbox सीमा मिलाएँ।
- गलत या उजागर कुंजी rotate करें; केवल संवेदनशीलता हटाए संदर्भ दें।
अक्सर पूछे जाने वाले प्रश्न
क्या बाद में कुंजी फिर देख सकता हूँ?
नहीं। नया मान पाने के लिए उसे rotate करें।
कौन-से scopes दूँ?
केवल integration के लिए आवश्यक सूचीबद्ध scopes।
क्या सदस्य संगठन कुंजी बना सकते हैं?
नहीं। संगठन कुंजियाँ owner और administrator सँभालते हैं।
क्या rotation के बाद पुरानी कुंजी चलती रहती है?
नहीं। Rotation पुरानी को रद्द कर नई बनाता है।
Caller IP बदल जाए तो?
अधिकृत कुंजी प्रबंधक से allowlist अपडेट कराएँ।
क्या दो sandbox कुंजियाँ रख सकता हूँ?
हर संदर्भ में केवल एक सक्रिय sandbox कुंजी।