PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • How to proceed?
  • Branching the user groupware on an LDP directory without management of rights
  • Branching the user groupware on an LDP directory with management of rights
  • Starting the application
  • Installing the application that is using a LDAP directory
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Warning
From version 18, the user groupware evolves. This help page corresponds to the user groupware kept for backward compatibility. To get this help page for the new version of user groupware, see User Groupware and LDAP.
Overview
The LDAP protocol is increasingly used by the companies. The LDAP protocol is used to query and modify the directory services. For example, Active Directory of Microsoft provides LDAP access to its data.
In a company, an account and a password are assigned to the users by the "IT" manager.
This account and this password can be directly used by the user groupware of WINDEV and WEBDEV, with ability to define specific rights.
Note: The user groupware operates with Active Directory. It does not operate with openLDAP.
How to proceed?

Branching the user groupware on an LDP directory without management of rights

To branch the user groupware on an LDAP directory without management of rights:
  1. Configure the user groupware ("Workshop .. Configure the user groupware").
  2. In the "General" tab, check the options:
    • Use a LDAP directory to authenticate the users.
    • No management of rights
In this case, the user groupware will create no data file. A supervisor will not be able to define the rights for the windows and for the pages.
When the application is started, the login window or page asks the user to identify himself. If the user is saved in the LDAP directory, the application will start ; otherwise, it will be closed.

Branching the user groupware on an LDP directory with management of rights

To branch the user groupware on an LDAP directory with management of rights:
  1. Configure the user groupware ("Workshop .. Configure the user groupware").
  2. In the "General" tab, check "Use a LDAP directory to authenticate the users".
In this case, the user groupware creates the data files for managing the users and the rights. A supervisor can define the rights for the windows and for the pages.
Case 1: The database of the user groupware is empty. The LDAP database exists
An additional configuration must be performed when implementing the application.
  1. Connect to the application as Supervisor (Login: "Supervisor", Password: "Supervisor").
  2. Choose "Configure the groupware".
  3. Select "Import users from the LDAP directory". A window allows you to import all the users.
    Note: If you are not authenticated on the LDAP server (1st use for example), a login and password of an LDAP user will be requested. The selected LDAP user must have the rights to list the users of LDAP directory.
  4. Click the "Import" button. The import is performed, all the LDAP users are displayed in the list of users.
    Note: We advise you to grant supervisor rights to a specific user and to delete the default "Supervisor" user.
  5. You have the ability to assign rights to the imported users.
Case 2: The database of the user groupware already exists. The application connects to a LDAP database
Only the users found in the database of user groupware and in the LDAP database will be able to connect to the application (same logins for the users). The password to use is the LDAP password. The users not found in the LDAP database will not be able to start the application.
The rights can be managed by the users found both in the database of the groupware and in the LDAP database.
Note: Using an LDAP directory withe management of rights allows you to easily switch from the LDAP mode to the mode without LDAP. All you have to do is check "Use a LDAP directory".

Starting the application

In automatic run mode:
The characteristics of the LDAP server must be entered in the "LDAP" tab of the window for configuring the user groupware.
To find out the name of the user, all you have to do is call gpwGetUserInfo:
Info("Hello "+ gpwGetUserInfo(gpwInfoLogin))
In manual start mode:
To use the LDAP directory, a LDAP session must be started by gpwOpenLDAPSession before the call to gpwOpen:
gpwOpenLDAPSession("xx.mycompany.com", 389, 3, False)
gpwOpen()
To identify a user without opening the login window, use the following code:
gpwOpenLDAPSession("xx.mycompany.com", 389, 3, False)
IF gpwLogin("FP", "Password")<>gpwOk THEN
        Error("Invalid user or password")
        EndProgram()
END
WINDEVWindows

Installing the application that is using a LDAP directory

The parameters of the LDAP directory can be entered by the user when installing the application.
To do so, when creating the setup program of the application that uses the user groupware, ("Workshop .. Create the setup procedure"), check "Customize the path of the groupware files during setup"; in the "Parameters of databases" screen.
In this case, a screen specific to the user groupware will be displayed when the application is installed. This screen allows the person who installs the application to:
  • configure the location of the data files specific to the user groupware. See Data files of user groupware for more details.
  • enable the history of connections.
  • enable the authentication of the users via a LDAP directory. In this case, you will have to enter the address of the server, the port number and the LDAP version used.
Minimum required version
  • Version 12
This page is also available for…
Comments
Click [Add] to post a comment