Libreria Python Censys

[!WARNING] AVVISO DI DEPRECAZIONE: Le API Censys Search v1 e v2 saranno presto deprecate. Si prega di migrare alla nuova Censys Platform.

• 📖 Nuova Documentazione API: https://docs.censys.com/reference/get-started
• 📦 Nuovo SDK Python: censys/censys-sdk-python
• 🖥️ Nuovo Strumento CLI (cencli): censys/cencli
  • ⚠️ Se intendi utilizzare la nuova CLI, dovrai prima disinstallare la CLI di questo pacchetto poiché entrambe utilizzano il nome di comando censys

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

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

Caratteristiche

• Ricerca dati Censys
• Ricerca bulk dei certificati
• Download dei dati bulk
• Gestione di asset, eventi e seed in Censys ASM
• Interfaccia a riga di comando

Per Iniziare

La libreria può essere installata utilizzando pip.

pip install censys

Per aggiornarla utilizzando pip.

pip install --upgrade censys

In alternativa, puoi installare la libreria utilizzando uv.

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

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

Si prega di notare che il completamento automatico è supportato per i nomi dei campi nel comando search.

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

Per configurare le tue credenziali di ricerca esegui censys config oppure imposta entrambe 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 disponi di un account Censys ASM, puoi configurare le tue credenziali ASM eseguendo censys asm config oppure 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 nella directory examples/ sono un ottimo punto di partenza. Puoi anche trovare ulteriori esempi nella documentazione di utilizzo.

Documentazione

Risorse

• Sorgente
• Issue Tracker
• Changelog
• Documentazione
• Discussioni
• Homepage Censys
• Censys Search

Contributi

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

Sviluppo

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

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

Test

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

Licenza

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

• Copyright (C) 2026 Censys, Inc.