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 Modules, Handlers and Filters for Integrated 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 of adding the module and handlers used by SiteMinder for applications using Integrated pipeline mode on an IIS 7.x server. Evaluate your particular implementation and modify any steps accordingly.

To add modules, handlers, and filters for integrated 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 module with the following command:

   appcmd/commit add module /name:CASiteMinderWebagentModule/app.name:"your_web_site_name/" /preCondition:integratedMode
   

   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.

3. Add the kcc handler with the following command:

   appcmd/commit set config"your_web_site_name/" /section:system.webServer/handlers/+[name='CASiteMinderWebAgentHandler-kcc',path='*.kcc',verb='*',modules='CASiteMinderWebagentModule',resourceType='Unspecified',preCondition='integratedMode']
   

4. Add the scc handler with the following command:

   appcmd/commit set config"your_web_site_name/" /section:system.webServer/handlers /+[name='CASiteMinderWebAgentHandler-scc',path='*.scc',verb='*',modules='CASiteMinderWebagentModule',resourceType='Unspecified',preCondition='integratedMode']
   

5. Add the ccc handler with the following command:

   appcmd/commit set config"your_web_site_name/" /section:system.webServer/handlers /+[name='CASiteMinderWebAgentHandler-ccc',path='*.ccc',verb='*',modules='CASiteMinderWebagentModule',resourceType='Unspecified',preCondition='integratedMode']
   

6. Add the ntc handler with the following command:

   appcmd/commit set config"your_web_site_name/" /section:system.webServer/handlers /+[name='CASiteMinderWebAgentHandler-ntc',path='*.ntc',verb='*',modules='CASiteMinderWebagentModule',resourceType='Unspecified',preCondition='integratedMode']
   

7. Add the fcc handler with the following command:

   appcmd/commit set config"your_web_site_name/" /section:system.webServer/handlers /+[name='CASiteMinderWebAgentHandler-fcc',path='*.fcc',verb='*',modules='CASiteMinderWebagentModule',resourceType='Unspecified',preCondition='integratedMode']
   

8. Set the configuration with the following command:

   appcmd/commit set config"your_web_site_name" /section:system.web/identity /impersonate:"false"
   

   The modules, handlers and filters for Integrated Pipeline mode applications are added.