censys python

Censys Python-Bibliothek

Ein benutzerfreundlicher und leichter API-Wrapper für Censys-APIs (censys.io). Python 3.8+ wird derzeit unterstützt. Diese Bibliothek wurde auf Python 3.8 und 3.x (derzeit Version 3.10) getestet.

Hinweis: Die Censys Search v1-Endpunkte sind seit dem 30. November 2021 veraltet. Bitte verwenden Sie v2-Endpunkte zum Abfragen von Hosts und Zertifikaten und schauen Sie in unserem Support-Center nach Ressourcen.

Merkmale

• Durchsuchen Sie Censys-Daten
• Massensuche nach Zertifikaten
• Massendaten herunterladen
• Verwalten Sie Assets, Ereignisse und Seeds in Censys ASM
• Befehlszeilenschnittstelle

Erste Schritte

Die Bibliothek kann mit pip installiert werden.

pip install censys

Zum Upgrade mit pip .

pip install --upgrade censys

Alternativ können Sie die Bibliothek auch mit poetry installieren.

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

Optional können Sie die Tab-Vervollständigung für die CLI aktivieren, indem Sie diese Zeile zu Ihrem ~/.bashrc , ~/.zshrc oder einem Äquivalent hinzufügen.

Bitte beachten Sie, dass die automatische Vervollständigung für Feldnamen im search unterstützt wird.

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

Um Ihre Suchanmeldeinformationen zu konfigurieren, führen Sie censys config aus oder legen Sie die Umgebungsvariablen CENSYS_API_ID und CENSYS_API_SECRET fest.

$ censys config

Censys API ID: XXX
Censys API Secret: XXX
Do you want color output ? [y/n]: y

Successfully authenticated for [email protected]

Wenn Sie über ein Censys ASM-Konto verfügen, können Sie Ihre ASM-Anmeldeinformationen konfigurieren, indem Sie censys asm config ausführen oder beide Umgebungsvariablen CENSYS_ASM_API_KEY festlegen.

$ censys asm config

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

Successfully authenticated

Beispiele

Die Beispiele im Verzeichnis examples/ sind ein guter Ausgangspunkt. Weitere Beispiele finden Sie auch in der Nutzungsdokumentation.

Dokumentation

Ressourcen

• Quelle
• Issue-Tracker
• Änderungsprotokoll
• Dokumentation
• Diskussionen
• Censys-Homepage
• Censys-Suche

Mitwirken

Alle Beiträge (egal wie klein) sind jederzeit willkommen. Siehe Mitwirken an Censys Python

Entwicklung

Dieses Projekt verwendet Poesie für das Abhängigkeitsmanagement. Bitte stellen Sie sicher, dass Sie die neueste Version installiert haben.

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

Testen

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

Lizenz

Diese Software ist unter der Apache-Lizenz, Version 2.0, lizenziert

• Copyright (C) 2024 Censys, Inc.