censys python

Bibliothèque Python Censys

Un wrapper d'API facile à utiliser et léger pour les API Censys (censys.io). Python 3.8+ est actuellement pris en charge. Cette bibliothèque a été testée sur Python 3.8 et 3.x (actuellement version 3.10).

Remarque : Les points de terminaison Censys Search v1 sont obsolètes depuis le 30 novembre 2021. Veuillez commencer à utiliser les points de terminaison v2 pour interroger les hôtes et les certificats et consulter notre centre d'assistance pour les ressources.

Caractéristiques

• Rechercher des données Censys
• Recherches groupées de certificats
• Télécharger des données en masse
• Gérer les actifs, les événements et les graines dans Censys ASM
• Interface de ligne de commande

Commencer

La bibliothèque peut être installée en utilisant pip .

pip install censys

Pour mettre à niveau en utilisant pip .

pip install --upgrade censys

Alternativement, vous pouvez installer la bibliothèque en utilisant poetry .

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

Vous pouvez éventuellement activer la complétion par tabulation pour la CLI en ajoutant cette ligne à votre ~/.bashrc , ~/.zshrc ou équivalent.

Veuillez noter que la saisie semi-automatique est prise en charge pour les noms de champs dans la commande search .

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

Pour configurer vos informations d'identification de recherche, exécutez censys config ou définissez les variables d'environnement CENSYS_API_ID et 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 vous disposez d'un compte Censys ASM, vous pouvez configurer vos informations d'identification ASM en exécutant censys asm config ou en définissant les deux variables d'environnement CENSYS_ASM_API_KEY .

$ censys asm config

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

Successfully authenticated

Exemples

Les exemples situés dans le répertoire examples/ sont un excellent point de départ. Vous pouvez également trouver plus d'exemples dans la documentation d'utilisation.

Documentation

Ressources

• Source
• Suivi des problèmes
• Journal des modifications
• Documentation
• Discussions
• Page d'accueil de Censys
• Recherche Censys

Contribuer

Toutes les contributions (aussi petites soient-elles) sont toujours les bienvenues. Voir Contribuer à Censys Python

Développement

Ce projet utilise la poésie pour la gestion des dépendances. Veuillez vous assurer que vous avez installé la dernière version.

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

Essai

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

Licence

Ce logiciel est sous licence Apache, version 2.0

• Copyright (C) 2024 Censys, Inc.