Enable SSOMGR Debug Traces
- Last Updated: December 10, 2024
- 2 minute read
- LoadMaster
- LoadMaster LTSF
- Documentation
Enabling this option will record any login attempts to the SSO domains configured on the LoadMaster. When this option is enabled, the SSOMGR traces are printed in the main syslog file.
The syslogs are rotated on a per size/day manner. They are rotated every day at midnight or when the size reaches 10MB. Rotated files older than seven days are automatically removed.
You can save and clear these logs in the LoadMaster WUI by going to System Configuration > Logging Options > System Log Files.
To view, clear, and save the ESP user logs, go to System Configuration > Logging Options > Extended Log Files in the LoadMaster User Interface (UI).
Here is an example of these logs:
2020-06-23T17:18:09+01:00 AK-TEST-VLM ssomgr: vs=65 user=exampleuser domain=kpauto.net server=172.20.7.170 protocol=LDAP Unencrypted result=0:Success
...
2020-06-23T17:15:49+01:00 AK-TEST-VLM ssomgr: vs=58 user=kpauto\exampleuser domain=kpauto.net server=172.20.7.170 protocol=RADIUS result=1:Timeout
You can generate these logs in Common Event Format (CEF) by enabling the Use CEF Log Format check box in System Configuration > Miscellaneous Options > L7 Configuration. Here is an example of these CEF logs:
2020-06-23T16:58:57+01:00 AK-TEST-VLM ssomgr: CEF:0|Kemp|LM|1.0|20|User AAA|0|vs=65 user=exampleuser domain=kpauto.net server=172.20.7.170 protocol=LDAP Unencrypted result=0:Success
...
2020-06-23T17:07:02+01:00 AK-TEST-VLM ssomgr: CEF:0|Kemp|LM|1.0|20|User AAA|0|vs=58 user=kpauto\ domain=kpauto.net server=172.20.7.170 protocol=RADIUS and LDAP Unencrypted result=1:Timeout
In LoadMaster firmware version 7.2.53, the ESP client session logging was further enhanced. The LoadMaster logs:
-
The initially created ESP session
CEF:0|Kemp|LM|1.0|8|Logged on|1|vs=10.35.46.157:443 event=Logged on srcip=10.35.2.45 user=mgupta@kempqaesp.net msg=logged on
-
The time when the LoadMaster cleared the session from the cache. Note that if the entire cache is cleared, a single log message is recorded at the time of clearing, which notes that all existing sessions at that time were cleared form the cache.
CEF:0|Kemp|LM|1.0|104|Flush SSO cache|1|event=Flush SSO cache msg=SSO cache being flushed user sessions:1 cookie sessions:0
-
If an ESP session is deleted (when the user logs out from the application, when the session expires, or the user enters invalid credentials). The time of when the LoadMaster cleared the session is also logged.
CEF:0|Kemp|LM|1.0|101|User session timeout|0|vs=10.35.46.242:443 event=User session timeout user=mohit@parent.net domain=MULLTIDOMAIN msg=Deleted expired user session, start time:1629182393 duration:69 seconds
CEF:0|Kemp|LM|1.0|102|User session kill|0|vs=10.35.46.235:443 event=User session kill user=mohit@parent.net domain=MULLTIDOMAIN msg=Deleted user session, start time:1629378587 duration:8 seconds
CEF:0|Kemp|LM|1.0|103|Kill all sessions|0|event=Kill all sessions domain=MULLTIDOMAIN msg=Deleted 1 user session(s) associated with domain
All logs related to ESP that are produced by the LoadMaster application running over Layer7 (including the connection, security, and user logs) support CEF. All other logs produced by enabling the Enable SSOMGR Debug Traces option, which are printed in /var/log/messages are not in the CEF format.