diff --git a/LICENSE b/LICENSE index e5faada..fdddb29 100644 --- a/LICENSE +++ b/LICENSE @@ -1,7 +1,24 @@ -DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE -Version 2, December 2004 -Copyright (C) 2004 Sam Hocevar -Everyone is permitted to copy and distribute verbatim or modified copies of this license document, and changing it is allowed as long as the name is changed. -DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE -TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION - 0. You just DO WHAT THE FUCK YOU WANT TO. +This is free and unencumbered software released into the public domain. + +Anyone is free to copy, modify, publish, use, compile, sell, or +distribute this software, either in source code form or as a compiled +binary, for any purpose, commercial or non-commercial, and by any +means. + +In jurisdictions that recognize copyright laws, the author or authors +of this software dedicate any and all copyright interest in the +software to the public domain. We make this dedication for the benefit +of the public at large and to the detriment of our heirs and +successors. We intend this dedication to be an overt act of +relinquishment in perpetuity of all present and future rights to this +software under copyright law. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR +OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +For more information, please refer to diff --git a/README.md b/README.md index d507b68..15e43fc 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,45 @@ +![](https://git.elektrollart.org/Elektroll/sslchecker/blob/main/sslchecker.png?raw=true) # sslchecker +**sslcheker** is wrapper written in bash for openssl and nmap, which checks the ssl certs and used TLS ciphers of a host. This tool checks when a certificate has been valid and when it expires. Also you get the information about the CA, for which domains the SSL certificate is valid and the IP adresse and PTR Record of the host. -CLI SSLchecker \ No newline at end of file +## Install +Copy this repository
+```git clone https://git.elektrollart.org/Elektroll/sslchecker```
+or download the script file with wget
+```wget https://git.elektrollart.org/Elektroll/sslchecker/raw/branch/master/sslchecker```
+or with curl
+```curl https://git.elektrollart.org/Elektroll/sslchecker/raw/branch/master/sslchecker -o ./sslchecker```.
+ +If you want and trust me, you may also download the file into ```/usr/bin/``` so you can run it global
+```sudo curl https://git.elektrollart.org/Elektroll/sslchecker/raw/branch/master/sslchecker -o /usr/bin/sslchecker``` and make it executable ```sudo chmod +x /usr/bin/sslchecker```
+In this case you can update the script file by running `sslchecker` with the `-u` option. + +## Usage + +``` +Usage: sslchecker [options] +Options: + -f local file + -h remote host + -p custome port + -c list ciphers + -u update sslchecker + -v show version + --help show this help page +``` +### SSL Certificates +The local file option give you an overview about certificate file. Just use ```sslchecker -f [/path/to/file]```
+With the `-h [host]` option you can check the ssl certificate of a remote host, like github.com. + +![](https://git.elektrollart.org/Elektroll/sslchecker/blob/main/screenshot.png?raw=true) + +If your application runs on another port number, you may set the port with the `-p [port]` option.
+```sslchecker -h github.com -p 8443```
+ +### TLS Ciphers +To get a list of used ciphers of the use the `-c [host]` option. + +![](https://git.elektrollart.org/Elektroll/sslchecker/blob/main/screenshot2.png?raw=true) + +### Update +The update option `-u` will download the script file from github into `/usr/bin/`. If you don't drop the script file into this path, the update option will. You need root priviliges for this. diff --git a/screenshot.png b/screenshot.png new file mode 100644 index 0000000..c38578d Binary files /dev/null and b/screenshot.png differ diff --git a/screenshot2.png b/screenshot2.png new file mode 100644 index 0000000..56b98a3 Binary files /dev/null and b/screenshot2.png differ diff --git a/sslchecker b/sslchecker index f8867e8..7060019 100644 --- a/sslchecker +++ b/sslchecker @@ -1,4 +1,5 @@ -#!/bin/bash +#!/usr/bin/env bash + usage() { cat <