8.6 Installing Web Server 2 and Web Policy Agent 2

Use the following as your checklist for installing Web Server 2 and Web Policy Agent 2:

1. Install Web Server 2 on Protected Resource 2.

2. Install Web Policy Agent 2.

3. Verify that Web Policy Agent 2 works properly.

4. Import the root CA certificate into the Web Server 2 key store.

5. Create an agent profile on Access Manager.

6. Configure the Web Policy Agent to use the new agent profile.

To Install Web Server 2 on Protected Resource 2

1. As root, log in to host ProtectedResource-2.

2. Start the Java Enterprise System installer with the -nodisplay option.

   # cd /mnt/Solaris_sparc # ./installer -nodisplay

3. When prompted, provide the following information:

   Welcome to the Sun Java(TM) Enterprise System; serious software made simple... <Press ENTER to Continue>	Press Enter.
   <Press ENTER to display the Software License Agreement>	Press Enter.
   Have you read, and do you accept, all of the termsof the preceding Software License Agreement [No]	Enter y.
   Please enter a comma separated list of languages you would like supported with this installation [8]	Enter 8 for “English only.”
   Enter a comma separated list of products to install,or press R to refresh the list []	Enter 3 to select Web Server.
   Press "Enter" to Continue or Enter a comma separated list of products to deselect... [1]	Press Enter.
   Enter 1 to upgrade these shared components and 2 to cancel [1]	You are prompted to upgrade shared components only if the installer detects that an upgrade is required.  Enter 1 to upgrade shared components.
   Enter the name of the target installation directory for each product: Web Server [/opt/SUNWwbsvr] :	Accept the default value.
   System ready for installation Enter 1 to continue [1]	Enter 1.
   1. Configure Now - Selectively override defaults or express through 2. Configure Later - Manually configure following installation Select Type of Configuration [1]	Enter 1.
   Common Server Settings Enter Host Name [ProtectedResource-2]	Accept the default value.
   Enter DNS Domain Name [example.com]	Accept the default value.
   Enter IP Address [xxx.xx.87.180]	Accept the default value.
   Enter Server admin User ID [admin]	Enter admin.
   Enter Admin User's Password (Password cannot be less than 8 characters) []	For this example, enter web4dmin.
   Confirm Admin User's Password []	Enter the same password to confirm it.
   Enter System User [root]	Accept the default value.
   Enter System Group [root]	Accept the default value.
   Enter Server Admin User ID [admin]	Accept the default value.
   Enter Admin User's Password []	For this example, enter web4dmin.
   Enter Host Name [ProtectedResource-2.example.com]	Accept the default value.
   Enter Administration Port [8888]	Accept the default value.
   Enter Administration Server User ID [root]	Accept the default value.
   Enter System User ID [webservd]	Enter root.
   Enter System Group [webservd]	Enter root.
   Enter HTTP Port [80]	Enter 1080.
   Enter content Root [/opt/SUNWwbsvr/docs]	Accept the default value.
   Do you want to automatically start Web Serverwhen system re-starts.(Y/N) [N]	Accept the default value.
   Ready to Install 1. Install 2. Start Over 3. Exit Installation What would you like to do [1]	First, see the next numbered (Optional) step. When ready to install, enter 1.

4. (Optional) During installation, you can monitor the log to watch for installation errors. Example:

   # cd /var/sadm/install/logs # tail —f Java_Enterprise_System_install.B xxxxxx

5. Upon successful installation, enter ! to exit.

6. Verify that the Web Server is installed properly.

   1. Start the Web Server administration server to verify it starts with no errors.

      # cd /opt/SUNWwbsvr/https-admserv

      # ./stop; ./start

   2. Run the netstat command to verify that the Web Server ports are open and listening.

      # netstat -an | grep 8888 *.8888 *.* 0 0 49152 0 LISTEN

   3. Go to the Web Server URL.

      http://ProtectedResource-2.example.com:8888

   4. Log in to the Web Server using the following information:

      User Name:

      admin

      Password:

      web4dmin

      You should be able to see the Web Server console. You can log out of the console now.

   5. Start the Protected Resource 2 instance.

      #cd /opt/SUNWwbsvr/https-ProtectedResource-2.example.com # ./stop; ./start

   6. Run the netstat command to verify that the Web Server ports are open and listening.

      # netstat -an | grep 1080 *.1080 *.* 0 0 49152 0 LISTEN

   7. Go to the instance URL.

      http://ProtectedResource-2.example.com:1080

      You should see the default Web Server index page.

