Red Hat DIRECTORY SERVER 7.1 - PLUG-IN PROGRAMMERS Manual page 116

Using SASL with an LDAP Client
In your client, call the
request authentication using SASL. To parse credentials from an asynchronous
SASL bind operation, call
are part of LDAP C SDK 3.0.
The syntax for these functions are listed below:
LDAP_API(int) LDAP_CALL ldap_sasl_bind( LDAP *ld, const char
*dn,
*msgidp );
LDAP_API(int) LDAP_CALL ldap_sasl_bind_s( LDAP *ld, const char
*dn,
The parameters are described below:
•
ld
containing information about the connection to the LDAP server.
•
dn
authenticate.
•
mechanism
authentication (the mechanism that you register in the initialization function
for your server plug-in).
•
cred
want to use for authentication.
•
serverctrls
the LDAPv3 server controls that you want passed to the server for the bind
operation.
•
clientctrls
the LDAPv3 client controls applicable to the bind operation.
•
msgidp
result of this operation, call the
ldap_parse_sasl_bind_result()
•
servercredp
credentials returned by the server. These are the credentials that you set as the
value of the
bind plug-in function.
114 Red Hat Directory Server Plug-in Programmer's Guide • May 2005
ldap_sasl_bind()
ldap_parse_sasl_bind_result()
const char *mechanism, struct berval *cred,
LDAPControl **serverctrls, LDAPControl **clientctrls, int
const char *mechanism, struct berval *cred,
LDAPControl **serverctrls, LDAPControl **clientctrls,
struct berval **servercredp );
is the connection handle, which is a pointer to the LDAP structure
is the distinguished name (DN) as which your client is attempting to
is the name of the SASL mechanism that you want to use for
is a pointer to the
is a pointer to an array of
is a pointer to an array of
is a pointer to the message ID for this bind operation. To check the
is a pointer to a pointer to the
SLAPI_BIND_RET_SASLCREDS
or
ldap_sasl_bind_s()
structure containing the credentials that you
berval
LDAPControl
LDAPControl
ldap_result()
function.
berval
parameter in your pre-operation
function to
. These functions
structures representing
structures representing
function and the
structure containing any