gpwOpenLDAPSession (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Checks

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

gpwOpenLDAPSession (Function)

In French: gpwOuvreSessionLDAP

Informs the user groupware that the authentication of users will be done via an LDAP directory. The name and password of the users who will connect to user groupware will be checked in the LDAP directory directly.

Note: This function is useless if the configuration of the LDAP directory was performed in the configuration window of user groupware ("Workshop .. Configure the user groupware").Note: This function is useless if the configuration of LDAP directory was performed in the configuration window of user groupware. To configure the user groupware, on the "Project" pane, in the "Project" group, click "User groupware".

Example

// User groupware used in automatic mode
// Manual start. No data files.

// Code of project
gpwOpenLDAPSession("gemini.myserver.com", 389, 3, False)

// Identification of a user without login window
IF gpwLogin("FP", "FP") <> gpwOk THEN
Error("Invalid user or password")
EndProgram()
END

// Use a base DN
gpwOpenLDAPSession("myserver", 389, 3, False, "DC=groupcom,DC=local")

Syntax

gpwOpenLDAPSession(<Server Address> [, <Port Number> [, <Server Version> [, <With Files> [, <Base DN> [, <Management of SSL>]]]]])

<Server Address>: Character string (with quotes)

Address of LDAP server. This parameter can correspond to:
IP address of server in xxx.xxx.xxx.xxx format
Name of server

<Port Number>: Optional integer

Port number of LDAP server (389 by default).

<Server Version>: Optional integer

Version of LDAP server (2 or 3). Corresponds to 3 by default.

<With Files>: Optional boolean

True (default value) to use the data files of groupware,
False to perform an LDAP authentication.

<Base DN>: Optional character string (with quotes)

Versions 15 and later
Base DN to use. This parameter has the following format: "DC=xxx, DC=yyy, DC=zzz, ...".
If this parameter is not specified, it will be automatically sought in the database.
New in version 15
Base DN to use. This parameter has the following format: "DC=xxx, DC=yyy, DC=zzz, ...".
If this parameter is not specified, it will be automatically sought in the database.
Base DN to use. This parameter has the following format: "DC=xxx, DC=yyy, DC=zzz, ...".
If this parameter is not specified, it will be automatically sought in the database.

<Management of SSL>: Integer constant (or combination of constants)

Versions 23 and later
Management mode of SSL:
ldapDefaultOption
(Default value) standard LDAP, without SSL management.
optionSSL LDAP with management of secure SSL connection.
optionSSL + auNegotiate LDAP with management of secure SSL connection and authentication. The connection is established via "Generic Security Services" (GSS) (Snego). The authentication method used is the most appropriate method found in a list of possibles authentications.

Note: The connection mode used must be supported by the LDAP server.
New in version 23
Management mode of SSL:
ldapDefaultOption
(Default value) standard LDAP, without SSL management.
optionSSL LDAP with management of secure SSL connection.
optionSSL + auNegotiate LDAP with management of secure SSL connection and authentication. The connection is established via "Generic Security Services" (GSS) (Snego). The authentication method used is the most appropriate method found in a list of possibles authentications.

Note: The connection mode used must be supported by the LDAP server.
Management mode of SSL:
ldapDefaultOption
(Default value) standard LDAP, without SSL management.
optionSSL LDAP with management of secure SSL connection.
optionSSL + auNegotiate LDAP with management of secure SSL connection and authentication. The connection is established via "Generic Security Services" (GSS) (Snego). The authentication method used is the most appropriate method found in a list of possibles authentications.

Note: The connection mode used must be supported by the LDAP server.

Remarks

Checks

The checks regarding the connection to the LDAP server, the user name and password are performed:

during the call to gpwLogin.
when validating the login window of the groupware.

Components

wd230gpu.dll