censys python

Perpustakaan Censys Python

Pembungkus API yang mudah digunakan dan ringan untuk API Censys (censys.io). Python 3.8+ saat ini didukung. Pustaka ini telah diuji pada Python 3.8 dan 3.x (Saat ini versi 3.10).

Pemberitahuan: Endpoint Censys Search v1 tidak digunakan lagi mulai 30 November 2021. Silakan mulai menggunakan endpoint v2 untuk menanyakan host dan sertifikat, lalu lihat pusat dukungan kami untuk mendapatkan sumber daya.

Fitur

• Cari data Censys
• Pencarian Sertifikat Massal
• Unduh Data Massal
• Kelola aset, acara, dan benih di Censys ASM
• Antarmuka baris perintah

Memulai

Perpustakaan dapat diinstal menggunakan pip .

pip install censys

Untuk meningkatkan menggunakan pip .

pip install --upgrade censys

Alternatifnya, Anda dapat menginstal perpustakaan menggunakan poetry .

git clone https://github.com/censys/censys-python.git
cd censys-python/
poetry install

Secara opsional, Anda dapat mengaktifkan penyelesaian tab untuk CLI dengan menambahkan baris ini ke ~/.bashrc , ~/.zshrc , atau yang setara.

Harap dicatat bahwa pelengkapan otomatis didukung untuk nama bidang dalam perintah search .

 eval " $( register-python-argcomplete censys ) "

Untuk mengonfigurasi kredensial pencarian Anda, jalankan censys config atau atur variabel lingkungan CENSYS_API_ID dan 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]

Jika Anda memiliki akun Censys ASM, Anda dapat mengonfigurasi kredensial ASM Anda dengan menjalankan censys asm config atau mengatur kedua variabel lingkungan CENSYS_ASM_API_KEY .

$ censys asm config

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

Successfully authenticated

Contoh

Contoh yang terletak di direktori examples/ adalah tempat yang bagus untuk memulai. Anda juga dapat menemukan contoh lainnya di dokumentasi penggunaan.

Dokumentasi

Sumber daya

• Sumber
• Pelacak Masalah
• log perubahan
• Dokumentasi
• Diskusi
• Beranda Censys
• Pencarian Censys

Berkontribusi

Semua kontribusi (sekecil apa pun) selalu diterima. Lihat Berkontribusi pada Censys Python

Perkembangan

Proyek ini menggunakan puisi untuk manajemen ketergantungan. Harap pastikan Anda telah menginstal versi terbaru.

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

Pengujian

 # Run tests
poetry run pytest
# With coverage report
poetry run pytest --cov-report html

Lisensi

Perangkat lunak ini dilisensikan di bawah Lisensi Apache, Versi 2.0

• Hak Cipta (C) 2024 Censys, Inc.