censys python

Censys Python 라이브러리

Censys API(censys.io)를 위한 사용하기 쉽고 가벼운 API 래퍼입니다. 현재 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 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.