This chapter provides information about Sun Java System Policy Agent 2.2 as it pertains specifically to Microsoft IIS 6.0.
While the individual web agents tend to be similar in terms of installation and configuration, they can have unique characteristics that allow them to interact with unique characteristics in the underlying deployment container, such as a web server or proxy server. Therefore, this chapter describes characteristics that are unique to this agent, Sun Java System Access Manager Policy Agent 2.2 for Microsoft IIS 6.0, and that are unique to just the deployment container, Microsoft IIS 6.0. This chapter also summarizes specific tasks you might need to perform because of the unique characteristics of the deployment container.
The following sections provide information about the supported platforms of Policy Agent 2.2 for Microsoft IIS 6.0 as well as the compatibility of this agent with Access Manager.
The following table presents the supported platforms of Policy Agent 2.2 for Microsoft Internet Information Services 6.0. Throughout this guide the Microsoft Internet Information Services 6.0 deployment container is referred to as Microsoft IIS 6.0.
Table 2–1 Supported Platforms of Agent for Microsoft IIS 6.0
Agent for |
Supported Platforms |
---|---|
Microsoft Internet Information Services 6.0 (Microsoft IIS 6.0) Note – This agent can be deployed to protect Microsoft Office SharePoint and Outlook Web Access. |
Windows 2003, Enterprise Edition (includes all service packs, such as SP1, SP2, and so on) Windows 2003, Standard Edition (includes all service packs, such as SP1, SP2, and so on) |
All agents in the Policy Agent 2.2 release are compatible with versions of Sun Java System Access Manager as described in this section.
All agents in the Policy Agent 2.2 release are compatible with Access Manager 7 and Access Manager 7.1. Compatibility applies to both of the available modes of Access Manager: Realm Mode and Legacy Mode.
Install the latest Access Manager patches to ensure that all enhancements and fixes are applied. For an example of Access Manager patches that can be installed, see the compatibility information discussed in Sun Java System Access Manager Policy Agent 2.2 Release Notes.
All agents in Policy Agent 2.2 are also compatible with Access Manager 6.3 Patch 1 or greater. However, certain limitations apply. For more information about the limitations, see Backward Compatibility With Access Manager 6.3.
This section describes characteristics that are unique about this specific web agent.
To work with this web agent, you should have a thorough understanding of Microsoft IIS 6.0. Besides an understanding of the overall architecture, you should have an understanding of various concepts and technologies as related to Microsoft IIS 6.0, including the following: application pools, web sites, and authentication methods.
Agent for Microsoft IIS 6.0 is an ISAPI (Internet Server API) application. It is deployed as a wildcard application mapping to a web site. Therefore, when deployed for a particular web site, this agent intercepts every request for accessing the resources on that web site. It does authentication and policy evaluation, thereby providing SSO. If all the conditions are met, the agent allows access to the resource.
However, for protecting Microsoft Office SharePoint and Outlook Web Access, the agent is deployed as an ISAPI filter. In this case, authentication is provided and SSO is enabled by the agent, but policy evaluation is managed by whichever application you have installed: Microsoft Office SharePoint or Outlook Web Access.
The following subsections describe unique characteristics of Agent for Microsoft IIS 6.0.
Using Agent for Microsoft IIS 6.0 with Microsoft Office SharePoint or Outlook Web Access
Multiple Instances of Web Agent Not Supported on Same System
Besides the option of having Agent for Microsoft IIS 6.0 protect Microsoft IIS 6.0 Server, you can also configure the agent to protect Microsoft Office SharePoint Portal Server 2003 (referred to as Microsoft Office SharePoint Server throughout this guide) or Outlook Web Access for Microsoft Exchange Server 2003 (referred to as Outlook Web Access throughout this guide). Outlook Web Access is the web-based email service for Microsoft Exchange Server.
This guide provides specific instructions for SharePoint and Outlook Web Access in Appendix A, Microsoft Office SharePoint or Outlook Web Access: Deploying Agent for Microsoft IIS 6.0.
When you install Agent for Microsoft IIS 6.0 to protect Microsoft Office SharePoint Server, the agent enables single sign-on (SSO) for SharePoint with all the applications configured in Access Manager. When a user attempts to access SharePoint, Agent for Microsoft IIS 6.0 displays an Access Manager log-in screen. Once authenticated, the user can access SharePoint and all other applications that are secured by Access Manager.
When you install Agent for Microsoft IIS 6.0 to protect Outlook Web Access, the agent enables single sign-on (SSO) for Outlook Web Access with all the applications configured in Access Manager. When a user attempts to access Outlook Web Access, Agent for Microsoft IIS 6.0 displays an Access Manager log-in screen. Once authenticated, the user can access the Outlook Web Access applications, such as email, and all the other applications that are secured by Access Manager.
Policy Agent 2.2 for Microsoft IIS 6.0 is unique in that only one instance of Microsoft IIS 6.0 can be installed per computer system. Therefore, you cannot install multiple instances of Agent for Microsoft IIS 6.0 on the same computer system. However, you can configure multiple web sites on one machine, allowing the agent to be configured for multiple web sites on multiple application pools. All the same, the agent cannot be configured for multiple web sites on the same application pool.
Agent for Microsoft IIS 6.0 supports the configuration of a single web site associated with a single application pool. This agent also supports the configuration of multiple web sites where each web site is assigned to a different application pool. However, this agent is not designed to work when multiple web sites are assigned to the same application pool.
If Microsoft IIS 6.0 is configured to run in IIS 5.0 isolation mode, use Policy Agent 2.2 for Microsoft IIS 5.0 and not this Policy Agent 2.2 for Microsoft IIS 6.0. For information see Sun Java System Access Manager Policy Agent 2.2 Guide for Microsoft Internet Information Services 5.0.