Configuration files Settings to Control the UIO Proxy

6-8 Oracle Fusion Middleware Developers Guide for Oracle Adaptive Access Manager

6.2.3.6 Settings for Troubleshooting

Trace messages from the UIO ISA Proxy can be used for troubleshooting any issues with the proxy configuration and operation. Trace settings, like trace level and destinations, can be controlled using the registry values under HKLM\SOFTWARE\Bharosa\Proxy. Registry values are shown in Table 6–2 .

6.3 Installing UIO Apache Proxy

To install the UIO Apache Proxy, a new Apache Hypertext Transfer Protocol Daemon httpd has to be installed into which the UIO Apache Proxy is installed. This Apache httpd uses the mod_proxy, a module that implements the proxygatewaycache, to reverse-proxy proxy on behalf of the backend application that has to be protected. The Installation section contains information for installing the UIO Apache Proxy for Windows and Linux platforms. The installation procedure involves: ■ Ensuring that the Apache httpd requirements are met See Section 6.3.2, Apache httpd Requirements. ■ Copying the UIO Proxy dlls and supported dlls to specific directories in Apache Table 6–2 Settings for Troubleshooting Name Type Description TraceFilename REG_SZ Full path to the file in which the trace messages should be written to TraceFileMaxLength REG_DWORD Maximum length of the trace file in bytes. Once the trace file reaches this size, the proxy renames the file by adding the timestamp to the filename and create a new trace file to write subsequent trace messages. TraceToFile REG_DWORD Trace messages are written to file only if this value is nonzero. TraceToDebugTerminal REG_DWORD Trace messages are written to debug the terminal only if this value is nonzero. Tools like DbgView can be used to view these trace messages in real time. TraceLevel REG_DWORD Each trace level debug, info, warning, error has an integer value associated. The registry value should be set to the sum of desired the trace level values. FATAL 0x1, ERROR 0x2, WARN 0x4 INFO 0x8, DEBUG 0x10, HTML 0x80, FLOW 0x80000 IgnoreUrlMappings REG_DWORD If this value is nonzero, the proxy ignores all the interceptors defined in the UIO Proxy configuration. Essentially this places the UIO ISA Proxy in pass-through mode. CaptureTraffic REG_DWORD The proxy does not handle save, inspect the HTTP traffic for URLs that dont have interceptors defined in the configuration. But during application discovery process, it is necessary back up of all the HTTP traffic through the proxy. On such occasion, this registry value should be set to nonzero. Oracle Adaptive Access Manager Proxy 6-9 See Section 6.3.3, Copying the UIO Apache Proxy and Supported Files to Apache. ■ Configuring memcache for Linux only See Section 6.3.4, Configuring Memcache for Linux only. ■ Editing the httpd.conf to activate the UIO Proxy See Section 6.3.5, Configuring httpd.conf. As part of this section, information is also provide on optionally installing the mod_proxy_html, which is needed to rewrite the HTML links in a proxy situation, to ensure that links work for the users outside the proxy ■ Modifying the settings of the UIO Proxy using application configuration XML files Section 6.3.6, Modifying the UIO Apache Proxy Settings. The post-installation procedures involve: ■ Section 6.4, Setting Up Rules and User Groups. Creating a new user to run the UIO Apache Proxy process on Linux only ■ Section 6.5, Setting Up Policies.

6.3.1 UIO Proxy Files for Windows and Linux

The UIO Apache Proxy binaries for Windows and Linux are different. Since the UIO Proxy is in CC++, the same binary do not work on different platforms unlike Java. The files are located under ORACLE_HOMEoaamoaam_proxyplatform_specific_ file.

6.3.1.1 Windows

For Windows, the binary files are listed in Table 6–3 . The data files are listed in Table 6–4 . Table 6–3 Windows Binary Files Name Description mod_uio.so UIO Apache Proxy module log4cxx.dll Apache Log4cxx library libxml2.dll XMLHTML Parser apr_memcache.dll APR Memcache client library. Table 6–4 Windows Data files Name Description UIO_Settings.xml UIO Apache Proxy Settings XML file UIO_log4j.xml UIO Apache Proxy Log4j log4cxx configuration XML file TestConfig.xml UIO Apache Proxy Sample application configuration file UIO_Settings.rng Relax NG grammar for UIO_Settings.xml UIO_Config.rng Relax NG grammar for application configuration XML files