mldap_logon

Example: mldap_logonListing Directory Vuser Functions (MLDAP)

Performs a login to an LDAP server.

int mldap_logon( char *transaction, char *url, [<List of Attributes>,]LAST );
transactionA transaction name for this step. To instruct VuGen not to create a transaction for this step, use a NULL string, "".
URL The URL of the LDAP server, including the server name: "URL=ldap path"The LDAP path should have the following format:
  ldap://username:password@server:port
List of AttributesOptional: A comma-separated list of attributes. See the list below. Each argument is a quoted key-value pair, for example, "KeyName=Value".
LAST A marker indicating the end of the argument list.

The mldap_logon function performs a login to an LDAP server.

This function is for use with global sessions. For multiple sessions, use the mldap_logon_ex function, which allows you to specify a session identifier.

Possible attribute arguments:

Argument Description
Mode=<mode> The LDAP call mode. Either Sync or Async
Timeout=<seconds> The LDAP search timeout.
Version=<n> The LDAP protocol version. For example,1,2,or 3.
SSLCertDir=<path> The path to the SSL certificates database file (cert8.db). The SSLCertDir parameter is required if an SSL connection is going to be established.
SSLKeysDir=<path> The path to the SSL keys database file (key3.db)
SSLKeyNickname=<nickname> The SSL key nickname in keys database file
SSLKeyCertNickname=<nickname> The SSL key's certificate nickname in the certificates database file
SSLKeysPassword=<password>The SSL key's password
SSLSecModule=<path> The path to the SSL security module file (secmod.db)
StartTLS Passing StartTLS specifies that the StartTLS extension's specific command must be issued to switch the connection to TLS(SSL) mode.
If StartTLS is used, then the URL parameter can be empty (URL=ldaps://). That means that TLS will be established on the existing session (pldap) without reconnecting to the server. This is equivalent to calling mldap_set_option with TLS=ON.

Examples of different URLs:

URL Effect
ldap://usr_name:pwd@server.com:389 Connects to the server (port 389) then binds with username usr_name , password pwd.
ldap://:@server.com Connects to server (default unsecured port 389) then binds anonymously : username = NULL, password = NULL.
ldaps://usr_name:@server.com Connects to server (default secured port 636) then binds with username usr_name, password "".
ldap://@server.com Connects to server, skips bind.
ldap://server.com Connects to server, skips bind.
ldap://usr_name:pwd@ Binds on existing session with username usr_name, password pwd, without reconnecting.
ldap://:@ Binds anonymously on existing session with username = NULL, password = NULL, without reconnecting.
ldap://:pwd@server.com" Not allowed.

Return Values

If this function succeeds, it returns E_OK. Otherwise, it returns a negative value.

Parameterization

No parameterization is available for this function.