Are there any options to log advanced SecureLogin debug information?

Question

Are there any options to log advanced SecureLogin debug information?

Answer

Note: You should only activate the diagnostics log file if you have specifically been instructed to by Technical Support. There is a lot of information the untrained eye cannot interpret (e.g. you may think some messages are errors when in fact they are expected conditions). The log should be sent to Technical Support for analysis.

In SecureLogin v3.5.1 and later, the ssodebug.txt log file is created under

""%USERPROFILE%\Application Data\SecureLogin\Logs""

If the %USERPROFILE% environment variable is not set (e.g. Windows 9x), the log will be written to a log directory under the installation directory. The installation directory is read from the following registry key:

""HKLM\Software\Microsoft\Windows\CurrentVersion\App Paths\SecureLogin\Path"".

To instruct SecureLogin to output advanced debug information to the log file specific registry keys must be configured. Simply enable the specific area in which you want SecureLogin to perform a debug trace on.

You must either use the slloggingmanager utility (available from support@actividentity.com) or create a Logging key and set the values manually to enable logging.

[HKEY_LOCAL_MACHINE\SOFTWARE\Protocom\SecureLogin\Logging]
""Broker""=dword:00000000 ""BrokerInt""=dword:00000000 ""Launcher""=dword:00000000 ""MadMan""=dword:00000000 ""SLCredMan""=dword:00000000 ""WinLib""=dword:00000000 ""NetscapeSSO""=dword:00000000 ""WebSSO""=dword:00000000 ""WinSSO""=dword:00000000 ""Wizard""=dword:00000000 ""LotusSSO""=dword:00000000 ""Parser""=dword:00000000 ""JavaSSO""=dword:00000000 ""JavaSSOBHO""=dword:00000000 ""AWS""=dword:00000000 ""IESSO""=dword:00000000 ""XMLConv""=dword:00000000

The values can be set from 0 to 3.

0 means log all messages and 3 logs critical issues only.

The following explains the type of information the options log, they relate closely to the files of the same - or similar - names (a separate knowledgebase article addresses the different files and their purpose);

""Broker""=dword:00000000

Logs high level information relating to SLBroker.Exe, such as communications and synchronization of SecureLogin data (such as the user’s secrets) with the Directory.

""BrokerInt""=dword:00000000

Logs low level information relating to SLBroker.Exe, including coding symbols and functions.

""Launcher""=dword:00000000

Logs information relating to SLLauncher.Exe, including published applications in a Citrix environment.

""MadMan""=dword:00000000

Logs information relating to MadMan.DLL, including binding user defaults, and setting preferences in a Microsoft Active Directory environment.

""SLCredMan""=dword:00000000

Logs information relating to whether SecureLogin is able to retrieve the user’s ADS username and password in a Microsoft ADS environment.

""WinLib""=dword:00000000

Logs information on SecureLogin’s interaction with the common windows library.

""NetscapeSSO""=dword:00000000

Logs information relating to Single Sign-on to Netscape applications.

""WebSSO""=dword:00000000

Logs information relating to WebSSO.DLL for Web Single Sign-on (WebSSO.DLL only exists in older versions of SecureLogin - IESSO.DLL replaces it).

""WinSSO""=dword:00000000

Logs information relating to Single Sign-on to Windows applications.

""Wizard""=dword:00000000

Logs information relating to the Wizard.

""LotusSSO""=dword:00000000

Logs information relating to Lotus Notes if using ProNotes.DLL (doesn’t affect Notes installation that use a script for Lotus Notes).

""Parser""=dword:00000000

Logs information relating to the script parser.

""JavaSSO""=dword:00000000

Logs information relating to Single Sign-on to Java applications.

""JavaSSOBHO""=dword:00000000

Logs information relating to the Java Single Sign-on browser helper object (for SSO to web based Java applications).

""AWS""=dword:00000000

Logs information relating to advanced windows scripting features.

""IESSO""=dword:00000000

Logs information relating to Single Sign-on to Internet Explorer web based applications.

""XMLConv""=dword:00000000

Logs information relating to the XML converter that is able to export and import Directory data.

NOTE: Remember to turn the diagnostics log file off once you have finished or the log file will continue to grow and may cause SecureLogin to run slowly at times.