कुंजी सिर्फ़ एक बार दिखती है: टीम API कुंजियों को कैसे रखे, रोटेट करे और रद्द करे
जब आप SimAggregator के पैनल में API कुंजी बनाते हैं, तो कुंजी की स्ट्रिंग स्क्रीन पर ठीक एक बार दिखती है। अगर आपने उसे कॉपी किए बिना विंडो बंद कर दी, तो वह स्ट्रिंग दोबारा कोई नहीं देख सकता, हम भी नहीं: प्लेटफ़ॉर्म कुंजी का सिर्फ़ फ़िंगरप्रिंट रखता है, खुद स्ट्रिंग नहीं। खोई हुई कुंजी वापस नहीं मिलती, सिर्फ़ बदली जा सकती है: आप नई बनाते हैं और पुरानी रद्द कर देते हैं। इसीलिए रोटेशन और रद्द करने का तरीका पहले से तय कर लेना फ़ायदेमंद है, इससे पहले कि कुछ लीक हो।
हर एनवायरनमेंट और हर सर्विस के लिए अलग कुंजी
कुंजी आपके खाते की ओर से काम करती है और उसका बैलेंस खर्च करती है: जिसके पास स्ट्रिंग है, वह आपके खर्च पर नंबर खरीद सकता है। अगर "हर काम के लिए" एक ही साझा कुंजी है, तो लीक होने पर आप अंदाज़ा ही लगाते रह जाते हैं कि यह कहाँ हुआ, और कुंजी रद्द करते ही सारे इंटीग्रेशन एक साथ बंद हो जाते हैं।
पैनल में आप कई कुंजियाँ बना सकते हैं और हर एक को नाम दे सकते हैं। हम "एनवायरनमेंट + सर्विस" वाला तरीका सुझाते हैं: prod-bot, staging-bot, ci-tests। नाम से तुरंत पता चल जाता है कि कुंजी रद्द करने पर क्या बंद होगा और अजीब गतिविधि के बारे में किससे पूछना है। API की 600 अनुरोध प्रति मिनट की सीमा हर कुंजी पर अलग लागू होती है, इसलिए CI का टेस्ट रन आपकी प्रोडक्शन सर्विस के अनुरोध नहीं खाता।
CI के साथ एक पेच है: वहाँ से बुलाया गया getNumber उसी बैलेंस से असली नंबर खरीदता है। ऐसा ऑर्डर कम से कम एक मिनट बीतने से पहले रद्द नहीं किया जा सकता। बिना कोड के रद्द हुए ऑर्डर पिछले 7 दिनों में कोड पाने वाले ऑर्डर का आपका हिस्सा घटा देते हैं, और आपके खाते की साख से एक साथ चल रहे ऑर्डर की सीमा तय होती है, जो CI और प्रोडक्शन बॉट के बीच साझा है। स्मोक चेक के लिए आम तौर पर getBalance और getPrices काफ़ी होते हैं।
कुंजी की स्ट्रिंग कहाँ रखें
कुंजी बनाते ही उसे सीक्रेट मैनेजर में या CI के ऐसे सुरक्षित वेरिएबल में रखें जो लॉग में छिपा दिए जाते हैं। उसे रिपॉज़िटरी में, "बस अभी के लिए" कमिट की गई .env फ़ाइल में, टीम की चैट में या टिकट में न डालें। इंटीग्रेशन बनाने वाले डेवलपर को आम तौर पर प्रोडक्शन कुंजी की स्ट्रिंग की ज़रूरत नहीं होती: सर्विस शुरू होते समय उसे सीक्रेट स्टोर से खुद ले लेती है।
API sms-activate के अनुकूल है और सिर्फ़ GET अनुरोध स्वीकार करता है, इसलिए कुंजी क्वेरी स्ट्रिंग में जाती है। पक्का करें कि आपका HTTP क्लाइंट, प्रॉक्सी और एक्सेस लॉग अनुरोध का पूरा URL दर्ज न करें। लॉग लंबे समय तक रखे जाते हैं और उन्हें कई लोग पढ़ सकते हैं, इसलिए जो भी कुंजी लॉग में पहुँच जाए, उसे लीक हुई मानें।
रोटेशन: पहले नई कुंजी, फिर पुरानी रद्द
रोटेशन का मतलब पैनल में दो काम हैं: नई कुंजी बनाना और पुरानी रद्द करना। इसी क्रम में करने पर पुरानी कुंजी तब तक काम करती रहती है जब तक सर्विस नई पर न चली जाए, और कोई अनुरोध विफल नहीं होता।
- नई कुंजी बनाएँ, जिसके नाम में वही काम लिखा हो, जैसे
prod-bot-2। - उसे सीक्रेट मैनेजर में पुराने मान की जगह सहेजें।
- सर्विस रीस्टार्ट करें, ताकि वह नई कुंजी उठा ले।
- पैनल में जाँचें: नई कुंजी पर अब आखिरी इस्तेमाल की तारीख दिख रही है, और पुरानी कुंजी की तारीख बदलना बंद हो गई है।
- पुरानी कुंजी रद्द करें।
तय समय से पहले रोटेशन करें, अगर:
- कुंजी देख चुका कोई व्यक्ति टीम छोड़ गया है;
- कुंजी किसी लॉग, स्क्रीनशॉट, चैट या रिपॉज़िटरी में पहुँच गई है;
- आप किसी दूसरे होस्ट या CI पर चले गए हैं।
तय समय वाला रोटेशन उसी शेड्यूल से जोड़ें जिस पर आप अपने बाकी सीक्रेट बदलते हैं।
आखिरी इस्तेमाल की तारीख से ऑडिट
रिलीज़ से पहले या जब भी आप एक्सेस की समीक्षा करें, कुंजियों की सूची खोलें। जो कुंजी लंबे समय से इस्तेमाल नहीं हुई, वह शायद किसी बंद हो चुके प्रोजेक्ट से बची है, इसलिए उसे रद्द कर दें। अगर staging-bot कुंजी इस्तेमाल हो रही है, जबकि स्टेजिंग बॉट खुद एक हफ़्ते पहले बंद कर दिया गया था, तो कुंजी तुरंत रद्द करें और पता लगाएँ कि अनुरोध कहाँ से आ रहे हैं। जिस कुंजी का नाम समझ नहीं आता, उसे रद्द कर देना भी यह अंदाज़ा लगाने से आसान है कि वह किसकी है। अगर वह किसी के काम की है, तो मालिक को अपनी सर्विस से पता चल जाएगा और वह साफ़ नाम वाली नई कुंजी बना लेगा।
खुद खाते की सुरक्षा करें
API कुंजी उतनी ही सुरक्षित है जितना आपका खाता: जो भी पैनल में साइन इन कर लेता है, वह अपने लिए नई कुंजी बनाकर आपका बैलेंस खर्च कर सकता है। इसलिए दो-चरणीय प्रमाणीकरण चालू करें: ऑथेंटिकेटर ऐप का TOTP कोड साइन-इन पेज पर सेट होता है, और पासवर्ड भी वहीं बदला जाता है। अगर आपको शक है कि आपके खाते में कोई और घुसा है, तो दूसरे डिवाइस पर सत्र समाप्त करें, पासवर्ड बदलें और सभी कुंजियाँ रोटेट करें। यही कदम तब भी उठाएँ जब पैनल का एक्सेस रखने वाला कोई व्यक्ति टीम छोड़े।
शुरुआत के लिए साइन-इन पेज पर 2FA चालू करें। फिर पैनल में prod, staging और CI के लिए अलग-अलग नाम वाली कुंजियाँ बनाएँ, उन्हें सीक्रेट मैनेजर में रखें, और अगर आपके पास कोई साझा कुंजी थी, तो उसे रद्द कर दें।