censys python

Censys Python ライブラリ

Censys API 用の使いやすく軽量な API ラッパー (censys.io)。現在、Python 3.8 以降がサポートされています。このライブラリは、Python 3.8 および 3.x (現在のバージョン 3.10) でテストされています。

注意: Censys Search v1 エンドポイントは、2021 年 11 月 30 日をもって廃止されました。v2 エンドポイントの使用を開始してホストと証明書をクエリし、サポート センターでリソースを確認してください。

特徴

• Censys データの検索
• 証明書の一括検索
• データの一括ダウンロード
• Censys ASM でアセット、イベント、シードを管理する
• コマンドラインインターフェース

はじめる

ライブラリはpip使用してインストールできます。

pip install censys

pip使用してアップグレードします。

pip install --upgrade censys

あるいは、 poetry使用してライブラリをインストールすることもできます。

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

必要に応じて、この行を~/.bashrc 、 ~/.zshrc 、または同等のものに追加することで、CLI のタブ補完を有効にすることができます。

searchコマンドのフィールド名ではオートコンプリートがサポートされていることに注意してください。

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

検索資格情報を構成するには、 censys configを実行するか、 CENSYS_API_IDと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]

Censys ASM アカウントをお持ちの場合は、 censys asm config実行して ASM 資格情報を構成するか、両方のCENSYS_ASM_API_KEY環境変数を設定できます。

$ censys asm config

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

Successfully authenticated

例

examples/ディレクトリにあるサンプルは、始めるのに最適な場所です。使用法ドキュメントにはさらに多くの例があります。

ドキュメント

リソース

• ソース
• 問題追跡ツール
• 変更履歴
• ドキュメント
• ディスカッション
• Censys ホームページ
• センシス検索

貢献する

すべての貢献（どんなに少額であっても）はいつでも歓迎されます。 「Censys Python への貢献」を参照してください。

発達

このプロジェクトでは、依存関係の管理に詩を使用しています。最新バージョンがインストールされていることを確認してください。

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

テスト

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

ライセンス

このソフトウェアは、Apache License、バージョン 2.0 に基づいてライセンスされています。

• Copyright (C) 2024 Censys, Inc.