Censys Python-Bibliothek

[!WARNING] VERALTET-HINWEIS: Die Censys Search v1- und v2-APIs werden bald als veraltet eingestuft. Bitte migrieren Sie zur neuen Censys Platform.

• 📖 Neue API-Dokumentation: https://docs.censys.com/reference/get-started#/
• 📦 Neues Python SDK: Installieren mit pip install censys-platform - https://pypi.org/project/censys-platform/
• 🖥️ Neues CLI-Tool (cencli): https://docs.censys.com/docs/platform-cli
  • ⚠️ Wenn Sie das neue CLI verwenden möchten, müssen Sie zuerst das CLI dieses Pakets deinstallieren, da beide den Befehl censys verwenden.

Die Censys ASM-APIs in dieser Bibliothek sind NICHT veraltet und werden weiterhin unterstützt.

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

Funktionen

• Censys-Daten durchsuchen
• Massenabfragen von Zertifikaten
• Massen-Daten herunterladen
• Assets, Ereignisse und Seeds in Censys ASM verwalten
• Befehlszeilenschnittstelle

Erste Schritte

Die Bibliothek kann mit pip installiert werden.

pip install censys

Zum Aktualisieren mit pip:

pip install --upgrade censys

Alternativ können Sie die Bibliothek 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 das CLI aktivieren, indem Sie diese Zeile zu Ihrer ~/.bashrc, ~/.zshrc oder einem Äquivalent hinzufügen.

Bitte beachten Sie, dass die Autovervollständigung für Feldnamen im search-Befehl unterstützt wird.

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

Um Ihre Suchanmeldedaten zu konfigurieren, führen Sie censys config aus oder setzen Sie die Umgebungsvariablen CENSYS_API_ID und CENSYS_API_SECRET.

$ censys config

Censys API ID: XXX
Censys API Secret: XXX
Möchten Sie farbige Ausgabe? [j/n]: j

Erfolgreich authentifiziert für [email protected]

Wenn Sie ein Censys ASM-Konto haben, können Sie Ihre ASM-Anmeldedaten konfigurieren, indem Sie censys asm config ausführen oder die Umgebungsvariable CENSYS_ASM_API_KEY setzen.

$ censys asm config

Censys ASM API Key: XXX
Möchten Sie farbige Ausgabe? [j/n]: j

Erfolgreich authentifiziert

Beispiele

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

Dokumentation

Ressourcen

• Quellcode
• Issue-Tracker
• Changelog
• Dokumentation
• Diskussionen
• Censys-Startseite
• Censys-Suche

Mitwirken

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

Entwicklung

Dieses Projekt verwendet poetry 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

# Tests ausführen
poetry run pytest
# Mit Coverage-Bericht
poetry run pytest --cov-report html

Lizenz

Diese Software ist lizenziert unter der Apache License, Version 2.0

• Copyright (C) 2024 Censys, Inc.