Metadata-Version: 2.1
Name: censys-command-line
Version: 1.0.4
Summary: Command-line tool for Censys! Quickly investigate suspicious hosts or answer complex questions about your infrastructure using Censys right from the command-line! https://www.censys.io
Home-page: UNKNOWN
Author: Art Sturdevant
Author-email: support@censys.io
License: UNKNOWN
Keywords: censys threat hunting osint ports scan
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=2.7
Description-Content-Type: text/markdown
Requires-Dist: censys

## Censys Command Line Tool Examples

This script allows a user to query the Censys API from the command. The results from the query can be written to CSV, JSON, or simply to the screen.

##### Installation:
```bash
pip install censys-command-line
```

Or
```bash
pip install git+https://github.com/censys/censys-command-line
```

##### Usage:
```bash
usage: censys [-h] [--fields FIELDS [FIELDS ...]] --query_type
                              ipv4|certs|websites [--append {true,false}]
                              [--output json|csv|screen]
                              [--start_page START_PAGE]
                              [--max_pages MAX_PAGES]
                              [--censys_api_id XXXXXXXXXX]
                              [--censys_api_secret XXXXXXXXXX]
                              query

Search The Censys Data Set via the command line

positional arguments:
  query

optional arguments:
  -h, --help            show this help message and exit
  --fields FIELDS [FIELDS ...]
  --query_type ipv4|certs|websites
  --append {true,false}
                        Append the given list of fields to the default fields
  --output json|csv|screen
  --start_page START_PAGE
  --max_pages MAX_PAGES
  --censys_api_id XXXXXXXXXX
                        (optional) You must provide your Censys API ID here or
                        as an environmental variable CENSYS_API_ID
  --censys_api_secret XXXXXXXXXX
                        (optional) You must provide your Censys API SECRET
                        here or as an environmental variable CENSYS_API_SECRET

```

##### Searching IPv4:
```bash
censys "ip: [ 134.54.0.0 TO 134.54.65.255 ]" --query_type ipv4 --fields ip protocols --output json
```

##### Searching Certificates
```bash
censys "parsed.issuer.organization: Let's Encrypt" --query_type=certs
```

