32 lines
1.7 KiB
Markdown
32 lines
1.7 KiB
Markdown
# tls-dashboard
|
|
A dashboard written in JavaScript & HTML to check the remaining time before a TLS certificate expires. A combination of a Node script and an HTML/CSS/JS webpage to display the info.
|
|
|
|
## Usage
|
|
### `get_cert_info.js`
|
|
This is the node script that establishes a connection to the sites that you want/need to monitor, and reads info about the peer certificate. It then parses the certificate, and dumps the relevant data into another .js file (`certificates.js`) for use on the status page.
|
|
|
|
To setup the module, go to line 7, and switch out the contents of the array with all the hosts you're wanting to monitor:
|
|
|
|
var host_list = [
|
|
'www.google.com',
|
|
'www.twitter.com',
|
|
'www.github.com',
|
|
'www.bitbucket.com',
|
|
'news.ycombinator.com',
|
|
'barnacl.es'
|
|
];
|
|
|
|
If you're hosting this somewhere and want a regularly updating dashboard, set it up on a cron job and pass the path to your webroot as an argument to the script. e.g. `node get_cert_info.js /path/to/web/root`, and it will dump the `certificates.js` file there. Otherwise, you can keep it local, run the script when you want updated info, and just load `index.html` locally.
|
|
|
|
## Example
|
|
Take a look at a live example page [here on GitLab][1]. Screenshot is below.
|
|
|
|
|
|
|
|
## TODO
|
|
1. Comment the module functions
|
|
2. Separate the host_list into another file that can be read and versioned on its own (useful for large deployments, if you're managing 1,000s of certs)
|
|
3. Error handling for when the connection fails (right now the script hangs/exits with an uncaught error)
|
|
|
|
|
|
[1]:https://pages.runtondev.com/tls-dashboard/ |