Authenticating a User with LDAP
This topic shows you how to validate a user ID in WebDocs with an existing Lightweight Directory Access Protocol (LDAP) user ID and password.
Authenticating a WebDocs user with an existing LDAP user allows you to manage user credentials in one central location by using the existing network security resources in your LDAP server. Authenticating WebDocs users this way means that users have fewer user names and passwords to remember.
Note: You must have an LDAP-compatible server set up and running to authenticate a user's log-in with LDAP. If you have any questions, contact RJS Software.
To authenticate a user log-in with LDAP:
- Use the Set Default LDAP Host (DOCLDAP) command to specify the LDAP server host name or IP address.
-
Use the Default Windows Active Directory Domain (DOCDOMAIN) command to specify the Windows Active Directory server.
-
(Optional) If you need to, specify five additional LDAP hosts and domains. WebDocs searches the host and domain in steps 1-2 first. Then, if WebDocs does not find a matching user ID, it searches through these five hosts and domains, in order, until it finds a match.
Set up to five additional hosts in the DOCLDHOST1 - DOCLDHOST5 data areas and five additional domains in the DOCLDDOM1 - DOCLDDOM5 data areas. -
Use the DOCUSRCHK command to verify the user ID and password and test the Windows Active Directory set-up.
For example: To return an error message if an LDAP User namedTESThas an invalid user ID and password, use:
DOCUSRCHK USERID('TEST') PASSWORD('TEST') -
When you create users who will authenticate with LDAP, make their user names the same as their LDAP user IDs.
Note: The user name is case sensitive. -
For each user's password, type *LDAP.
Note:You do not need to know this password.
The user can now log in to WebDocs with the same user name and password as on your LDAP server.
See also Appendix A: Reference of Relevant Data Areas for a reference of LDAP data areas.