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:
  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:


    (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:


    (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/, or scripts), then you can copy these scripts from the following location to the custom location identified by the -dcc parameter to EditHttpConf utility: