Mercurial > hg > nginx-site
changeset 3088:7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Tue, 04 Jun 2024 18:35:21 +0300 |
parents | f7c8eeeaeafe |
children | 23b9cbb0c11d |
files | xml/en/docs/mail/ngx_mail_auth_http_module.xml xml/en/docs/mail/ngx_mail_imap_module.xml xml/en/docs/mail/ngx_mail_pop3_module.xml xml/en/docs/mail/ngx_mail_smtp_module.xml xml/ru/docs/mail/ngx_mail_auth_http_module.xml xml/ru/docs/mail/ngx_mail_imap_module.xml xml/ru/docs/mail/ngx_mail_pop3_module.xml xml/ru/docs/mail/ngx_mail_smtp_module.xml |
diffstat | 8 files changed, 104 insertions(+), 8 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/mail/ngx_mail_auth_http_module.xml Tue Jun 04 17:04:23 2024 +0300 +++ b/xml/en/docs/mail/ngx_mail_auth_http_module.xml Tue Jun 04 18:35:21 2024 +0300 @@ -10,7 +10,7 @@ <module name="Module ngx_mail_auth_http_module" link="/en/docs/mail/ngx_mail_auth_http_module.html" lang="en" - rev="11"> + rev="12"> <section id="directives" name="Directives"> @@ -203,6 +203,18 @@ </para> <para> +For the XOAUTH2 and OAUTHBEARER authentication methods (1.27.1), +the <header>Auth-Error-SASL</header> header +could be used to return an error response +in the form of an additional base64-encoded SASL challenge +(<link +url="https://developers.google.com/gmail/imap/xoauth2-protocol#error_response" +>XOAUTH2</link>, +<link url="https://datatracker.ietf.org/doc/html/rfc7628#section-3.2.2" +>OAUTHBEARER</link>). +</para> + +<para> For the SSL/TLS client connection (1.7.11), the <header>Auth-SSL</header> header is added, and <header>Auth-SSL-Verify</header> will contain
--- a/xml/en/docs/mail/ngx_mail_imap_module.xml Tue Jun 04 17:04:23 2024 +0300 +++ b/xml/en/docs/mail/ngx_mail_imap_module.xml Tue Jun 04 18:35:21 2024 +0300 @@ -10,7 +10,7 @@ <module name="Module ngx_mail_imap_module" link="/en/docs/mail/ngx_mail_imap_module.html" lang="en" - rev="7"> + rev="8"> <section id="directives" name="Directives"> @@ -47,6 +47,18 @@ <link url="https://datatracker.ietf.org/doc/html/rfc4422">AUTH=EXTERNAL</link> (1.11.6). </tag-desc> +<tag-name><literal>xoauth2</literal></tag-name> +<tag-desc> +<link url="https://developers.google.com/gmail/imap/xoauth2-protocol" +>AUTH=XOAUTH2</link> (1.27.1). +</tag-desc> + +<tag-name><literal>oauthbearer</literal></tag-name> +<tag-desc> +<link url="https://datatracker.ietf.org/doc/html/rfc7628" +>AUTH=OAUTHBEARER</link> (1.27.1). +</tag-desc> + </list> </para>
--- a/xml/en/docs/mail/ngx_mail_pop3_module.xml Tue Jun 04 17:04:23 2024 +0300 +++ b/xml/en/docs/mail/ngx_mail_pop3_module.xml Tue Jun 04 18:35:21 2024 +0300 @@ -10,7 +10,7 @@ <module name="Module ngx_mail_pop3_module" link="/en/docs/mail/ngx_mail_pop3_module.html" lang="en" - rev="5"> + rev="6"> <section id="directives" name="Directives"> @@ -49,6 +49,18 @@ <link url="https://datatracker.ietf.org/doc/html/rfc4422">AUTH EXTERNAL</link> (1.11.6). </tag-desc> +<tag-name><literal>xoauth2</literal></tag-name> +<tag-desc> +<link url="https://developers.google.com/gmail/imap/xoauth2-protocol" +>AUTH XOAUTH2</link> (1.27.1). +</tag-desc> + +<tag-name><literal>oauthbearer</literal></tag-name> +<tag-desc> +<link url="https://datatracker.ietf.org/doc/html/rfc7628" +>AUTH OAUTHBEARER</link> (1.27.1). +</tag-desc> + </list> </para>
--- a/xml/en/docs/mail/ngx_mail_smtp_module.xml Tue Jun 04 17:04:23 2024 +0300 +++ b/xml/en/docs/mail/ngx_mail_smtp_module.xml Tue Jun 04 18:35:21 2024 +0300 @@ -10,7 +10,7 @@ <module name="Module ngx_mail_smtp_module" link="/en/docs/mail/ngx_mail_smtp_module.html" lang="en" - rev="8"> + rev="9"> <section id="directives" name="Directives"> @@ -48,6 +48,18 @@ <link url="https://datatracker.ietf.org/doc/html/rfc4422">AUTH EXTERNAL</link> (1.11.6). </tag-desc> +<tag-name><literal>xoauth2</literal></tag-name> +<tag-desc> +<link url="https://developers.google.com/gmail/imap/xoauth2-protocol" +>AUTH XOAUTH2</link> (1.27.1). +</tag-desc> + +<tag-name><literal>oauthbearer</literal></tag-name> +<tag-desc> +<link url="https://datatracker.ietf.org/doc/html/rfc7628" +>AUTH OAUTHBEARER</link> (1.27.1). +</tag-desc> + <tag-name><literal>none</literal></tag-name> <tag-desc> Authentication is not required.
--- a/xml/ru/docs/mail/ngx_mail_auth_http_module.xml Tue Jun 04 17:04:23 2024 +0300 +++ b/xml/ru/docs/mail/ngx_mail_auth_http_module.xml Tue Jun 04 18:35:21 2024 +0300 @@ -10,7 +10,7 @@ <module name="Модуль ngx_mail_auth_http_module" link="/ru/docs/mail/ngx_mail_auth_http_module.html" lang="ru" - rev="11"> + rev="12"> <section id="directives" name="Директивы"> @@ -201,6 +201,18 @@ </para> <para> +Для методов аутентификации XOAUTH2 and OAUTHBEARER (1.27.1) +в заголовке <header>Auth-Error-SASL</header> +можно вернуть информацию об ошибке +в форме дополнительного SASL challenge в base64 +(<link +url="https://developers.google.com/gmail/imap/xoauth2-protocol#error_response" +>XOAUTH2</link>, +<link url="https://datatracker.ietf.org/doc/html/rfc7628#section-3.2.2" +>OAUTHBEARER</link>). +</para> + +<para> Для клиентского соединения по протоколу SSL/TLS (1.7.11) добавляется заголовок <header>Auth-SSL</header>, и если директива <link doc="ngx_mail_ssl_module.xml" id="ssl_verify_client"/> включена,
--- a/xml/ru/docs/mail/ngx_mail_imap_module.xml Tue Jun 04 17:04:23 2024 +0300 +++ b/xml/ru/docs/mail/ngx_mail_imap_module.xml Tue Jun 04 18:35:21 2024 +0300 @@ -10,7 +10,7 @@ <module name="Модуль ngx_mail_imap_module" link="/ru/docs/mail/ngx_mail_imap_module.html" lang="ru" - rev="7"> + rev="8"> <section id="directives" name="Директивы"> @@ -47,6 +47,18 @@ <link url="https://datatracker.ietf.org/doc/html/rfc4422">AUTH=EXTERNAL</link> (1.11.6). </tag-desc> +<tag-name><literal>xoauth2</literal></tag-name> +<tag-desc> +<link url="https://developers.google.com/gmail/imap/xoauth2-protocol" +>AUTH=XOAUTH2</link> (1.27.1). +</tag-desc> + +<tag-name><literal>oauthbearer</literal></tag-name> +<tag-desc> +<link url="https://datatracker.ietf.org/doc/html/rfc7628" +>AUTH=OAUTHBEARER</link> (1.27.1). +</tag-desc> + </list> </para>
--- a/xml/ru/docs/mail/ngx_mail_pop3_module.xml Tue Jun 04 17:04:23 2024 +0300 +++ b/xml/ru/docs/mail/ngx_mail_pop3_module.xml Tue Jun 04 18:35:21 2024 +0300 @@ -10,7 +10,7 @@ <module name="Модуль ngx_mail_pop3_module" link="/ru/docs/mail/ngx_mail_pop3_module.html" lang="ru" - rev="5"> + rev="6"> <section id="directives" name="Директивы"> @@ -49,6 +49,18 @@ <link url="https://datatracker.ietf.org/doc/html/rfc4422">AUTH EXTERNAL</link> (1.11.6). </tag-desc> +<tag-name><literal>xoauth2</literal></tag-name> +<tag-desc> +<link url="https://developers.google.com/gmail/imap/xoauth2-protocol" +>AUTH XOAUTH2</link> (1.27.1). +</tag-desc> + +<tag-name><literal>oauthbearer</literal></tag-name> +<tag-desc> +<link url="https://datatracker.ietf.org/doc/html/rfc7628" +>AUTH OAUTHBEARER</link> (1.27.1). +</tag-desc> + </list> </para>
--- a/xml/ru/docs/mail/ngx_mail_smtp_module.xml Tue Jun 04 17:04:23 2024 +0300 +++ b/xml/ru/docs/mail/ngx_mail_smtp_module.xml Tue Jun 04 18:35:21 2024 +0300 @@ -10,7 +10,7 @@ <module name="Модуль ngx_mail_smtp_module" link="/ru/docs/mail/ngx_mail_smtp_module.html" lang="ru" - rev="8"> + rev="9"> <section id="directives" name="Директивы"> @@ -48,6 +48,18 @@ <link url="https://datatracker.ietf.org/doc/html/rfc4422">AUTH EXTERNAL</link> (1.11.6). </tag-desc> +<tag-name><literal>xoauth2</literal></tag-name> +<tag-desc> +<link url="https://developers.google.com/gmail/imap/xoauth2-protocol" +>AUTH XOAUTH2</link> (1.27.1). +</tag-desc> + +<tag-name><literal>oauthbearer</literal></tag-name> +<tag-desc> +<link url="https://datatracker.ietf.org/doc/html/rfc7628" +>AUTH OAUTHBEARER</link> (1.27.1). +</tag-desc> + <tag-name><literal>none</literal></tag-name> <tag-desc> Аутентификация не требуется.