irc: implement IRCv3.2 SASL authentication, add command /auth (closes #413)

3 files changed, 23 insertions, 1 deletions

diff --git a/doc/de/includes/autogen_api_hdata.de.adoc b/doc/de/includes/autogen_api_hdata.de.adoc
index 873beff98..9a6365bce 100644
--- a/doc/de/includes/autogen_api_hdata.de.adoc
+++ b/doc/de/includes/autogen_api_hdata.de.adoc
@@ -237,6 +237,8 @@ _sasl_scram_client_first_   (string) +
 _sasl_scram_salted_pwd_   (other) +
 _sasl_scram_salted_pwd_size_   (integer) +
 _sasl_scram_auth_message_   (string) +
+_sasl_temp_username_   (string) +
+_sasl_temp_password_   (string) +
 _is_connected_   (integer) +
 _ssl_connected_   (integer) +
 _disconnected_   (integer) +
diff --git a/doc/de/includes/autogen_user_commands.de.adoc b/doc/de/includes/autogen_user_commands.de.adoc
index eae094a4b..a6b77109e 100644
--- a/doc/de/includes/autogen_user_commands.de.adoc
+++ b/doc/de/includes/autogen_user_commands.de.adoc
@@ -100,6 +100,26 @@ Beispiele:
     /allserv /whois $nick
 ----
 
+[[command_irc_auth]]
+* `+auth+`: authenticate with SASL
+
+----
+/auth  [<username> <password>]
+
+username: SASL username (content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)
+password: SASL password or path to file with private key (content is evaluated, see /help eval; server options are evaluated with ${irc_server.xxx} and ${server} is replaced by the server name)
+
+If username and password are not provided, the values from server options "sasl_username" and "sasl_password" (or "sasl_key") are used.
+
+Examples:
+  authenticate with username/password defined in the server:
+    /auth
+  authenticate as a different user:
+    /auth user2 password2
+  authenticate as a different user with mechanism ecdsa-nist256p-challenge:
+    /auth user2 ${weechat_config_dir}/ecdsa2.pem
+----
+
 [[command_irc_ban]]
 * `+ban+`: Nicknamen oder Hosts sperren/verbannen
 
diff --git a/doc/de/includes/autogen_user_options.de.adoc b/doc/de/includes/autogen_user_options.de.adoc
index f835c5cb8..f47de91de 100644
--- a/doc/de/includes/autogen_user_options.de.adoc
+++ b/doc/de/includes/autogen_user_options.de.adoc
@@ -2782,7 +2782,7 @@
 ** Beschreibung: pass:none[auszuführende Aktion falls die SASL Authentifizierung fehlschlägt: "continue" ignoriert das Problem welches bei der Authentifizierung aufgetreten ist, "reconnect" versucht erneut eine Verbindung herzustellen, "disconnect" trennt die Verbindung zum Server (siehe Option irc.network.sasl_fail_unavailable)]
 ** Typ: integer
 ** Werte: continue, reconnect, disconnect
-** Standardwert: `+continue+`
+** Standardwert: `+reconnect+`
 
 * [[option_irc.server_default.sasl_key]] *irc.server_default.sasl_key*
 ** Beschreibung: pass:none[Datei mit privatem ECC-Schlüssel für den Mechanismus "ecdsa-nist256p-challenge" (Pfad ist evaluiert, siehe Funktion string_eval_path_home in der Plugin-API-Referenz)]