censys python

Библиотека Censys Python

Простая в использовании и легкая оболочка API для API Censys (censys.io). В настоящее время поддерживается Python 3.8+. Эта библиотека была протестирована на Python 3.8 и 3.x (сейчас версия 3.10).

Примечание. Конечные точки Censys Search v1 устарели с 30 ноября 2021 г. Начните использовать конечные точки 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

При желании вы можете включить завершение табуляции для CLI, добавив эту строку в ~/.bashrc , ~/.zshrc или эквивалент.

Обратите внимание, что автозаполнение поддерживается для имен полей в команде 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, вы можете настроить свои учетные данные ASM, запустив censys asm config или установив обе переменные среды 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, версия 2.0.

• Авторские права (C) 2024 Censys, Inc.