Configuration Guides › SOA Agent for Web Servers Guide › Configure the SOA Agent to Work on an IIS Web Server › How to Configure a SOA Security Manager Web Agent on IIS 7.5 › Add Handler Mappings to the IIS 7.5 Web Sites you want to Protect with SOA Security Manager

Add Handler Mappings to the IIS 7.5 Web Sites you want to Protect with SOA Security Manager

To run a SOA Security Manager Web Agent on IIS 7.5, add the SOA Security Manager handler mappings to the top-level folder of each IIS 7.5 website you want to protect.

The following illustration shows a top-level folder named "Default Web Site," which needs the handler mappings added manually:

To add the handler mappings to the IIS 7.5 web sites that you want to protect with SOA Security Manager

1. Open the Internet Information Services (IIS) Manager.

   Note: If the User Account Control dialog appears, click Continue.

2. In the Connections pane, expand the web server.

   The Sites folder appears.

3. Expand the Sites folder, and then click the icon of a website that you want to protect with SOA Security Manager.
4. Under the IIS section, double-click the Handler Mappings icon.

   A list of the installed handler mappings appears.

5. In the Disabled list, click the following handler mapping:

   ISAPI-dll
   

6. In the Actions pane, click Edit Feature Permissions...

   The Edit Feature Permissions dialog appears.

7. Select the following check boxes:
   • Read
   • Script
   • Execute
8. Click OK.

   The Edit Feature Permissions dialog closes.

9. In the Actions pane, click Add Wildcard Script map.

   The Add Wildcard Script Map dialog appears.

10. Click the ellipsis button (to the right of the Executable field).

    The Open dialog appears.

11. Navigate to the following file:

    web_agent_home\bin\ISAPI6WebAgent.DLL
    

    Note: The default value of the web_agent_home variable is [set Access Path variable]\webagent.

12. Click Open.

    The ISAPI6WebAgentDLL.dll file appears in the Add Wildcard Script Map dialog.

13. In the Name field, type a name for the mapping. We recommend using a name that is easy to recognize, such as "handler-wa."
14. Click OK.

    A confirmation dialog appears.

15. Click Yes.

    The Add Wildcard Script Map dialog closes and the mapping appears in the list. The handler mapping is added to the protected website.

16. Repeat Steps 3 through 15 for all of the other web sites on the IIS 7.5 web server that you want to protect with SOA Security Manager.

    The handler mappings are added.