Censys Python-Bibliothek

[!WARNING] HINWEIS ZUR EINSTELLUNG: Die Censys Search v1- und v2-APIs werden bald eingestellt. Bitte migrieren Sie zur neuen Censys Platform.

📖 Neue API-Dokumentation: https://docs.censys.com/reference/get-started

📦 Neues Python-SDK: censys/censys-sdk-python

🖥️ Neues CLI-Tool (cencli): censys/cencli

⚠️ Wenn Sie das neue CLI verwenden möchten, müssen Sie zuerst das CLI dieses Pakets deinstallieren, da beide den Befehlsnamen censys verwenden

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

Ein benutzerfreundlicher und leichtgewichtiger API-Wrapper für Censys-APIs (censys.io). Python 3.9+ wird derzeit unterstützt. Diese Bibliothek wurde mit Python 3.9 und 3.x (derzeit Version 3.13) getestet.

Funktionen

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 uv installieren.

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

Optional können Sie die Tab-Vervollständigung für das CLI aktivieren, indem Sie diese Zeile zu Ihrer ~/.bashrc, ~/.zshrc oder einer entsprechenden Datei hinzufügen.

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

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

Um Ihre Suchanmeldedaten zu konfigurieren, führen Sie censys config aus oder setzen Sie sowohl die Umgebungsvariablen CENSYS_API_ID als auch 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]

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
Do you want color output? [y/n]: y

Successfully authenticated

Beispiele

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

Dokumentation

Ressourcen

Mitwirken

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

Entwicklung

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

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

Testen

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

Lizenz

Diese Software ist unter der Apache License, Version 2.0 lizenziert

censys-python v2.3.0

Kategorien