censys/censys-pythonCensys APIs के लिए एक उपयोग में आसान और हल्का API रैपर।
[!चेतावनी] बहिष्करण सूचना: Censys Search v1 और v2 API जल्द ही बंद हो जाएंगी। कृपया नए Censys Platform पर माइग्रेट करें।
- 📖 नया API दस्तावेज़ीकरण: https://docs.censys.com/reference/get-started#/
- 📦 नया Python SDK:
pip install censys-platformसे इंस्टॉल करें - https://pypi.org/project/censys-platform/- 🖥️ नया CLI टूल (
cencli): https://docs.censys.com/docs/platform-cli
- ⚠️ यदि आप नए CLI का उपयोग करने की योजना बना रहे हैं, तो आपको पहले इस पैकेज के CLI को अनइंस्टॉल करना होगा क्योंकि दोनों
censysकमांड नाम का उपयोग करते हैंइस लाइब्रेरी में Censys ASM API बहिष्कृत नहीं हैं और समर्थित रहेंगे।
Censys APIs (censys.io) के लिए एक आसान और हल्का API रैपर। वर्तमान में Python 3.8+ समर्थित है। इस लाइब्रेरी का Python 3.8 और 3.x (वर्तमान संस्करण 3.10) पर परीक्षण किया गया है।
लाइब्रेरी को pip का उपयोग करके इंस्टॉल किया जा सकता है।
pip install censys
pip का उपयोग करके अपग्रेड करने के लिए:
pip install --upgrade censys
वैकल्पिक रूप से, आप poetry का उपयोग करके लाइब्रेरी इंस्टॉल कर सकते हैं।
git clone https://github.com/censys/censys-python.git
cd censys-python/
poetry install
वैकल्पिक रूप से, आप अपनी ~/.bashrc, ~/.zshrc, या समकक्ष फ़ाइल में यह पंक्ति जोड़कर CLI के लिए टैब कम्प्लीशन सक्षम कर सकते हैं।
कृपया ध्यान दें कि
searchकमांड में फ़ील्ड नामों के लिए ऑटोकम्प्लीट समर्थित है।
eval "$(register-python-argcomplete censys)"
अपने खोज क्रेडेंशियल्स कॉन्फ़िगर करने के लिए censys config चलाएँ या CENSYS_API_ID और CENSYS_API_SECRET एनवायरनमेंट वेरिएबल्स दोनों सेट करें।
$ censys config
Censys API ID: XXX
Censys API Secret: XXX
क्या आप रंगीन आउटपुट चाहते हैं? [y/n]: y
आपके@email.com के लिए सफलतापूर्वक प्रमाणित किया गया
यदि आपके पास Censys ASM खाता है, तो आप censys asm config चलाकर या CENSYS_ASM_API_KEY एनवायरनमेंट वेरिएबल सेट करके अपने ASM क्रेडेंशियल्स कॉन्फ़िगर कर सकते हैं।
$ censys asm config
Censys ASM API Key: XXX
क्या आप रंगीन आउटपुट चाहते हैं? [y/n]: y
सफलतापूर्वक प्रमाणित किया गया
examples/ (उदाहरण/) निर्देशिका में स्थित उदाहरण शुरू करने के लिए एक अच्छी जगह हैं। आप उपयोग दस्तावेज़ीकरण में और अधिक उदाहरण पा सकते हैं।
सभी योगदान (चाहे वे कितने भी छोटे क्यों न हों) हमेशा स्वागत योग्य हैं। Censys Python में योगदान देखें
यह प्रोजेक्ट निर्भरता प्रबंधन के लिए poetry का उपयोग करता है। कृपया सुनिश्चित करें कि आपने नवीनतम संस्करण स्थापित किया है।
git clone [email protected]:censys/censys-python.git
cd censys-python/
poetry install
# परीक्षण चलाएँ
poetry run pytest
# कवरेज रिपोर्ट के साथ
poetry run pytest --cov-report html
यह सॉफ़्टवेयर Apache License, Version 2.0 के तहत लाइसेंस प्राप्त है।