مكتبة Censys بلغة Python

[!WARNING] إشعار إهمال: سيتم إهمال واجهات برمجة تطبيقات Censys Search الإصدار 1 و2 قريبًا. يرجى الانتقال إلى منصة Censys الجديدة.

• 📖 توثيق واجهة برمجة التطبيقات الجديد: https://docs.censys.com/reference/get-started
• 📦 حزمة Python SDK الجديدة: censys/censys-sdk-python
• 🖥️ أداة سطر الأوامر الجديدة (cencli): censys/cencli
  • ⚠️ إذا كنت تخطط لاستخدام أداة سطر الأوامر الجديدة، فستحتاج إلى إلغاء تثبيت أداة سطر الأوامر الخاصة بهذه الحزمة أولاً حيث يستخدم كلاهما اسم الأمر censys

واجهات برمجة تطبيقات Censys ASM في هذه المكتبة ليست مهملة وستستمر في الحصول على الدعم.

غلاف API خفيف وسهل الاستخدام لواجهات برمجة تطبيقات Censys (censys.io). الإصدار 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 أو ما يعادلهما.

يرجى ملاحظة أن الإكمال التلقائي مدعوم لأسماء الحقول في أمر 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
• بحث Censys

المساهمة

جميع المساهمات (مهما كانت صغيرة) مرحب بها دائمًا. راجع المساهمة في 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، الإصدار 2.0

• حقوق النشر (C) 2026 Censys, Inc.