#summary Telnet command for showing TLS info
= Introduction =
This module adds two commands to the telnet console, `c2s:showtls()` and
`s2s:showtls()`. These commands shows TLS parameters, such as ciphers and key
agreement protocols, of all c2s or s2s connections.
= Configuration =
Just add the module to the `modules_enabled` list. There is no other configuration.
{{{
modules_enabled = {
...
"telnet_tlsinfo";
}
}}}
= Usage =
Simply type `c2s:showtls()` to show client connections or `s2s:showtls()`
for server-to-server connections. These commands can also take a JID for
limiting output to matching users or servers.
{{{
s2s:showtls("prosody.im")
| example.com -> prosody.im
| protocol: TLSv1.1
| cipher: DHE-RSA-AES256-SHA
| encryption: AES(256)
| algbits: 256
| bits: 256
| authentication: RSA
| key: DH
| mac: SHA1
| export: false
}}}
|| *Field* || *Description* ||
|| protocol || The protocol used. *Note*: With older LuaSec, this is the protocol that added the used cipher ||
|| cipher || The OpenSSL cipher string for the currently used cipher ||
|| encryption || Encryption algorithm used ||
|| bits, algbits || Secret bits involved in the cipher ||
|| authentication || The authentication algoritm used ||
|| mac || Message authentication algorithm used ||
|| key || Key exchange mechanism used. ||
|| export || Whethere an export cipher is used ||
= Compatibility =
||0.9 with LuaSec 0.5||Works||