mirror of
https://github.com/postgres/postgres.git
synced 2026-06-15 11:39:05 -04:00
9288d62bb4
This is the basic feature set using OpenSSL to support the feature. In order to allow the frontend and the backend to fetch the sent and expected TLS Finished messages, a PG-like API is added to be able to make the interface pluggable for other SSL implementations. This commit also adds a infrastructure to facilitate the addition of future channel binding types as well as libpq parameters to control the SASL mechanism names and channel binding names. Those will be added by upcoming commits. Some tests are added to the SSL test suite to test SCRAM authentication with channel binding. Author: Michael Paquier <michael@paquier.xyz> Reviewed-by: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
40 lines
1.4 KiB
C
40 lines
1.4 KiB
C
/*-------------------------------------------------------------------------
|
|
*
|
|
* scram.h
|
|
* Interface to libpq/scram.c
|
|
*
|
|
* Portions Copyright (c) 1996-2017, PostgreSQL Global Development Group
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
|
*
|
|
* src/include/libpq/scram.h
|
|
*
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
#ifndef PG_SCRAM_H
|
|
#define PG_SCRAM_H
|
|
|
|
/* Name of SCRAM mechanisms per IANA */
|
|
#define SCRAM_SHA256_NAME "SCRAM-SHA-256"
|
|
#define SCRAM_SHA256_PLUS_NAME "SCRAM-SHA-256-PLUS" /* with channel binding */
|
|
|
|
/* Channel binding types */
|
|
#define SCRAM_CHANNEL_BINDING_TLS_UNIQUE "tls-unique"
|
|
|
|
/* Status codes for message exchange */
|
|
#define SASL_EXCHANGE_CONTINUE 0
|
|
#define SASL_EXCHANGE_SUCCESS 1
|
|
#define SASL_EXCHANGE_FAILURE 2
|
|
|
|
/* Routines dedicated to authentication */
|
|
extern void *pg_be_scram_init(const char *username, const char *shadow_pass,
|
|
bool ssl_in_use, const char *tls_finished_message,
|
|
size_t tls_finished_len);
|
|
extern int pg_be_scram_exchange(void *opaq, char *input, int inputlen,
|
|
char **output, int *outputlen, char **logdetail);
|
|
|
|
/* Routines to handle and check SCRAM-SHA-256 verifier */
|
|
extern char *pg_be_scram_build_verifier(const char *password);
|
|
extern bool scram_verify_plain_password(const char *username,
|
|
const char *password, const char *verifier);
|
|
|
|
#endif /* PG_SCRAM_H */
|