Wrapper API ที่ใช้งานง่ายและมีน้ำหนักเบาสำหรับ Censys API (censys.io) ปัจจุบันรองรับ Python 3.8+ ไลบรารีนี้ได้รับการทดสอบบน Python 3.8 และ 3.x (ปัจจุบันเป็นเวอร์ชัน 3.10)
หมายเหตุ: ตำแหน่งข้อมูล Censys Search v1 เลิกใช้งานแล้วในวันที่ 30 พฤศจิกายน 2021 โปรดเริ่มใช้ตำแหน่งข้อมูล v2 เพื่อค้นหาโฮสต์และใบรับรอง และตรวจสอบศูนย์สนับสนุนของเราเพื่อดูทรัพยากร
สามารถติดตั้งไลบรารีได้โดยใช้ 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 License เวอร์ชัน 2.0