Login history
Logins to the Lobster Data Platform generate entities of the ‘Login history’ (LoginLog) type, which conserve key data on current and historical sessions.
In overviews for Users and Guest users, the sub-category ‘Logins’ appears in the main menu category 'Details' with the ‘Show’ ribbon button.
The ‘Show’ ribbon button opens a modal full-screen view of the Login history of the account selected in the call context.
View name: de.lobster.scm.base.authentication::LoginLog|listSearchWindow
Menu node name: n/a
In an overview for Users, the ribbon button is only available if the Role of session has the 'Show login history' permission ( a dministration/accounts/user/showLoginLog).
In contrast, the ribbon button is always available in an overview for Guest users .
►IMPORTANT◄ Although an ‘owner’ (
ownerId
) is formally identified for each entity of the ‘login history’ (
LoginLog
)
type
, there are effectively no owner restrictions for this entity type. Access to
LoginLog
entities (e.g. via
Search API
) is therefore basically unrestricted.
The Login history overview is only used to display existing entities for the account selected in the higher-level overview (Users or Guest users).
In addition to the applicable generic ribbon buttons for an overview, the ribbon menu offers the Back ribbon button, which closes the modal overview.
Data model of the ‘Login history’ entity
|
Localisation |
Data field |
Type |
Contents |
Example |
|
ID |
id |
Long |
Primary key of the LoginLog entity |
54321 |
|
Created |
created |
Timestamp |
Timestamp ≥ Login time |
2025-05-27T09:57:08.639+02:00 |
|
Creator |
creatorId |
Long |
(empty by definition) |
|
|
Last modified |
lastModified |
Timestamp |
Timestamp ≥ Login/Logout time |
2025-05-27T12:34:56.790+02:00 |
|
Last modifier |
lastModifierId |
Long |
(empty by definition) |
|
|
Owner |
ownerId |
Long |
Reference to the Company of session |
251 |
|
(userId)* |
userId |
Long |
Reference to the User of session |
4711 / -4711 |
|
Session Token |
sessionToken |
String |
Unique text key for the relevant session |
cfb65278/64 |
|
Login time |
loginTime |
Timestamp |
Timestamp for the start of the session |
2025-05-27T09:57:08.637+02:00 |
|
Logout time |
logoutTime |
Timestamp |
Timestamp for the end of the session |
2025-05-27T12:34:56.789+02:00 |
|
Client |
clientType |
String |
Text key for the client type (see example) |
HTML5_DESKTOP |
|
Host info |
hostInfo |
String |
123.45.67.8 |
|
|
Logout reason |
logoutReason |
String |
see table below |
user, login_from_other, ... |
|
ID logout user |
logoutUserId |
String |
User reference |
|
|
Agent name |
userAgentName |
String |
chrome, edge, safari, ... |
|
|
Agent version |
userAgentVersion |
String |
32, 16, 8, ... |
|
|
Role ID |
roleId |
Long |
Reference to the Role of session |
501 |
Values for the ‘Logout reason’
|
Logout reason |
Description |
login_from_other |
The session was terminated during a new login because the maximum number of simultaneous sessions defined for the account had been reached. |
user |
The user/guest user has regularly logged out of their session themselves. |
timeout |
The user has been inactive in the system for too long and has therefore been logged out. |
killed |
Another user (see ID logout user column) has ended the session interactively (see Aktive Benutzer). |
|
(empty) |
As long as no Logout reason is specified, the session is still active. In this case, the Logout time field is also empty. |