Libreria Python di Censys

[!WARNING] AVVISO DI DEPRECAZIONE: Le API Censys Search v1 e v2 verranno presto deprecate. Migra al nuovo Censys Platform.

• 📖 Nuova documentazione API: https://docs.censys.com/reference/get-started#/
• 📦 Nuovo SDK Python: Installa con pip install censys-platform - https://pypi.org/project/censys-platform/
• 🖥️ Nuovo strumento CLI (cencli): https://docs.censys.com/docs/platform-cli
  • ⚠️ Se intendi usare la nuova CLI, dovrai prima disinstallare la CLI di questo pacchetto poiché entrambi usano il nome del comando censys

Le API Censys ASM in questa libreria NON sono deprecate e continueranno ad essere supportate.

Un wrapper API leggero e facile da usare per le API Censys (censys.io). Python 3.8+ è attualmente supportato. Questa libreria è stata testata su Python 3.8 e 3.x (attualmente versione 3.10).

Caratteristiche

• Cerca dati Censys
• Ricerca massiva di certificati
• Scarica dati in blocco
• Gestisci asset, eventi e seed in Censys ASM
• Interfaccia a riga di comando

Per iniziare

La libreria può essere installata usando pip.

pip install censys

Per aggiornare usando pip.

pip install --upgrade censys

In alternativa, puoi installare la libreria usando poetry.

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

Opzionalmente, puoi abilitare il completamento tramite tab per la CLI aggiungendo questa riga al tuo ~/.bashrc, ~/.zshrc, o equivalente.

Nota che l'autocompletamento è supportato per i nomi dei campi nel comando search.

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

Per configurare le tue credenziali di ricerca esegui censys config o imposta le variabili d'ambiente CENSYS_API_ID e 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]

Se hai un account Censys ASM, puoi configurare le tue credenziali ASM eseguendo censys asm config o impostando la variabile d'ambiente CENSYS_ASM_API_KEY.

$ censys asm config

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

Successfully authenticated

Esempi

Gli esempi situati nella directory examples/ sono un ottimo punto di partenza. Puoi anche trovare altri esempi nella documentazione d'uso.

Documentazione

Risorse

• Codice sorgente
• Tracker dei problemi
• Registro delle modifiche
• Documentazione
• Discussioni
• Homepage di Censys
• Ricerca Censys

Contribuire

Tutti i contributi (per quanto piccoli) sono sempre benvenuti. Vedi Contribuire a Censys Python

Sviluppo

Questo progetto usa poetry per la gestione delle dipendenze. Assicurati di aver installato l'ultima versione.

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

Test

# Esegui i test
poetry run pytest
# Con report di copertura
poetry run pytest --cov-report html

Licenza

Questo software è concesso in licenza secondo Apache License, Version 2.0

• Copyright (C) 2024 Censys, Inc.