Censys Python लाइब्रेरी

[!WARNING] अप्रचलन सूचना: Censys Search v1 और v2 APIs जल्द ही अप्रचलित हो जाएंगी। कृपया नए Censys Platform पर माइग्रेट करें।

• 📖 नया API दस्तावेज़ीकरण: https://docs.censys.com/reference/get-started
• 📦 नया Python SDK: censys/censys-sdk-python
• 🖥️ नया CLI टूल (cencli): censys/cencli
  • ⚠️ यदि आप नए CLI का उपयोग करने की योजना बना रहे हैं, तो आपको पहले इस पैकेज का CLI अनइंस्टॉल करना होगा क्योंकि दोनों censys कमांड नाम का उपयोग करते हैं

इस लाइब्रेरी में Censys ASM APIs अप्रचलित नहीं हैं और इन्हें समर्थित किया जाता रहेगा।

Censys APIs (censys.io) के लिए एक आसान-से-उपयोग और हल्का API रैपर। Python 3.9+ वर्तमान में समर्थित है। इस लाइब्रेरी का परीक्षण Python 3.9 और 3.x (वर्तमान संस्करण 3.13) पर किया गया है।

विशेषताएँ

• Censys डेटा खोजें
• बल्क प्रमाणपत्र लुकअप
• बल्क डेटा डाउनलोड करें
• Censys ASM में एसेट, इवेंट और सीड्स प्रबंधित करें
• कमांड-लाइन इंटरफ़ेस

आरंभ करना

लाइब्रेरी को pip का उपयोग करके इंस्टॉल किया जा सकता है।

pip install censys

pip का उपयोग करके अपग्रेड करने के लिए।

pip install --upgrade censys

वैकल्पिक रूप से, आप uv का उपयोग करके लाइब्रेरी इंस्टॉल कर सकते हैं।

git clone https://github.com/censys/censys-python.git
cd censys-python/
uv 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
Do you want color output? [y/n]: y

Successfully authenticated for [email protected]

यदि आपके पास Censys ASM खाता है, तो आप censys asm config चलाकर या CENSYS_ASM_API_KEY पर्यावरण चर सेट करके अपने ASM क्रेडेंशियल्स कॉन्फ़िगर कर सकते हैं।

$ censys asm config

Censys ASM API Key: XXX
Do you want color output? [y/n]: y

Successfully authenticated

उदाहरण

examples/ निर्देशिका में स्थित उदाहरण शुरू करने के लिए एक बेहतरीन जगह हैं। आप उपयोग दस्तावेज़ीकरण में अधिक उदाहरण भी पा सकते हैं।

दस्तावेज़ीकरण

संसाधन

• स्रोत
• इश्यू ट्रैकर
• चेंजलॉग
• दस्तावेज़ीकरण
• चर्चाएँ
• Censys होमपेज
• Censys Search

योगदान

सभी योगदान (चाहे कितने भी छोटे हों) हमेशा स्वागत योग्य हैं। देखें Censys Python में योगदान

विकास

यह प्रोजेक्ट निर्भरता प्रबंधन के लिए uv का उपयोग करता है। कृपया सुनिश्चित करें कि आपने नवीनतम संस्करण इंस्टॉल किया है।

git clone [email protected]:censys/censys-python.git
cd censys-python/
uv install

परीक्षण

# टेस्ट चलाएँ
uv run pytest
# कवरेज रिपोर्ट के साथ
uv run pytest --cov-report html

लाइसेंस

यह सॉफ़्टवेयर Apache License, Version 2.0 के तहत लाइसेंस प्राप्त है

• कॉपीराइट (C) 2026 Censys, Inc.