ssl-checker/README.md
2018-04-19 14:35:50 +04:30

61 lines
2.2 KiB
Markdown

# SSL Checker
#### Simple Python script that collects SSL information from hosts
## About
It's a simple script running in python that collects SSL information then it returns the group of information in JSON.
## Requirements
You only need to installl pyOpenSSL:
`pip install pyopenssl`
## Usage
```bash
./ssl_checker.py -h
usage: ssl_checker.py -H [HOSTS [HOSTS ...]] [-j] [-h]
optional arguments:
-H [HOSTS [HOSTS ...]], --host [HOSTS [HOSTS ...]]
Hosts as input separated by space
-j, --json Enable JSON in the output
-h, --help Show this help message and exit
```
Port is optional here. The script will use 443 if not specified.
`-j, --json` Use this if you want to only have the result in JSON
`-H, --host` Enter the hosts separated by space
`-h, --help` Shows the help and exit
## Example
```bash
narbeh@narbeh-xps:~/ssl-checker$ ./ssl_checker.py -H test.com narbeh.org:443 archive.org facebook.com:443 twitter.com github.com google.com
Analyzing 7 hosts:
[+] test.com Expired: False
[+] narbeh.org Expired: False
[+] archive.org Expired: False
[-] facebook.com Failed: [Errno 111] Connection refused
[-] twitter.com Failed: [Errno 111] Connection refused
[+] github.com Expired: False
[+] google.com Expired: False
5 successful and 2 failed
```
Example only with the `-j` argument which show the JSON only. Perfect for piping to another tool.
```bash
narbeh@narbeh-xps:~/ssl-checker$ ./ssl_checker.py -j -H test.com narbeh.org:443
{'test.com': {'valid_till': '2020-01-24', 'valid_from': '2017-01-15', 'cert_alg': u'sha256WithRSAEncryption', 'cert_ver': 2, 'cert_sn': 73932709062103623902948514363737041075L, 'cert_exp': False, 'issuer_c': u'US', 'issuer_cn': u'Network Solutions DV Server CA 2', 'issuer_o': u'Network Solutions L.L.C.', 'validity_days': 1104, 'issuer_ou': None}, 'narbeh.org': {'valid_till': '2018-05-18', 'valid_from': '2018-02-17', 'cert_alg': u'sha256WithRSAEncryption', 'cert_ver': 2, 'cert_sn': 319510066429286596971677345373584681421772L, 'cert_exp': False, 'issuer_c': u'US', 'issuer_cn': u"Let's Encrypt Authority X3", 'issuer_o': u"Let's Encrypt", 'validity_days': 90, 'issuer_ou': None}}
```