summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorManos Pitsidianakis <el13635@mail.ntua.gr>2020-11-30 03:25:57 +0200
committerManos Pitsidianakis <el13635@mail.ntua.gr>2020-11-30 06:52:16 +0200
commit453bb0b2b2c4eaf20de59844217e00024ce077bb (patch)
treea0b7851269cfee64efba89dc96665d582ad71505 /docs
parent4914f29e20d14b323032fe46b77bc803dcd48624 (diff)
melib/smtp: implement gmail XOAUTH2 authentication method
Diffstat (limited to 'docs')
-rw-r--r--docs/meli.conf.520
1 files changed, 19 insertions, 1 deletions
diff --git a/docs/meli.conf.5 b/docs/meli.conf.5
index 2da732f5..f6325c90 100644
--- a/docs/meli.conf.5
+++ b/docs/meli.conf.5
@@ -1132,7 +1132,7 @@ subsection
.El
.Ss SmtpAuth
.Bl -tag -width 36n
-.It Ic type Ar "none" | "auto"
+.It Ic type Ar "none" | "auto" | "xoauth2"
.El
.Pp
For type "auto":
@@ -1146,6 +1146,17 @@ require authentication in every case
.Pq Em true
.El
.sp
+For type "xoauth2":
+.Bl -tag -width 36n
+.It Ic token_command Ar String
+Command to evaluate that returns an XOAUTH2 token.
+.It Ic require_auth Ar bool
+.Pq Em optional
+require authentication in every case
+.\" default value
+.Pq Em true
+.El
+.sp
Examples:
.Bd -literal
auth = { type = "auto", username = "user", password = { type = "raw", value = "hunter2" } }
@@ -1156,6 +1167,13 @@ auth = { type = "auto", username = "user", password = "hunter2" }
.Bd -literal
auth = { type = "none" }
.Ed
+.sp
+For Gmail (see
+.Sx Gmail OAUTH2
+for details on the authentication token command):
+.Bd -literal
+auth = { type = "xoauth2", token_command = "TOKEN=$(python3 oauth2.py --user=xxx@gmail.com --quiet --client_id=1038[...].apps.googleusercontent.com --client_secret=[..] --refresh_token=[..] && python3 oauth2.py --user=xxx@gmail.com --generate_oauth2_string --quiet --access_token=$TOKEN" }
+.Ed
.Ss SmtpPassword
.Bl -tag -width 36n
.It Ic type Ar "raw" | "command_evaluation"