]> granicus.if.org Git - postgresql/commit
Support SCRAM-SHA-256 authentication (RFC 5802 and 7677).
authorHeikki Linnakangas <heikki.linnakangas@iki.fi>
Tue, 7 Mar 2017 12:25:40 +0000 (14:25 +0200)
committerHeikki Linnakangas <heikki.linnakangas@iki.fi>
Tue, 7 Mar 2017 12:25:40 +0000 (14:25 +0200)
commit818fd4a67d610991757b610755e3065fb99d80a5
tree6902ced6e8316044e9b706f93586c84bc24e2010
parent273c458a2b3a0fb73968020ea5e9e35eb6928967
Support SCRAM-SHA-256 authentication (RFC 5802 and 7677).

This introduces a new generic SASL authentication method, similar to the
GSS and SSPI methods. The server first tells the client which SASL
authentication mechanism to use, and then the mechanism-specific SASL
messages are exchanged in AuthenticationSASLcontinue and PasswordMessage
messages. Only SCRAM-SHA-256 is supported at the moment, but this allows
adding more SASL mechanisms in the future, without changing the overall
protocol.

Support for channel binding, aka SCRAM-SHA-256-PLUS is left for later.

The SASLPrep algorithm, for pre-processing the password, is not yet
implemented. That could cause trouble, if you use a password with
non-ASCII characters, and a client library that does implement SASLprep.
That will hopefully be added later.

Authorization identities, as specified in the SCRAM-SHA-256 specification,
are ignored. SET SESSION AUTHORIZATION provides more or less the same
functionality, anyway.

If a user doesn't exist, perform a "mock" authentication, by constructing
an authentic-looking challenge on the fly. The challenge is derived from
a new system-wide random value, "mock authentication nonce", which is
created at initdb, and stored in the control file. We go through these
motions, in order to not give away the information on whether the user
exists, to unauthenticated users.

Bumps PG_CONTROL_VERSION, because of the new field in control file.

Patch by Michael Paquier and Heikki Linnakangas, reviewed at different
stages by Robert Haas, Stephen Frost, David Steele, Aleksander Alekseev,
and many others.

Discussion: https://www.postgresql.org/message-id/CAB7nPqRbR3GmFYdedCAhzukfKrgBLTLtMvENOmPrVWREsZkF8g%40mail.gmail.com
Discussion: https://www.postgresql.org/message-id/CAB7nPqSMXU35g%3DW9X74HVeQp0uvgJxvYOuA4A-A3M%2B0wfEBv-w%40mail.gmail.com
Discussion: https://www.postgresql.org/message-id/55192AFE.6080106@iki.fi
38 files changed:
contrib/pgcrypto/.gitignore
contrib/pgcrypto/Makefile
doc/src/sgml/catalogs.sgml
doc/src/sgml/client-auth.sgml
doc/src/sgml/config.sgml
doc/src/sgml/protocol.sgml
doc/src/sgml/ref/create_role.sgml
src/backend/access/transam/xlog.c
src/backend/commands/user.c
src/backend/libpq/Makefile
src/backend/libpq/auth-scram.c [new file with mode: 0644]
src/backend/libpq/auth.c
src/backend/libpq/crypt.c
src/backend/libpq/hba.c
src/backend/libpq/pg_hba.conf.sample
src/backend/utils/misc/guc.c
src/backend/utils/misc/postgresql.conf.sample
src/bin/initdb/initdb.c
src/bin/pg_controldata/pg_controldata.c
src/common/Makefile
src/common/base64.c [new file with mode: 0644]
src/common/scram-common.c [new file with mode: 0644]
src/include/access/xlog.h
src/include/catalog/pg_control.h
src/include/common/base64.h [new file with mode: 0644]
src/include/common/scram-common.h [new file with mode: 0644]
src/include/libpq/crypt.h
src/include/libpq/hba.h
src/include/libpq/pqcomm.h
src/include/libpq/scram.h [new file with mode: 0644]
src/interfaces/libpq/.gitignore
src/interfaces/libpq/Makefile
src/interfaces/libpq/fe-auth-scram.c [new file with mode: 0644]
src/interfaces/libpq/fe-auth.c
src/interfaces/libpq/fe-auth.h
src/interfaces/libpq/fe-connect.c
src/interfaces/libpq/libpq-int.h
src/tools/msvc/Mkvcbuild.pm