Agent Guides › SAML Affiliate Agent Guide › Install a SAML Affiliate Agent › Configure the SAML Affiliate Agent for Your Web Server › Configure an Apache Web Server for the SAML Affiliate Agent

Configure an Apache Web Server for the SAML Affiliate Agent

After you install the Agent, modify the httpd.conf configuration file to enable the Apache web server to operate with the SAML Affiliate Agent.

Some of the files in the following procedure use the Solaris file extension (.so) in the file names. The extension can differ depending on your operating system.

To modify the httpd.conf file

1. Stop the web server.
2. Navigate to the conf directory: /Apache_home/conf

   Example: $ cd /usr/apache/conf

3. Open the httpd.conf file.
4. Do one of the following:

   For Apache 2.x, add the following lines to the DSO configuration section:

   • LoadModule smAffiliate_module plugins_directory/libApache20AffiliateAgent.so

     where plugins_directory is the full path to the SAML Affiliate Agent plugins directory.

   • SmAffiliateInitFile saml_affiliate_agent_home/config/AffiliateConfig.xml

     Place this entry after the LoadModule entry. Do not use a relative path for this location.

   The modified sections of the file must resemble the sample text below for Apache 2.0.43:

   # Dynamic Shared Object (DSO) Support
   #
   # To be able to use the functionality of a module which
   # was built as a DSO you have to place corresponding
   #`LoadModule' lines at this #location so the
   # directives contained in it are actually available
   # _before_ they are used. Statically compiled modules
   # (those listed by `httpd -l') do not need to be loaded
   # here.
   #
   # Example:
   # LoadModule foo_module modules/mod_foo.so
   #
   LoadModule smAffiliate_module /export/aa259/affiliateagent/bin/plugins/libApache20AffiliateAgent.so
   SmAffiliateInitFile /export/netegrity/affiliateagent/config/AffiliateConfig.xml
   

   For Apache 1.x, add the following lines to the DSO configuration section:

   • LoadModule smAffiliate_module plugins_directory/libApacheAffiliateAgent.so

     where plugins_directory is the full path to the SAML Affiliate Agent plugins directory.

   • SmAffiliateInitFile saml_affiliate_agent_home/config/AffiliateConfig.xml

     Place this entry after the LoadModule entry. Do not use a relative path for this location.

5. Save the modified httpd.conf file.
6. If you have not already done so, enable the SAML Affiliate Agent.
   1. Open the AffiliateConfig.xml file, located as follows:

      saml_affiliate_agent_home/config

   2. In the PerAffiliateInfo section, set the Enabled attribute to yes.
7. Restart the web server and run the nete-af-env.sh script.

   Note: Any time you have to restart the Apache Web server with the SAML Affiliate Agent, run the nete-af-env.sh script to set required environment variables.

8. Compile the Apache web server, as instructed in the next section.