2015-12-23 03:56:13 +01:00
|
|
|
# ssh-audit
|
2017-03-28 16:08:36 +02:00
|
|
|
[](https://travis-ci.org/arthepsy/ssh-audit)
|
|
|
|
|
[](https://ci.appveyor.com/project/arthepsy/ssh-audit)
|
2017-03-25 07:02:49 +01:00
|
|
|
[](https://codecov.io/gh/arthepsy/ssh-audit)
|
2016-10-26 17:56:38 +02:00
|
|
|
[](https://coveralls.io/github/arthepsy/ssh-audit)
|
2015-12-23 04:52:21 +01:00
|
|
|
**ssh-audit** is a tool for ssh server auditing.
|
|
|
|
|
|
|
|
|
|
## Features
|
2016-09-20 11:26:14 +02:00
|
|
|
- SSH1 and SSH2 protocol server support;
|
|
|
|
|
- grab banner, recognize device or software and operating system, detect compression;
|
2015-12-23 04:52:21 +01:00
|
|
|
- gather key-exchange, host-key, encryption and message authentication code algorithms;
|
|
|
|
|
- output algorithm information (available since, removed/disabled, unsafe/weak/legacy, etc);
|
2016-10-10 13:08:01 +02:00
|
|
|
- output algorithm recommendations (append or remove based on recognized software version);
|
2016-09-20 11:26:14 +02:00
|
|
|
- output security information (related issues, assigned CVE list, etc);
|
2016-08-12 15:33:34 +02:00
|
|
|
- analyze SSH version compatibility based on algorithm information;
|
2016-10-10 13:08:01 +02:00
|
|
|
- historical information from OpenSSH, Dropbear SSH and libssh;
|
|
|
|
|
- no dependencies, compatible with Python 2.6+, Python 3.x and PyPy;
|
2015-12-23 04:52:21 +01:00
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
```
|
2016-10-26 17:56:38 +02:00
|
|
|
usage: ssh-audit.py [-1246pbnvl] <host>
|
2015-12-23 04:52:21 +01:00
|
|
|
|
2016-09-20 11:26:14 +02:00
|
|
|
-1, --ssh1 force ssh version 1 only
|
2016-09-24 22:02:39 +02:00
|
|
|
-2, --ssh2 force ssh version 2 only
|
2016-10-26 17:56:38 +02:00
|
|
|
-4, --ipv4 enable IPv4 (order of precedence)
|
|
|
|
|
-6, --ipv6 enable IPv6 (order of precedence)
|
|
|
|
|
-p, --port=<port> port to connect
|
2016-09-02 17:08:15 +02:00
|
|
|
-b, --batch batch output
|
|
|
|
|
-n, --no-colors disable colors
|
|
|
|
|
-v, --verbose verbose output
|
|
|
|
|
-l, --level=<level> minimum output level (info|warn|fail)
|
|
|
|
|
|
2015-12-23 04:52:21 +01:00
|
|
|
```
|
2016-10-26 17:56:38 +02:00
|
|
|
* if both IPv4 and IPv6 are used, order of precedence can be set by using either `-46` or `-64`.
|
2016-09-02 17:08:15 +02:00
|
|
|
* batch flag `-b` will output sections without header and without empty lines (implies verbose flag).
|
|
|
|
|
* verbose flag `-v` will prefix each line with section type and algorithm name.
|
2015-12-23 04:52:21 +01:00
|
|
|
|
|
|
|
|
### example
|
2016-10-10 13:03:45 +02:00
|
|
|
|
2015-12-23 04:52:21 +01:00
|
|
|
|
|
|
|
|
## ChangeLog
|
2016-10-26 18:02:13 +02:00
|
|
|
### v1.7.0 (2016-10-26)
|
2016-10-26 17:56:38 +02:00
|
|
|
- implement options to allow specify IPv4/IPv6 usage and order of precedence
|
|
|
|
|
- implement option to specify remote port (old behavior kept for compatibility)
|
|
|
|
|
- add colors support for Microsoft Windows via optional colorama dependency
|
|
|
|
|
- fix encoding and decoding issues, add tests, do not crash on encoding errors
|
|
|
|
|
- use mypy-lang for static type checking and verify all code
|
|
|
|
|
|
2016-10-14 07:55:29 +02:00
|
|
|
### v1.6.0 (2016-10-14)
|
2016-10-10 13:03:45 +02:00
|
|
|
- implement algorithm recommendations section (based on recognized software)
|
|
|
|
|
- implement full libssh support (version history, algorithms, security, etc)
|
|
|
|
|
- fix SSH-1.99 banner recognition and version comparison functionality
|
|
|
|
|
- do not output empty algorithms (happens for misconfigured servers)
|
|
|
|
|
- make consistent output for Python 3.x versions
|
|
|
|
|
- add a lot more tests (conf, banner, software, SSH1/SSH2, output, etc)
|
|
|
|
|
- use Travis CI to test for multiple Python versions (2.6-3.5, pypy, pypy3)
|
2016-09-20 11:26:14 +02:00
|
|
|
|
|
|
|
|
### v1.5.0 (2016-09-20)
|
|
|
|
|
- create security section for related security information
|
|
|
|
|
- match and output assigned CVE list and security issues for Dropbear SSH
|
|
|
|
|
- implement full SSH1 support with fingerprint information
|
|
|
|
|
- automatically fallback to SSH1 on protocol mismatch
|
|
|
|
|
- add new options to force SSH1 or SSH2 (both allowed by default)
|
2016-10-25 20:52:58 +02:00
|
|
|
- parse banner information and convert it to specific software and OS version
|
2016-09-20 11:26:14 +02:00
|
|
|
- do not use padding in batch mode
|
|
|
|
|
- several fixes (Cisco sshd, rare hangs, error handling, etc)
|
|
|
|
|
|
2016-09-02 17:10:16 +02:00
|
|
|
### v1.0.20160902
|
|
|
|
|
- implement batch output option
|
|
|
|
|
- implement minimum output level option
|
|
|
|
|
- fix compatibility with Python 2.6
|
|
|
|
|
|
2016-08-12 15:29:51 +02:00
|
|
|
### v1.0.20160812
|
2016-08-12 15:33:34 +02:00
|
|
|
- implement SSH version compatibility feature
|
2016-08-12 15:29:51 +02:00
|
|
|
- fix wrong mac algorithm warning
|
|
|
|
|
- fix Dropbear SSH version typo
|
|
|
|
|
- parse pre-banner header
|
|
|
|
|
- better errors handling
|
|
|
|
|
|
2016-08-03 16:32:46 +02:00
|
|
|
### v1.0.20160803
|
|
|
|
|
- use OpenSSH 7.3 banner
|
|
|
|
|
- add new key-exchange algorithms
|
|
|
|
|
|
2016-03-07 12:01:57 +01:00
|
|
|
### v1.0.20160207
|
|
|
|
|
- use OpenSSH 7.2 banner
|
|
|
|
|
- additional warnings for OpenSSH 7.2
|
|
|
|
|
- fix OpenSSH 7.0 failure messages
|
|
|
|
|
- add rijndael-cbc failure message from OpenSSH 6.7
|
|
|
|
|
|
2016-01-05 13:14:50 +01:00
|
|
|
### v1.0.20160105
|
2016-01-05 17:04:49 +01:00
|
|
|
- multiple additional warnings
|
|
|
|
|
- support for none algorithm
|
2016-01-05 13:14:50 +01:00
|
|
|
- better compression handling
|
|
|
|
|
- ensure reading enough data (fixes few Linux SSH)
|
|
|
|
|
|
2015-12-30 12:17:58 +01:00
|
|
|
### v1.0.20151230
|
|
|
|
|
- Dropbear SSH support
|
|
|
|
|
|
2015-12-23 04:52:21 +01:00
|
|
|
### v1.0.20151223
|
|
|
|
|
- initial version
|
