Sun Java System Access Manager Policy Agent 2.2 Guide for Microsoft Internet Information Services 5.0

Configuring Agent for Microsoft IIS 5.0 for Basic Authentication

As explained in Preventing an Additional Authentication Prompt: Preparing to Install Agent for Microsoft IIS 5.0, preventing users from being prompted a second time for user name and password requires you to set the Basic Authentication filter. This section provides the final instructions of that process. At this point you have completed the tasks described in Preventing an Additional Authentication Prompt: Preparing to Install Agent for Microsoft IIS 5.0, installed the agent, and verified the installation. Furthermore, at this point, the authentication type is set to anonymous, which is the default setting. In the task that follows, you will change the authentication type to basic.

ProcedureTo Configure Agent for Microsoft IIS 5.0 for Basic Authentication

Before You Begin

The following information is helpful for this task.

The default location of the web agent AMAgent.properties configuration file is as follows:

PolicyAgent-base\iis\config\

where PolicyAgent-base is the directory you choose in which to install the web agent. The default location of PolicyAgent-base is as follows:

C:\Sun\Access_Manager\Agents\2.2\iis\config\

  1. Configure the com.sun.am.replaypasswd.key property in the AMAgent.properties configuration file as described in the substeps that follow.

    This step is similar to a step described in To Deploy the Post Authentication Module in Access Manager where you are instructed to configure the com.sun.am.replaypasswd.key property in the Access Manager AMConfig.properties configuration file. The value used in that task, must also be used in this task.

    1. Open the AMAgent.properties configuration file.

    2. Add the following property to the file:

      com.sun.am.replaypasswd.key
    3. Add the appropriate string as the value of the com.sun.am.replaypasswd.key property.

      For example, if the string used previously for the this same property, but in the Access Manager AMConfig.properties configuration file, was wuqUJyr=5Gc=, then this property would be set the same way as follows:

      com.sun.am.replaypasswd.key = wuqUJyr=5Gc=
  2. Set the authentication type of this agent by adding the following property and value to the AMAgent.properties configuration file:

    com.sun.am.policy.agents.config.iis.auth_type = Basic
  3. Enable basic authentication for this agent by adding the following property and value to the AMAgent.properties configuration file:

    com.sun.am.policy.agents.config.iis.Use_Basic_Auth = true
  4. Save and close the AMAgent.properties configuration file.

  5. Restart the Microsoft IIS 5.0 server.