Genero OpenID log file

The Genero OpenID implementation produces a log file that helps to identify issues.

The log file of the Genero OpenID implementation is called OpenID.log and is located in FGLDIR/web_utilities/services/openid/bin. This log file contains all incoming and outgoing requests. It can help to debug OpenID Single sign-on (SSO) issues.

You can specify the level of detail recorded to the log with the -debug category option of the OpenID server program. There are two categories that can be logged individually or together:

MSG - Standard information regarding access and errors. By default, only access and error information are logged.
DEBUG - Traces the entire SSO process.

To add debugging information to the log, modify OpenIDServiceProvider.xcf to include the -debug DEBUG option as first argument in the command defined by the MODULE element:

<APPLICATION Parent="ws.default"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:noNamespaceSchemaLocation="http://www.4js.com/ns/gas/2.50/cfextwa.xsd">
  <EXECUTION>
    <ENVIRONMENT_VARIABLE Id="FGLPROFILE">
      $(res.path.fgldir.services)/openid/res/fglprofile</ENVIRONMENT_VARIABLE>
    <PATH>$(res.path.fgldir.services)/openid/bin</PATH>
    <MODULE>OpenIDServer -debug DEBUG</MODULE>
    <POOL>
      <START>1</START>
      <MIN_AVAILABLE>0</MIN_AVAILABLE>
      <MAX_AVAILABLE>10</MAX_AVAILABLE>
    </POOL>
  </EXECUTION>
</APPLICATION>

Note: Logging is based on the Genero ERRORLOG() function. As several instances of the same OpenID server can write into the log file, the PID of the server is written to the log file as well.