censys/censys-pythonغلاف واجهة برمجة تطبيقات خفيف الوزن وسهل الاستخدام لواجهات برمجة تطبيقات Censys.
[!WARNING] إشعار إيقاف التشغيل: سيتم إيقاف تشغيل واجهات برمجة تطبيقات Censys Search v1 و v2 قريبًا. يرجى الترحيل إلى Censys Platform الجديد.
- 📖 توثيق واجهة برمجة التطبيقات الجديد: 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 في هذه المكتبة ليست موقوفة وستظل مدعومة.
غلاف واجهة برمجة تطبيقات خفيف وسهل الاستخدام لواجهات Censys API (censys.io). يتم دعم 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
اختياريًا، يمكنك تمكين الإكمال التلقائي بالتبويب لـ CLI عن طريق إضافة هذا السطر إلى ~/.bashrc أو ~/.zshrc أو ما يعادلهما.
يرجى ملاحظة أن الإكمال التلقائي مدعوم لأسماء الحقول في أمر
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، يمكنك تكوين بيانات اعتماد ASM الخاصة بك عن طريق تشغيل censys asm config أو تعيين متغير البيئة CENSYS_ASM_API_KEY.
$ censys asm config
Censys ASM API Key: XXX
Do you want color output? [y/n]: y
Successfully authenticated
الأمثلة الموجودة في دليل examples/ هي مكان رائع للبدء. يمكنك أيضًا العثور على أمثلة إضافية في توثيق الاستخدام.
جميع المساهمات (مهما كانت صغيرة) مرحب بها دائمًا. انظر المساهمة في Censys Python
يستخدم هذا المشروع poetry لإدارة التبعيات. يرجى التأكد من تثبيت أحدث إصدار.
git clone [email protected]:censys/censys-python.git
cd censys-python/
poetry install
# Run tests
poetry run pytest
# With coverage report
poetry run pytest --cov-report html
هذا البرنامج مرخص بموجب رخصة Apache، الإصدار 2.0