Configuring Oracle HTTP Server WebGate

Configuring Oracle HTTP Server WebGate for Oracle Access Manager requires several steps.

In the following examples:

• Replace OHS_ORACLE_HOME with the complete path to the Oracle home where you installed the Oracle HTTP Server software.

• Replace OHS_CONFIG_DIR with the path to the following location in the Oracle HTTP Server domain home:

  DOMAIN_HOME/config/fmwconfig/components/OHS/ohs_instance_name

1. Navigate to the deployWebGate directory in the Oracle HTTP Server Oracle home:

   (UNIX) cd OHS_ORACLE_HOME/webgate/ohs/tools/deployWebGate

   (Windows) cd OHS_ORACLE_HOME\webgate\ohs\tools\deployWebGate

2. Run the following command to create the WebGate Instance directory and enable WebGate logging on OHS Instance:

   (UNIX) ./deployWebGateInstance.sh -w OHS_CONFIG_DIR -oh OHS_ORACLE_HOME

   (Windows) deployWebGateInstance.bat -w OHS_CONFIG_DIR -oh OHS_ORACLE_HOME

3. Verify that a webgate directory and subdirectories was created by the deployWebGateInstance command:

   For example, on UNIX:

   ls -lart OHS_CONFIG_DIR/webgate/
   total 6
   drwxr-x---+ 8 orcl oinstall 20 Oct  2 07:14 ..
   drwxr-xr-x+ 4 orcl oinstall  4 Oct  2 07:14 .
   drwxr-xr-x+ 3 orcl oinstall  3 Oct  2 07:14 tools
   drwxr-xr-x+ 3 orcl oinstall  4 Oct  2 07:14 config
   

4. Run the following command to set the path environment variable:

   (UNIX) export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:OHS_ORACLE_HOME/lib

   (Windows) set PATH=%PATH%;OHS_ORACLE_HOME\bin

5. Navigate to the EditHttpConf directory:

   (UNIX) cd OHS_ORACLE_HOME/webgate/ohs/tools/setup/InstallTools

   (Windows) cd OHS_ORACLE_HOME\webgate\ohs\tools\EditHttpConf

6. Run the following command:

   (UNIX) ./EditHttpConf -w OHS_CONFIG_DIR [-oh OHS_ORACLE_HOME] [-o output_file_name] [-dcc custom_dcc_scripts/pages_location]

   (Windows) EditHttpConf -w OHS_CONFIG_DIR [-oh OHS_ORACLE_HOME] [-o output_file_name] [-dcc custom_dcc_scripts\pages_location]

   This command does the following:

   • Copies the apache_webgate.template file from the Oracle HTTP Server Oracle home to a new webgate.conf file in the Oracle HTTP Server configuration directory.

   • Updates the httpd.conf file to add one line, so it includes the webgate.conf.

   • Generates a WebGate configuration file. The default name of the file is webgate.conf, but you can use a custom name by using the output_file argument to the command.

If you want to customize Detached Credential Collector (DCC) scripts or pages, such as the oamsso/logout.html, oamsso-bin/login.pl, or logout.pl scripts), then you can copy these scripts from the following location to the custom location identified by the -dcc parameter to EditHttpConf utility:

ORACLE_HOME/webgate/ohs/