Biblioteca Python de Censys

[!WARNING] AVISO DE OBSOLESCENCIA: Las APIs de Censys Search v1 y v2 quedarán obsoletas pronto. Migre a la nueva Plataforma Censys.

• 📖 Nueva documentación de la API: https://docs.censys.com/reference/get-started
• 📦 Nuevo SDK de Python: censys/censys-sdk-python
• 🖥️ Nueva herramienta CLI (cencli): censys/cencli
  • ⚠️ Si planea usar la nueva CLI, primero deberá desinstalar la CLI de este paquete, ya que ambos usan el nombre de comando censys

Las APIs de Censys ASM en esta biblioteca NO están obsoletas y seguirán siendo compatibles.

Un envoltorio de API ligero y fácil de usar para las APIs de Censys (censys.io). Actualmente se admite Python 3.9+. Esta biblioteca ha sido probada en Python 3.9 y 3.x (actualmente la versión 3.13).

Características

• Buscar datos de Censys
• Consultas masivas de certificados
• Descargar datos masivos
• Gestionar activos, eventos y semillas en Censys ASM
• Interfaz de línea de comandos

Primeros pasos

La biblioteca se puede instalar usando pip.

pip install censys

Para actualizarla usando pip.

pip install --upgrade censys

Alternativamente, puede instalar la biblioteca usando uv.

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

Opcionalmente, puede habilitar la finalización con tabulador para la CLI agregando esta línea a su ~/.bashrc, ~/.zshrc o equivalente.

Tenga en cuenta que el autocompletado es compatible con los nombres de campos en el comando search.

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

Para configurar sus credenciales de búsqueda, ejecute censys config o establezca las variables de entorno CENSYS_API_ID y 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]

Si tiene una cuenta de Censys ASM, puede configurar sus credenciales de ASM ejecutando censys asm config o estableciendo la variable de entorno CENSYS_ASM_API_KEY.

$ censys asm config

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

Successfully authenticated

Ejemplos

Los ejemplos ubicados en el directorio examples/ son un excelente punto de partida. También puede encontrar más ejemplos en la documentación de uso.

Documentación

Recursos

• Código fuente
• Seguimiento de problemas
• Registro de cambios
• Documentación
• Discusiones
• Página principal de Censys
• Búsqueda de Censys

Contribuciones

Todas las contribuciones (sin importar cuán pequeñas sean) son siempre bienvenidas. Consulte Contribuir a Censys Python

Desarrollo

Este proyecto usa uv para la gestión de dependencias. Asegúrese de haber instalado la última versión.

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

Pruebas

# Ejecutar pruebas
uv run pytest
# Con informe de cobertura
uv run pytest --cov-report html

Licencia

Este software está licenciado bajo Apache License, Version 2.0

• Copyright (C) 2026 Censys, Inc.