sslscanner

# sslscanner

SSL cipher and protocol scanner in Crystal  
![alt text][scan]

[scan]: https://sc-cdn.scaleengine.net/i/e9ae5c37a96b1422e565c3456658776e.png "Example Scan"



## Installation

### As a standalone binery
```bash
git clone https://github.com/bararchy/sslscanner
cd sslscanner
make # or make static
```

### As a Crystal lib: 
Add this to your application's `shard.yml`:

```yaml
dependencies:
  sslscanner:
    github: bararchy/sslscanner
```

## Usage

```crystal
require "sslscanner"
# This will start a scan of google.com
scanner = SSLScanner::Scan.new("google.com", 443)
scanner.run
```

Or you can use the example under /bin

```bash
make
./scan google.com 443
```

## Development

- [ ] Add more issues (SSL Issues)  
- [x] Multiscanning (using fibers)  
- [ ] Export results to pdf\txt\csv\etc..  
- [ ] Add local OpenSSL installation with all ciphers enabled so we don't need to relay on system openssl  
- [ ] Add more checks: HeartBleed, compression, renegotiation, etc..  
- [ ] Add better output formatting, spaces, colors, maybe table of some sort  
- [ ] Add OptionParser to the bin instead of using ARGV  

## Contributing

1. Fork it ( https://github.com/bararchy/sslscanner/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

## Contributors

- [bararchy](https://github.com/bararchy) - creator, maintainer