الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

مكتبة Censys بايثون

غلاف API سهل الاستخدام وخفيف الوزن لواجهات برمجة تطبيقات Censys (censys.io). بايثون 3.8+ مدعوم حاليًا. تم اختبار هذه المكتبة على Python 3.8 و3.x (الإصدار الحالي 3.10).

إشعار: تم إيقاف نقاط نهاية Censys Search v1 اعتبارًا من 30 نوفمبر 2021. يُرجى البدء في استخدام نقاط نهاية v2 للاستعلام عن المضيفين والشهادات ومراجعة مركز الدعم لدينا للحصول على الموارد.

سمات

  • بحث في بيانات Censys
  • عمليات البحث عن الشهادات المجمعة
  • تنزيل البيانات المجمعة
  • إدارة الأصول والأحداث والبذور في Censys ASM
  • واجهة سطر الأوامر

ابدء

يمكن تثبيت المكتبة باستخدام 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

تطوير

يستخدم هذا المشروع الشعر لإدارة التبعية. يرجى التأكد من أنك قمت بتثبيت أحدث إصدار. 

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

  • حقوق الطبع والنشر (C) 2024 محفوظة لشركة Censys, Inc.
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل