mod_telnet_tlsinfo/README.wiki
changeset 1786 29f3d6b7ad16
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_telnet_tlsinfo/README.wiki	Mon Aug 24 16:43:56 2015 +0200
@@ -0,0 +1,53 @@
+#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||
+