diff --git a/doc/src/sgml/client-auth.sgml b/doc/src/sgml/client-auth.sgml index e4e65f8feb1..873ddd8f068 100644 --- a/doc/src/sgml/client-auth.sgml +++ b/doc/src/sgml/client-auth.sgml @@ -652,7 +652,9 @@ include_dir directory Authorize and optionally authenticate using a third-party OAuth 2.0 - identity provider. See for details. + identity provider. Since the bearer token is sent in clear text over + the network, this should not be used on untrusted networks. See + for details. @@ -2341,7 +2343,9 @@ host ... ldap ldapbasedn="dc=example,dc=net" RFC 6750, which are a type of access token used with OAuth 2.0 where the token is an opaque string. The format of the access token is implementation specific - and is chosen by each authorization server. + and is chosen by each authorization server. The bearer token is sent + in clear-text, and is vulnerable to network sniffing. For this reason + OAuth should only be used over SSL connections. diff --git a/doc/src/sgml/protocol.sgml b/doc/src/sgml/protocol.sgml index 84af9372ebe..541673eb282 100644 --- a/doc/src/sgml/protocol.sgml +++ b/doc/src/sgml/protocol.sgml @@ -2084,6 +2084,16 @@ SELCT 1/0; server. + + + The bearer token is sent across the connection, as part of the client + initial response, and grants access to the database like a clear-text + password. On an unencrypted connection it can be captured by network + sniffing. For this reason OAUTHBEARER should only be + used over SSL connections. + + + OAUTHBEARER does not support channel binding, and there is no "OAUTHBEARER-PLUS" mechanism. This mechanism does not make use of