relay: add support of SSL (for irc and weechat protocols), new option relay.network.ssl_cert_key (task #12044)

5 files changed, 79 insertions, 28 deletions

diff --git a/doc/it/autogen/user/irc_options.txt b/doc/it/autogen/user/irc_options.txt
index 346709859..cb72b728f 100644
--- a/doc/it/autogen/user/irc_options.txt
+++ b/doc/it/autogen/user/irc_options.txt
@@ -509,7 +509,7 @@
 ** valori: on, off (valore predefinito: `off`)
 
 * [[option_irc.server_default.ssl_cert]] *irc.server_default.ssl_cert*
-** descrizione: `file del certificato ssl usato per identificare automaticamente il proprio nick ("%h" sarà sostituito dalla home di WeeChat, "~/.weechat come predefinita)`
+** descrizione: `SSL certificate file used to automatically identify your nick ("%h" will be replaced by WeeChat home, "~/.weechat" by default)`
 ** tipo: stringa
 ** valori: qualsiasi stringa (valore predefinito: `""`)
 
@@ -524,7 +524,7 @@
 ** valori: qualsiasi stringa (valore predefinito: `"NORMAL"`)
 
 * [[option_irc.server_default.ssl_verify]] *irc.server_default.ssl_verify*
-** descrizione: `verifica che la connessione ssl sia totalmente fidata`
+** descrizione: `check that the SSL connection is fully trusted`
 ** tipo: bool
 ** valori: on, off (valore predefinito: `on`)
 
diff --git a/doc/it/autogen/user/relay_commands.txt b/doc/it/autogen/user/relay_commands.txt
index 2b299a365..682c95789 100644
--- a/doc/it/autogen/user/relay_commands.txt
+++ b/doc/it/autogen/user/relay_commands.txt
@@ -2,27 +2,34 @@
 [command]*`relay`* controllo relay::
 ........................................
 /relay  list|listfull|listrelay
-        add <protocollo.nome> <porta>
-        del <protocollo.nome>
+        add <protocol.name> <port>
+        del <protocol.name>
         raw
+        sslcertkey
 
-           list: elenca i client relay (solo quelli attivi)
-       listfull: elenca i client relay (dettagliato, tutti i relay)
-      listrelay: elenca i relay (nome e porta)
-            add: aggiungi relay per un protocollo + nome
-            del: rimuovi relay per un protocollo + nome
-protocollo.nome: protocollo e nome con cui effettuare il relay
-                   - protocollo "irc": il nome è il server da condividere
-		    - protocollo "weechat" (il nome non viene usato)
-          porta: porta usata per il relay
-            raw: apre il buffer con dati raw Relay
+         list: list relay clients (only active relays)
+     listfull: list relay clients (verbose, all relays)
+    listrelay: list relays (name and port)
+          add: add relay for a protocol + name
+          del: remove relay for a protocol + name
+protocol.name: protocol and name to relay:
+                 - protocol "irc": name is the server to share
+                 - protocol "weechat" (name is not used)
+               Note: the protocol can be prefixed by "ssl." to enable SSL
+         port: port used for relay
+          raw: open buffer with raw Relay data
+   sslcertkey: set SSL certificate/key using path in option relay.network.ssl_cert_key
 
-Senza argomento, il comando apre i buffer con l'elenco dei client relay.
+Without argument, this command opens buffer with list of relay clients.
 
-Esempio:
-  proxy irc, per il server "freenode":
+Examples:
+  irc proxy, for server "freenode":
     /relay add irc.freenode 8000
-  protocollo weechat:
-    /relay add weechat 8001
+  irc proxy, for server "freenode", with SSL:
+    /relay add ssl.irc.freenode 8001
+  weechat protocol:
+    /relay add weechat 9000
+  weechat protocol with SSL:
+    /relay add ssl.weechat 9001
 ........................................
 
diff --git a/doc/it/autogen/user/relay_options.txt b/doc/it/autogen/user/relay_options.txt
index bcfc10a5d..5aa5e7ee5 100644
--- a/doc/it/autogen/user/relay_options.txt
+++ b/doc/it/autogen/user/relay_options.txt
@@ -1,3 +1,8 @@
+* [[option_relay.color.client]] *relay.color.client*
+** descrizione: `text color for client description`
+** tipo: colore
+** valori: un nome colore di WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numero colore del terminale o un alias; attributi consentiti prima del colore (solo per il colore del testo, non lo sfondo): "*" per il grassetto, "!" per l'inverso, "_" per la sottolineatura (valore predefinito: `cyan`)
+
 * [[option_relay.color.status_active]] *relay.color.status_active*
 ** descrizione: `colore del testo per lo status "connesso"`
 ** tipo: colore
@@ -24,17 +29,17 @@
 ** valori: un nome colore di WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numero colore del terminale o un alias; attributi consentiti prima del colore (solo per il colore del testo, non lo sfondo): "*" per il grassetto, "!" per l'inverso, "_" per la sottolineatura (valore predefinito: `brown`)
 
 * [[option_relay.color.text]] *relay.color.text*
-** descrizione: `colore del testo`
+** descrizione: `text color in relay buffer`
 ** tipo: colore
 ** valori: un nome colore di WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numero colore del terminale o un alias; attributi consentiti prima del colore (solo per il colore del testo, non lo sfondo): "*" per il grassetto, "!" per l'inverso, "_" per la sottolineatura (valore predefinito: `default`)
 
 * [[option_relay.color.text_bg]] *relay.color.text_bg*
-** descrizione: `colore di sfondo`
+** descrizione: `background color in relay buffer`
 ** tipo: colore
 ** valori: un nome colore di WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numero colore del terminale o un alias; attributi consentiti prima del colore (solo per il colore del testo, non lo sfondo): "*" per il grassetto, "!" per l'inverso, "_" per la sottolineatura (valore predefinito: `default`)
 
 * [[option_relay.color.text_selected]] *relay.color.text_selected*
-** descrizione: `colore della riga del client selezionato`
+** descrizione: `text color of selected line in relay buffer`
 ** tipo: colore
 ** valori: un nome colore di WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numero colore del terminale o un alias; attributi consentiti prima del colore (solo per il colore del testo, non lo sfondo): "*" per il grassetto, "!" per l'inverso, "_" per la sottolineatura (valore predefinito: `white`)
 
@@ -73,3 +78,8 @@
 ** tipo: stringa
 ** valori: qualsiasi stringa (valore predefinito: `""`)
 
+* [[option_relay.network.ssl_cert_key]] *relay.network.ssl_cert_key*
+** descrizione: `file with SSL certificate and private key (for serving clients with SSL)`
+** tipo: stringa
+** valori: qualsiasi stringa (valore predefinito: `"%h/ssl/relay.pem"`)
+
diff --git a/doc/it/autogen/user/xfer_options.txt b/doc/it/autogen/user/xfer_options.txt
index 56e47e515..35ec687ac 100644
--- a/doc/it/autogen/user/xfer_options.txt
+++ b/doc/it/autogen/user/xfer_options.txt
@@ -29,17 +29,17 @@
 ** valori: un nome colore di WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numero colore del terminale o un alias; attributi consentiti prima del colore (solo per il colore del testo, non lo sfondo): "*" per il grassetto, "!" per l'inverso, "_" per la sottolineatura (valore predefinito: `lightcyan`)
 
 * [[option_xfer.color.text]] *xfer.color.text*
-** descrizione: `colore del testo`
+** descrizione: `text color in xfer buffer`
 ** tipo: colore
 ** valori: un nome colore di WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numero colore del terminale o un alias; attributi consentiti prima del colore (solo per il colore del testo, non lo sfondo): "*" per il grassetto, "!" per l'inverso, "_" per la sottolineatura (valore predefinito: `default`)
 
 * [[option_xfer.color.text_bg]] *xfer.color.text_bg*
-** descrizione: `colore di sfondo`
+** descrizione: `background color in xfer buffer`
 ** tipo: colore
 ** valori: un nome colore di WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numero colore del terminale o un alias; attributi consentiti prima del colore (solo per il colore del testo, non lo sfondo): "*" per il grassetto, "!" per l'inverso, "_" per la sottolineatura (valore predefinito: `default`)
 
 * [[option_xfer.color.text_selected]] *xfer.color.text_selected*
-** descrizione: `colore del testo per la riga xfer selezionata`
+** descrizione: `text color of selected line in xfer buffer`
 ** tipo: colore
 ** valori: un nome colore di WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numero colore del terminale o un alias; attributi consentiti prima del colore (solo per il colore del testo, non lo sfondo): "*" per il grassetto, "!" per l'inverso, "_" per la sottolineatura (valore predefinito: `white`)
 
diff --git a/doc/it/weechat_user.it.txt b/doc/it/weechat_user.it.txt
index 0ea492488..58c8925c1 100644
--- a/doc/it/weechat_user.it.txt
+++ b/doc/it/weechat_user.it.txt
@@ -1543,7 +1543,7 @@ Primo esempio: connessione a otfc e verifica del certificato
 * Importare certificati nella shell:
 
 ----------------------------------------
-$ mkdir ~/.weechat/ssl
+$ mkdir -p ~/.weechat/ssl
 $ wget -O ~/.weechat/ssl/CAs.pem http://www.spi-inc.org/ca/spi-cacert.crt
 ----------------------------------------
 
@@ -1562,8 +1562,9 @@ Secondo esempio: connessione a otfc con CertFP
 * Creare un certificato nella shell:
 
 ----------------------------------------
-$ openssl req -nodes -newkey rsa:2048 -keyout nick.key -x509 -days 365 -out nick.cer
-$ cat nick.cer nick.key > ~/.weechat/ssl/nick.pem
+$ mkdir -p ~/.weechat/ssl
+$ cd ~/.weechat/ssl
+$ openssl req -nodes -newkey rsa:2048 -keyout nick.pem -x509 -days 365 -out nick.pem
 ----------------------------------------
 
 * In WeeChat, con il server "otfc" già creato:
@@ -2108,6 +2109,39 @@ Ad esempio:
 Ora è possibile connettersi sulla porta 9000 con un'interfaccia remota
 (come QWeeChat) usando la password "miapass".
 
+// TRANSLATION MISSING
+[[relay_ssl]]
+Relay with SSL
+^^^^^^^^^^^^^^
+
+You can use SSL by creating a certificate and private key, and by using prefix
+"ssl." in the name of protocol.
+
+The default file for certificate/key is '~/.weechat/ssl/relay.pem'
+(option <<option_relay.network.ssl_cert_key,relay.network.ssl_cert_key>>).
+
+You can create a certificate and private key with following commands:
+
+----------------------------------------
+$ mkdir -p ~/.weechat/ssl
+$ cd ~/.weechat/ssl
+$ openssl req -nodes -newkey rsa:2048 -keyout relay.pem -x509 -days 365 -out relay.pem
+----------------------------------------
+
+If WeeChat is already running, you can reload the certificate and private key
+with command:
+
+----------------------------------------
+/relay sslcertkey
+----------------------------------------
+
+And then add relay with SSL, for example:
+
+----------------------------------------
+/relay add ssl.irc.freenode 8001
+/relay add ssl.weechat 9001
+----------------------------------------
+
 [[rmodifier_plugin]]
 Plugin Rmodifier
 ~~~~~~~~~~~~~~~~