i-Planet Administration Guide

Adding or Removing Modules

By default all modules except the UNIX module are enabled. When multiple modules are enabled, the end users see a menu of all the possible authentication modules. When end users click the link for a specific module, the authentication server loads that module and the end users receive the HTML pages for that module. If only one module is enabled, then no menu is sent and the user is sent directly to the enabled authentication module.

Follow these steps to add or remove login modules from i-Planet. (In this example, a RADIUS authentication module is being added, but you use the same steps to add or remove any of the modules.)

To Add (Remove) a Module to (from) the List of Authentication Modules
  1. On the i-Planet gateway in the file named reverseproxy.policy in the directory /opt/SUNWsnrp/policy, add the line:

    * http://i-Planet _server.eng.sun.com:8080/login/Radius

    This line tells the i-Planet gateway to allow a URL to reach the RADIUS authentication module to start the authentication process. You can add it anywhere in the file. The i-Planet gateway uses this file to decide which URLs will be forwarded to the i-Planet server.

    If you were removing the RADIUS module, you would delete that line.

  2. As root, type the following to stop and restart the reverse proxy on the i-Planet gateway for it to recognize the changes:


    # /opt/SUNWsnrp/bin/iplanet_gw stop
    # /opt/SUNWsnrp/bin/iplanet_gw start
    

  3. On the i-Planet server, start the web browser that you are going to use.

  4. Type the URL for the Administration Console:

    http://fully_qualilfied_name_of_i-Planet_server_host:8080/console.
  5. Click the Authentication link.

  6. Add the following information to the Authentication Modules list:

    com.sun.login.radius.Radius

    If you were removing a module, you would delete the line.

  7. Click the Enter button at the bottom of the page when you have added or removed a module to save your changes.

  8. As root, on the i-Planet server, type the following to stop and restart the web server:


    # /opt/SUNWjeev/bin/iplanet_serv stop
    # /opt/SUNWjeev/bin/iplanet_serv start