To Install Web Policy Agent 2

Before You Begin

The Java System Web Policy Agents 2.2 package must be downloaded to each Protected Resource that will host a Web Policy Agent. You can download the package from the following website: http://www.sun.com/download

Due to a known problem with this version of the Web Policy Agent, you must start an X-display session on the server host using a program such as Reflections X or VNC, even though you use the command-line installer. For more information about this known problem, see http://docs.sun.com/app/docs/doc/819-2796/6n52flfoq?a=view#adtcd.

1. Log in as a root user to host ProtectedResource-2.

2. Download the Java System Web Policy Agents 2.2 package from the following website:

   http://www.sun.com/download

3. Unpack the downloaded package.

   In this example, the package was downloaded into the directory /temp.

   # cd /temp

   # gunzip sun-one-policy-agent-2.2-es6-solaris_sparc.tar.gz

   # tar —xvof sun-one-policy-agent-2.2-es6-solaris_sparc.tar

4. Start the Web Policy Agents installer.

   # ./setup -nodisplay

5. When prompted, provide the following information:

   When you are ready, press Enter to continue. <Press ENTER to Continue>	Press Enter.
   Press ENTER to display the Sun Software License Agreement	Press Enter.
   Have you read, and do you accept, all of the terms of the preceding Software License Agreement [no] y	Enter y.
   Install the Sun Java(tm) System Access Manager Policy Agent in this directory [/opt] :	Accept the default value.
   Enter information about the server instance this agent will protect. Host Name [ProtectedResource-2.example.com]:	Accept the default value.
   Web Server Instance Directory [] {	Enter .  /opt/SUNWwbsvr/ https-ProtectedResource-2.example.com
   Web Server Port [80]: :	Enter 1080.
   Web Server Protocol [http]	Accept the default value.
   Agent Deployment URI [/amagent]:	Accept the default value.
   Enter the Sun Java(tm) System Access Manager Information for this Agent. Primary Server Host [ProtectedResource-1.example.com] :	For this example, enter the external-facing load balancer host name. Example: LoadBalancer-3.example.com
   Primary Server Port [1080]	Enter the load balancer HTTP port number. For this example, enter 90.
   Primary Server Protocol [http]:	Accept the default value.
   Primary Server Deployment URI [/amserver]:	Accept the default value.
   Primary Console Deployment URI [/amconsole] :	Accept the default value.
   Failover Server Host :	Accept the default value.
   Agent-Access Manager Shared Secret:	Enter the amldapuser password that was entered when Access Manager was installed. For this example, enter 4mld4puser .
   Re-enter Shared Secret:	Enter the 4mld4puser password again to confirm it.
   CDSSO Enabled [false]:	Accept the default value.
   Press "Enter" when you are ready to continue.	First, see the next (Optional) numbered step. When you are ready to start installation, press Enter.

6. (Optional) During installation, you can monitor the log to watch for installation errors. Example:

   # cd /var/sadm/install/logs # tail —f /var/sadm/install/logs/ Sun_Java_tm__System_Access_Manager_Policy_Agent_install.Bxxxxxx

7. Modify the AMAgent.properties file.

   # cd /etc/opt/SUNWam/agents/es6/ config/_opt_SUNWwbsvr_https-ProtectedResource-2.example.com

   Make a backup of AMAgent.properties before setting the following property:

   com.sun.am.policy.am.login.url = https://LoadBalancer-4.example.com:9443/distAuth/UI/Login?realm=users

8. Restart the Web Server.

   Watch for errors as the server starts up.

   # cd /opt/SUNWwbsvr/https-ProtectedResource-2.example.com

   # ./stop; ./start

   1. Examine the Web Server log for startup errors.

      # /opt/SUNWwbsvr/https-ProtectedResource-2.example.com/logs

      # vi errors

To Verify that Web Policy Agent 2 Works Properly

1. Start a new browser and go to the Access Manager URL.

   Example: https://loadbalancer-3.example.com:9443/amserver/console

2. Log in to Access Manager using the following information:

   Username

   amadmin

   Password

   4m4dmin1

3. Create a referral policy in the top-level realm.

   1. On the Access Control tab, under Realms, click example.com.

   2. Click the Policies tab.

   3. On the Policies tab for example.com-Policies, click the “Referral URL Policy for users realm” link.

   4. In the Edit Policy page, under Rules, click New.

   5. In the Edit Rule page, provide the following information.

   6. On the same page, in the Rules section, click New.

   7. Select a Service Type.

      On the page “Step 1 of 2: Select Service Type for the Rule,” select URL Policy Agent (with resource name)

   8. Click Next.

   9. On the page “Step 2 of 2: New Rule,” provide the following information:

      Name:

      URL Rule for ProtectedResource-2

      Resource Name:

      http://ProtectedResource-2.example.com:1080/*

   10. Click Finish.

   11. On the Edit Policy page, click Save.

       In the Policies tab for example.com — Policies, you should see the policy named Referral URL Policy for users realm.

4. Create a policy in the users realm.

   1. Click Realms.

   2. On the Access Control tab, under Realms, click the Realm Name users.

   3. Click the Policies tab.

   4. On the Policies tab for users-Policies, click New Policy.

   5. In the New Policy page, provide the following information:

      Name:

      URL Policy for ProtectedResource-2

      Active:

      Verify that the checkbox is marked.

   6. On the same page, in the Rules section, click New.

   7. On the page “Step 1 of 2: Select Service Type for the Rule,” click Next.

      The Service Type “URL Policy Agent (with resource name) is the only choice.

   8. On the page “Step 2 of 2: New Rule,” provide the following information:

      Name:

      URL Rule for ProtectedResource-2

      Resource Name:

      Click the URL listed in the Parent Resource Name list: http://ProtectedResource-2.example.com:1080/*

      The URL is automatically added to the Resource Name field.

      GET:

      Mark this checkbox, and select the Allow value.

      POST:

      Mark this checkbox, and select the Allow value.

   9. Click Finish.

   10. On the Policy page, in the Subjects section, click New.

       1. Select the subject type.

          On the page “Step 1 of 2: Select Subject Type,” select the Access Manager Identity Subject type.

       2. On the page “Step 2 of 2: New Subject — Access Manager Identity Subject,” provide the following information:

          Name:

          Test Subject

          Filter:

          Choose User, and then click Search. Four users are added to the Available list.

          Available:

          In the list, select testuser1, and then click Add.

          The user testuser1 is added to the Selected list.

       3. Click Finish.

   11. In the New Policy page, click Create.

       On the Policies tab for users-Policies, the new policy “URL Policy for ProtectedResource-2” is now in the Policies list.

5. Verify that the new policy works with Web Policy Agent 2.

   1. Verify that an authorized user can access the Web Server 2.

      1. Go to the following URL:

         http://ProtectedResource-2.example.com:1080

      2. Log in to Access Manager using the following information:

         Username

         testuser1

         Password

         password

         You should see the default index.html page for Web Server 2.

   2. Verify that an unauthorized user cannot access the Web Server 2.

      1. Go to the following URL:

         http://ProtectedResource-2.example.com:1080

      2. Log in to Access Manager using the following information:

         Username

         testuser2

         Password

         password

         You should see the message, “You're not authorized to view this page.”

To Import the Root CA Certificate into the Web Server 2 Key Store

The Web Policy Agent on Protected Resource 1 connects to Access Manager servers through Load Balancer 3. The load balancer is SSL-enabled, so the agent must be able to trust the load balancer SSL certificate in order to establish the SSL connection. To do this, import the root CA certificate that issued the Load Balancer 3 SSL server certificate into the Web Policy Agent certificate store.

Before You Begin

Obtain the root CA certificate, and copy it to ProtectedResource-2.

1. Copy the root CA certificate to Protected Resource 2.

2. Open a browser, and go to the Web Server 2 administration console.

   http://ProtectedResource-2.example.com:8888

3. Log in to the Web Server 2 console using the following information:

   User Name:

   admin

   Password:

   web4dmin

4. In the Select a Server field, select ProtectedResource-2.example.com, and then click Manage.

   ---

   Tip –

   If a “Configuration files have not been loaded” message is displayed, it may be that the administration server has never been accessed, and so the configuration files have never been loaded. First click Apply, and then click Apply Changes. The configuration files are read, and the server is stopped and restarted.

   ---

5. Click the Security tab.

6. On the Initialize Trust Database page, enter a Database Password.

   Enter the password again to confirm it, and then click OK.

7. In the left frame, click Install Certificate and provide the following information, and then click OK:

   Certificate For:

   Choose Trusted Certificate Authority (CA)

   Key Pair File Password:

   password

   Certificate Name:

   OpenSSL_CA_Cert

   Message in this File:

   /export/software/ca.cert

8. Click Add Server Certificate.

9. Click Manage Certificates.

   The root CA Certificate name OpenSSL_CA_Cert is included in the list of certificates.

10. Click the Preferences tab.

11. Restart Web Server 2.

    On the Server On/Off page, click Server Off. When the server indicates that the administration server is off, click Server On.

12. Configure the Web Policy Agent 2 to point to the Access Manager SSL port.

    1. Edit the AMAgent.properties file.

       # cd /opt/SUNWam/agents/es5/config/
       _optSUNWwbsvr_https=ProtectedResource-2.example.com

       Make a backup of the AMAgent.properties file before setting the following property:

       # com.sun.am.naming.url = 
       https://LoadBalancer-3.example.com:9443/amserver/namingservice

    2. Save the file.

13. Restart Web Server 2.

    # cd /opt/SUNWwbsvr/https-ProtectedResource-2.example.com
    # ./stop; ./start

To Create an Agent Profile on Access Manager

This new account will be used by J2EE Policy Agent 2 to access the Access Manager server.

1. Create an agent profile on Access Manager.

   1. Go to Access Manage load balancer URL:

      https://LoadBalancer-3.example.com:9443/amserver/UI/Login

   2. Log in to the Access Manager console using the following information:

      Username

      amadmin

      Password

      4m4dmin1

   3. On the Access Control tab, under Realms, click the realm name example.com.

   4. Click the Subjects tab.

   5. Click the Agents tab.

   6. On the Agent page, click New.

   7. On the New Agent page, provide the following information:

      ID:

      webagent-2

      Password:

      web4gent2

      Password Confirm:

      web4gent2

      Device State:

      Choose Active.

   8. Click Create.

      The new agent webagent–2 is now display in the list of Agent Users.

To Configure the Web Policy Agent to Use the New Agent Profile

1. Log in to as a root user to Protected Resource 2.

2. Run the cypt_util utility.

   The utility encrypts the password.

   # cd /opt/SUNWam/agents/bin
   # ./crypt_util web4gent2
   BXxzBswD+PZdMRDRMXQQA==

   Copy the encrypted password, and save it in a text file.

3. Edit the AMAgent.properties file.

   # cd /etc/opt/SUNWam/agents/es6/ config/_opt_SUNWwbsvr_https-ProtectedResource-2.example.com

   Make a backup of AMAgent.properties you make the following change in the file:

   com.sun.am.policy.am.password = webagent-2
   com.sun.am.policy.am.password = BXxzBswD+PZdMRDRMXQQA==

   Use the encrypted password obtained in the previous step.

   Save the file.

4. Restart Web Server 2.

   # cd /opt/SUNWwbsvr/https-ProtectedResource-2.example.com
    # ./stop; ./start