prosody-modules
750d64c47ec6
mod_telnet_tlsinfo/README.md
Software / code / prosody-modules
Comparison
mod_telnet_tlsinfo/README.md @ 6211:750d64c47ec6 draft
Merge
| author | Trần H. Trung <xmpp:trần.h.trung@trung.fun> |
|---|---|
| date | Tue, 18 Mar 2025 00:31:36 +0700 |
| parent | 6003:fe081789f7b5 |
comparison
equal
deleted
inserted
replaced
| 6210:24316a399978 | 6211:750d64c47ec6 |
|---|---|
| 1 --- | |
| 2 labels: | |
| 3 - 'Stage-Obsolete' | |
| 4 summary: Telnet command for showing TLS info | |
| 5 --- | |
| 6 | |
| 7 Introduction | |
| 8 ============ | |
| 9 | |
| 10 This module adds two commands to the telnet console, `c2s:showtls()` and | |
| 11 `s2s:showtls()`. These commands shows TLS parameters, such as ciphers | |
| 12 and key agreement protocols, of all c2s or s2s connections. | |
| 13 | |
| 14 Configuration | |
| 15 ============= | |
| 16 | |
| 17 Just add the module to the `modules_enabled` list. There is no other | |
| 18 configuration. | |
| 19 | |
| 20 modules_enabled = { | |
| 21 ... | |
| 22 "telnet_tlsinfo"; | |
| 23 } | |
| 24 | |
| 25 Usage | |
| 26 ===== | |
| 27 | |
| 28 Simply type `c2s:showtls()` to show client connections or | |
| 29 `s2s:showtls()` for server-to-server connections. These commands can | |
| 30 also take a JID for limiting output to matching users or servers. | |
| 31 | |
| 32 s2s:showtls("prosody.im") | |
| 33 | example.com -> prosody.im | |
| 34 | protocol: TLSv1.1 | |
| 35 | cipher: DHE-RSA-AES256-SHA | |
| 36 | encryption: AES(256) | |
| 37 | algbits: 256 | |
| 38 | bits: 256 | |
| 39 | authentication: RSA | |
| 40 | key: DH | |
| 41 | mac: SHA1 | |
| 42 | export: false | |
| 43 | |
| 44 Field Description | |
| 45 ---------------- ------------------------------------------------------------------------------------------------- | |
| 46 protocol The protocol used. **Note**: With older LuaSec, this is the protocol that added the used cipher | |
| 47 cipher The OpenSSL cipher string for the currently used cipher | |
| 48 encryption Encryption algorithm used | |
| 49 bits, algbits Secret bits involved in the cipher | |
| 50 authentication The authentication algorithm used | |
| 51 mac Message authentication algorithm used | |
| 52 key Key exchange mechanism used. | |
| 53 export Whethere an export cipher is used | |
| 54 | |
| 55 Compatibility | |
| 56 ============= | |
| 57 | |
| 58 --------------------- ------------------ | |
| 59 0.9 with LuaSec 0.5 Works | |
| 60 0.10 Merged into core | |
| 61 --------------------- ------------------ |
