An easy-to-use and lightweight API wrapper for Censys APIs (censys.io).
Project description
Censys Python Library
An easy-to-use and lightweight API wrapper for Censys APIs (censys.io). Python 3.6+ is currently supported.
Features
- Search Censys data
- Bulk Certificate lookups
- Download Bulk Data
- Manage assets, events, and seeds in Censys ASM
- Command-line interface
Getting Started
The library can be installed using pip
.
pip install censys
To upgraded using pip
.
pip install --upgrade censys
To configure your search credentials run censys config
or set both CENSYS_API_ID
and CENSYS_API_SECRET
environment variables.
$ censys config
Censys API ID: XXX
Censys API Secret: XXX
Successfully authenticated for your@email.com
To configure your ASM credentials run censys config-asm
or set the CENSYS_ASM_API_KEY
environment variables.
$ censys config-asm
Censys ASM API Key: XXX
Successfully authenticated
API Reference and User Guide available on Read the Docs
Resources
Contributing
All contributions (no matter how small) are always welcome.
Development
git clone git@github.com:censys/censys-python.git
cd censys-python/
pip install -e ".[dev]"
Testing
pytest
# With coverage report
pytest --cov-report html
License
This software is licensed under Apache License, Version 2.0
- Copyright (C) 2021 Censys, Inc.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
censys-2.0.3.tar.gz
(27.8 kB
view hashes)
Built Distribution
censys-2.0.3-py2.py3-none-any.whl
(38.3 kB
view hashes)
Close
Hashes for censys-2.0.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cfeb9c6b50f97826a08ef54c35fb3769aa3bfc3dccf975dc250e609c1bfe402c |
|
MD5 | 5301a59f5c850785a86f56babf4bae46 |
|
BLAKE2b-256 | 6d6aac4c1340e34be43a73985ba72867ee32541060a4656d753be1da9623a8e1 |