🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW
यह पृष्ठ प्रोजेक्ट के स्थानीय .env व्यवहार और OmniRoute विकसित करते समय एनवायरनमेंट फ़ाइलों तथा सीक्रेट्स को संभालने के तरीके की व्याख्या करता है।
डेवलपर की सुविधा के लिए प्रोजेक्ट npm install / postinstall के दौरान एक स्थानीय .env फ़ाइल जनरेट कर सकता है। यह फ़ाइल केवल स्थानीय डेवलपमेंट और परीक्षण के लिए है तथा इसे कभी भी वर्ज़न कंट्रोल में कमिट नहीं किया जाना चाहिए।
मुख्य बिंदु:
- रिपॉज़िटरी की
.gitignoreफ़ाइल पहले से ही.env*फ़ाइलों को अनदेखा करती है (.gitignoreप्रविष्टि देखें)। इस नियम को तब तक न हटाएँ या बदलें, जब तक आप जानबूझकर किसी विशिष्ट उदाहरण फ़ाइल को कमिट नहीं करना चाहते और उसके लिए आपके पास दस्तावेज़ीकृत प्रक्रिया न हो। - यदि कोई वास्तविक सीक्रेट गलती से रेपो में कमिट हो जाता है, तो क्रेडेंशियल को तुरंत रोटेट/रिवोक करें और उसे रिपॉज़िटरी इतिहास से हटाएँ (उदाहरण के लिए,
git filter-repoया किसी समकक्ष सुधारात्मक वर्कफ़्लो का उपयोग करके)। सहायता की आवश्यकता होने पर सुरक्षा/संपर्क स्वामी से संपर्क करें। - CI और प्रोडक्शन के लिए, सीक्रेट्स को फ़ाइलों में कमिट करने के बजाय CI सीक्रेट्स या किसी सीक्रेट्स मैनेजर (GitHub Actions Secrets, Azure Key Vault, HashiCorp Vault आदि) का उपयोग करें।
.envको केवल अपने स्थानीय वर्कस्पेस में रखें। आवश्यक वेरिएबल्स और स्वीकार्य उदाहरण मानों को दस्तावेज़ीकृत करने के लिए.env.example(जो पहले से ट्रैक की गई है) का उपयोग करें।- स्थानीय रूप से ऐसे परीक्षण चलाते समय जिनमें सीक्रेट जैसे मान आवश्यक हों, वास्तविक क्रेडेंशियल्स के बजाय कृत्रिम प्लेसहोल्डर्स या रनटाइम पर जनरेट की गई अस्थायी कुंजियों को प्राथमिकता दें।
- प्लेसहोल्डर्स का उपयोग करने वाले परीक्षणों में एक संक्षिप्त टिप्पणी जोड़ें, ताकि समीक्षक समझ सकें कि फ़िक्स्चर कृत्रिम है।
- कुछ कंपाइल की गई या बाइनरी एसेट्स (उदाहरण के लिए, एम्बेड किए गए base64 WASM ब्लॉब्स) में ऐसे ASCII सबस्ट्रिंग हो सकते हैं जो क्रेडेंशियल्स जैसे दिखाई देते हैं और टेक्स्ट-आधारित सीक्रेट स्कैनर्स को ट्रिगर कर सकते हैं। यदि ये एसेट्स वैध हैं, तो या तो इन्हें स्कैनर की allowlist में चिह्नित करें या स्कैनर कॉन्फ़िगरेशन में संबंधित डायरेक्टरियों को बाहर रखें।
- कुंजी को तुरंत रोटेट/रिवोक करें।
- सीक्रेट को इतिहास से हटाएँ और आवश्यकता होने पर साफ़ की गई ब्रांच को फ़ोर्स-पुश करें।
- अनुरक्षकों को सूचित करें और अपने संगठन की घटना-प्रतिक्रिया चेकलिस्ट का पालन करें।