ssh_blackbox_exporter/README.adoc

92 lines
1.9 KiB
Plaintext

ssh_blackbox_exporter
=====================
:source-highlighter: coderay
Tries to connect to ssh and fetches informations about the connections, ciphers, keys/certs.
Like blackbox_exporter, but with more ssh-related informations.
Installation
------------
The dependencies can be installed by bundler:
....
$ bundle install
....
TODO: The systemd-service-file
Configuration
-------------
Add the exporter to prometheus.
Set target like blackbox_exporter-targets.
The exporter will provide the informations about the target.
TODO
CLI-Usage
---------
Additional to provide the metrics for prometheus, this tool provides some manual checks.
You can check a host without starting the server by using:
....
$ ./probe.rb user@remotehost
....
If you are not able to login via IdentityFile, it will fail, but you would get some informations about the server:
....
$ ./probe.rb user@remotehost
[...debug...]
....
[source,yaml]
----
---
start: '2022-03-16 21:02:19 +0100'
status: pid 291884 exit 255
stop: '2022-03-16 21:02:19 +0100'
duration: 0.063974201
protocol: '2.0'
remote_software: OpenSSH_7.9p1 Debian-10+deb10u2
host_cert:
key: ssh-ed25519-cert-v01@openssh.com SHA256:HASHSUM
serial: 43
id: 'host: REMOTEHOST'
ca: ssh-ed25519 SHA256:HASHSUM
valid_from: '2022-03-02 00:00:00 +0100'
valid_to: '2023-02-25 00:00:00 +0100'
host_in_cert: REMOTEHOST.FQDN
host_cert_type: ED25519-CERT
server_sig_algs:
- ssh-ed25519
- ssh-rsa
- rsa-sha2-256
- rsa-sha2-512
- ssh-dss
- ecdsa-sha2-nistp256
- ecdsa-sha2-nistp384
- ecdsa-sha2-nistp521
authentications:
- publickey
- gssapi-keyex
- gssapi-with-mic
- password
----
The server has a Host-Certificate and the used CA is known by your local machine (`known_hosts`: `@cert-authority`).
It's possible to print the metrics without starting a server:
./collector.rb user@remotehost
For starting server, use `puma`:
[source,sh]
----
$ puma -eproduction
----