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 ( administration/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.

images/download/attachments/201680395/image-2025-5-27_12-1-7-version-1-modificationdate-1748340067156-api-v2.png

Data model of the ‘Login history’ entity

Localization	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	`lastModifiedId`	`Long`	(empty by definition)
Owner	`ownerId`	`Long`	Reference to the Company of session	`251`
(userId)*	`userId`	`Long`	Reference to the User of sessionfor Users >0 for Guest users <0	`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`	see Session information	`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`	see Session information	`chrome, edge, safari, ...`
Agent version	`userAgentVeriosn`	`String`	see Session information	`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 Sessions).
(empty)	As long as no Logout reason is specified, the session is still active. In this case, the Logout time field is also empty.