-
+
Server Configuration
Sets the location of the Kerberos server key file. See
- for details. This parameter
- can only be set at server start.
+ or
+ for details. This parameter can only be set at server start.
- Sets whether Kerberos user names should be treated case-insensitively.
+ Sets whether Kerberos and GSSAPI user names should be treated
+ case-insensitively.
The default is off> (case sensitive). This parameter
can only be set at server start.
-
+
PostgreSQL>]]>
+
+
+
+ Build with support for GSSAPI authentication. On many
+ systems, the GSSAPI (usually a part of the Kerberos installation)
+ system is not installed in a location
+ that is searched by default (e.g., /usr/include>,
+ /usr/lib>), so you must use the options
+
+ addition to this option. configure> will check
+ for the required header files and libraries to make sure that
+ your GSSAPI installation is sufficient before proceeding.
+
+
+
+
- The default name of the Kerberos service principal.
+ The default name of the Kerberos service principal (also used
+ by GSSAPI).
postgres is the default. There's usually no
- reason to change this.
+ reason to change this unless you have a Windows environment,
+ in which case it must be set to uppercase
+ POSTGRES.
-
+
Using hostaddr> instead of host> allows the
application to avoid a host name look-up, which might be important in
- applications with time constraints. However, Kerberos authentication
+ applications with time constraints. However, Kerberos and GSSAPI authentication
requires the host name. The following therefore applies: If
host> is specified without hostaddr>, a host name
lookup occurs. If hostaddr> is specified without
krbsrvname
- Kerberos service name to use when authenticating with Kerberos 5.
+ Kerberos service name to use when authenticating with Kerberos 5
+ or GSSAPI.
This must match the service name specified in the server
configuration for Kerberos authentication to succeed. (See also
- .)
+ and .)
PGKRBSRVNAME sets the Kerberos service name to use when
-authenticating with Kerberos 5.
+authenticating with Kerberos 5 or GSSAPI.
-
+
Frontend/Backend Protocol
The server then sends an appropriate authentication request message,
to which the frontend must reply with an appropriate authentication
response message (such as a password).
- In principle the authentication request/response cycle could require
- multiple iterations, but none of the present authentication methods
- use more than one request and response. In some methods, no response
+ For all authentication methods except GSSAPI, there is at most
+ one request and one response. In some methods, no response
at all is needed from the frontend, and so no authentication request
- occurs.
+ occurs. For GSSAPI, multiple iterations of packets may be needed to
+ complete the authentication.
+
+ AuthenticationGSS
+
+ The frontend must now initiate a GSSAPI negotiation. The frontend
+ will send a PasswordMessage with the first part of the GSSAPI
+ data stream in response to this. If further messages are needed,
+ the server will respond with AuthenticationGSSContinue.
+
+
+
+
+
+ AuthenticationGSSContinue
+
+ This message contains the response data from the previous step
+ of GSSAPI negotiation (AuthenticationGSS or a previous
+ AuthenticationGSSContinue). If the GSSAPI data in this message
+ indicates more data is needed to complete the authentication,
+ the frontend must send this data as another PasswordMessage. If
+ GSSAPI authentication is completed by this message, the server
+ will also send AuthenticationOk to indicate successful authentication
+ or ErrorResponse to indicate failure.
+
+
+
+
+
+
+AuthenticationGSS (B)
+
+
+
+
+
+
+ Byte1('R')
+
+
+ Identifies the message as an authentication request.
+
+
+
+
+
+ Int32(8)
+
+
+ Length of message contents in bytes, including self.
+
+
+
+
+
+ Int32(7)
+
+
+ Specifies that GSSAPI authentication is required.
+
+
+
+
+
+
+
+
+
+
+
+
+AuthenticationGSSContinue (B)
+
+
+
+
+
+
+ Byte1('R')
+
+
+ Identifies the message as an authentication request.
+
+
+
+
+
+ Int32
+
+
+ Length of message contents in bytes, including self.
+
+
+
+
+
+ Int32(8)
+
+
+ Specifies that this message contains GSSAPI data.
+
+
+
+
+
+ Byten
+
+
+ GSSAPI authentication data.
+
+
+
+
+
+
+
+
+
+
BackendKeyData (B)
- Identifies the message as a password response.
+ Identifies the message as a password response. Note that
+ this is also used by GSSAPI response messages.