Installation and Upgrade Guides › Web Agent Installation Guide for IIS › Configure a SiteMinder Agent for IIS or Web Agent on an IIS Web Server › How to Configure a SiteMinder Agent for IIS Manually › Add Modules, Handlers and Filters for Integrated Pipeline Mode Applications with Appcmd.exe › Add the Wildcard Mapping and Handlers for Classic Pipeline Mode Applications with Appcmd.exe

Add the Wildcard Mapping and Handlers for Classic Pipeline Mode Applications with Appcmd.exe

The third step for configuring a SiteMinder Web Agent for IIS manually is adding the modules, handlers and filters for SiteMinder on each website of your IIS 7.x web server. The appcmd.exe command (provided by Microsoft) provides a possible example of how to configure a Web Agent manually.

Important! CA provides this information only as an example of one possible method of configuring SiteMinder without using the programs and utilities tested and approved by CA. Microsoft provides the appcmd.exe command as part of the IIS web server. You may choose to use the following examples as a guide to configure your SiteMinder Web Agent for IIS. This command and the syntax shown are subject to change by Microsoft at any time and without notice. For more information, go to the IIS website, and search for "appcmd".

This procedure describes an example adding a wildcard mapping and a handler used by SiteMinder for applications using Classic pipeline mode on an IIS 7.x server. Evaluate your particular implementation and modify any steps accordingly.

To add the wildcard mapping and handler for classic pipeline mode applications with appcmd.exe

1. Open a Command Prompt Window on your IIS web server.

   Important! Before running a SiteMinder utility or executable on Windows Server 2008, open the command line window with administrator permissions. Open the command line window this way, even if your account has administrator privileges.

2. Add the wildcard mapping with the following command:

   appcmdset config"your_web_site_name/" /section:system.webServer/isapiFilters/+[name='"SiteMinderAgent"',path='"web_agent_home\bin\ISAPI6WebAgent.dll"',enabled='true',preCondition='classicMode']
   

   your_web_site_name

   Specifies the name of your website, as defined in the IIS Manager.

   Default: Default Web Site

   Limits: If the name contains spaces, enclose it with quotes.

   web_agent_home

   Indicates the directory where the SiteMinder Agent is installed on your web server.

   Default (Windows 32-bit installations of SiteMinder IIS Web Agents only): C:\Program Files\CA\webagent

   Default (Windows 64-bit installations [SiteMinder Web Agents for IIS only]): C:\Program Files\CA\webagent\win64

   Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with SiteMinder Web Agents for IIS only]): C:\Program Files (x86)\webagent\win32

3. Add the handler with the following command:

   appcmdset config"your_web_site_name/" /section:system.webServer/handlers /+[name='handler-wa',path='*',verb='*',modules='IsapiModule',scriptProcessor='"web_agent_home\bin\ISAPI6WebAgent.dll"',resourceType='Unspecified',requireAccess='None',preCondition='classicMode']
   

4. Set the configuration with the following command:

   appcmdset config-section:system.webServer/security/isapiCgiRestriction/+"[path='web_agent_home\bin\ISAPI6WebAgent.dll',allowed='True',groupId='Webagent',description='Webagent']" /commit:apphost
   

   The wildcard mapping and handlers for Classic Pipeline Mode Applications are set.