53.2. Information about the Connection

The parameters listed below specify information about the connection. These parameters are available for all types of plug-ins.

Table 53.1. Information about the Connection

Parameter ID Data Type Description
SLAPI_CONN_SASL_SSF int * The security strength factor provided by the SASL layer used by the connection.
SLAPI_CONN_CERT CERTCertificate * This is an NSS database. See https://developer.mozilla.org/en-US/docs/Mozilla/Projects/NSS The client certificate associated with the connection; may be absent.
SLAPI_CONN_IS_REPLICATION_SESSION char * Indicates the current connection is a replication session.
SLAPI_CONN_IS_SSL_CONNECTION char * Indicates the current connection is through TLS.
SLAPI_CONNECTION Slapi_Connection * Information about the current client connection.
SLAPI_CONN_ID int * ID identifying the current connection.
SLAPI_CONN_DN char * DN of the user authenticated on the current connection. If you call to get this DN, you should call slapi_ch_free_string() to free the resulting DN when done.
SLAPI_CONN_AUTHMETHOD char * Method used to authenticate the current user. If you call to get this value, you should call slapi_ch_free_string() to free the resulting value when done. This parameter can have one of the following values:
  • SLAPD_AUTH_NONE specifies that no authentication mechanism was used (for example, in cases of anonymous authentication).
  • SLAPD_AUTH_SIMPLE specifies that simple authentication (user name and password) was used to authenticate the current user.
  • SLAPD_AUTH_SSL specifies that TLS (certificate-based authentication) was used to authenticate the current user.
  • SLAPD_AUTH_SASL specifies that a SASL (Simple Authentication and Security Layer) mechanism was used to authenticate the current user.
SLAPI_CONN_AUTHTYPE char * This parameter has been deprecated for current releases. Use SLAPI_CONN_AUTHMETHOD instead.
SLAPI_CONN_CLIENTNETADDR[a] PRNetAddr IP address of the client requestingthe operation.
SLAPI_CONN_SERVERNETADDR[a] PRNetAddr IP address to which the client is connecting. You might want to use this parameter if, for example, your server accepts connections on multiple IP addresses.
[a] These parameters use an NSPR structure. See https://developer.mozilla.org/en-US/docs/Mozilla/Projects/NSPR.