Censys Python 라이브러리

[!WARNING] 지원 중단 공지: Censys Search v1 및 v2 API는 곧 지원이 중단될 예정입니다. 새로운 Censys Platform으로 마이그레이션해 주세요.

📖 새 API 문서: https://docs.censys.com/reference/get-started

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

🖥️ 새 CLI 도구 (cencli): censys/cencli

⚠️ 새 CLI를 사용하려면 먼저 이 패키지의 CLI를 제거해야 합니다. 둘 다 censys 명령어 이름을 사용하기 때문입니다.

이 라이브러리의 Censys ASM API는 지원 중단되지 않으며 계속 지원될 예정입니다.

Censys API(censys.io)를 위한 사용하기 쉽고 가벼운 API 래퍼입니다. 현재 Python 3.9+를 지원합니다. 이 라이브러리는 Python 3.9 및 3.x(현재 버전 3.13)에서 테스트되었습니다.

기능

시작하기

라이브러리는 pip을 사용하여 설치할 수 있습니다.

pip install censys

pip을 사용하여 업그레이드하려면:

pip install --upgrade censys

또는 uv를 사용하여 라이브러리를 설치할 수 있습니다.

git clone https://github.com/censys/censys-python.git
cd censys-python/
uv 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를 실행하거나 CENSYS_ASM_API_KEY 환경 변수를 설정하여 ASM 자격 증명을 구성할 수 있습니다.

$ censys asm config

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

Successfully authenticated

예제

examples/ 디렉토리에 있는 예제는 시작하기에 좋은 곳입니다. 사용 문서에서 더 많은 예제를 찾을 수도 있습니다.

문서

리소스

기여

모든 기여(아무리 작은 것이라도)는 언제나 환영합니다. Censys Python에 기여하기를 참조하세요.

개발

이 프로젝트는 의존성 관리를 위해 uv를 사용합니다. 최신 버전을 설치했는지 확인하세요.

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

테스트

# 테스트 실행
uv run pytest
# 커버리지 리포트 포함
uv run pytest --cov-report html

라이선스

이 소프트웨어는 Apache License, Version 2.0에 따라 라이선스가 부여됩니다.

censys-python v2.3.0

카테고리