censys python

Biblioteca Censys Python

Un contenedor de API liviano y fácil de usar para las API de Censys (censys.io). Actualmente se admite Python 3.8+. Esta biblioteca ha sido probada en Python 3.8 y 3.x (actualmente versión 3.10).

Aviso: Los puntos finales de Censys Search v1 quedarán obsoletos a partir del 30 de noviembre de 2021. Comience a usar los puntos finales v2 para consultar hosts y certificados y consulte nuestro centro de soporte para obtener recursos.

Características

• Buscar datos de Censys
• Búsquedas masivas de certificados
• Descargar datos masivos
• Administre activos, eventos y semillas en Censys ASM
• Interfaz de línea de comandos

Empezando

La biblioteca se puede instalar usando pip .

pip install censys

Para actualizar usando pip .

pip install --upgrade censys

Alternativamente, puedes instalar la biblioteca usando poetry .

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

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

Tenga en cuenta que se admite la función de autocompletar para 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 configurando ambas variables 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 lugar para comenzar. También puede encontrar más ejemplos en la documentación de uso.

Documentación

Recursos

• Fuente
• Rastreador de problemas
• Registro de cambios
• Documentación
• Discusiones
• Página de inicio de Censys
• Búsqueda Censys

Contribuyendo

Todas las aportaciones (por pequeñas que sean) son siempre bienvenidas. Ver Contribuir a Censys Python

Desarrollo

Este proyecto utiliza la poesía para la gestión de la dependencia. Asegúrese de haber instalado la última versión.

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

Pruebas

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

Licencia

Este software tiene la licencia Apache, versión 2.0.

• Copyright (C) 2024 Censys, Inc.