Module mod_ibm_linc

Important: Information for this topic supports the latest PTF levels for HTTP Server for i5/OS . It is recommended that you install the latest PTFs to upgrade to the latest level of the HTTP Server for i5/OS. Some of the topics documented here are not available prior to this update. See http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm Link outside Information Center for more information.

Summary

The module mod_ibm_linc supports the LDAPInclude directive that allows HTTP Server to access a Lightweight Directory Access Protocol (LDAP) directory and to query the directory in a database fashion to obtain HTTP configuration information. The LDAPInclude directive requires a file that contains the directives necessary to contact the LDAP server. This can be the same filename that is used on the LdapConfigFile directive. See the mod_ibm_ldap module for details on the directives necessary to contact an LDAP server.

If the LDAPInclude directive is placed in the server configuration file, the following directive must be specified prior to its use: 

LoadModule ibm_ldap_include /QSYS.LIB/QHTTPSVR.LIB/QZSRVLDAP.SRVPGM

Directive

LDAPInclude

Module: mod_ibm_linc
Syntax: LDAPInclude filename filter attribute
Default: none
Context: server config, virtual host, directory
Override: none
Origin: iSeries™
Example: LDAPInclude /QIBM/UserData/HTTPA/LDAP/ldap.prop (cn=web) binProperty

LDAPInclude directive is used to retrieve HTTP configuration information that is stored in an LDAP directory. The LDAP server is contacted using information from the configuration file provided, and an LDAP search is performed using the filter. Once information is returned from the LDAP search, the values of the attributes are then used as part of the HTTP configuration file.

The same filename that is used on an LDAPConfigFile directive may also be used for the LDAPInclude directive.

Parameter One: filename
  • The filename parameter is the name of the file that contains LDAP directives required to connect to an LDAP server.
Parameter Two: filter
  • The filter parameter is the search string that is passed from HTTP Server to the LDAP server to return an LDAP entry.
Parameter Three: attribute
  • The attribute parameter is the name of the LDAP attribute whose value is some arbitrary part of HTTP Server configuration file.