To configure session expiry, you’ll need to set two system properties:
heartbeatIntervalInMinutes:
If this isn’t set to Zero, sessions will stay alive, and users won’t see session expiry warnings.sessionTimeoutMinutes:
Sessions will expire after this number of minutes.
⚠️ Important: Don’t set both values to Zero, that’s considered a configuration error.
What Happens When a Session Is About to Expire
Two minutes before a session expires, users will see a modal dialog with the message:
'Because you have been inactive, your session is about to expire.'
The dialog shows a countdown and includes buttons to either Resume the session or Logout Immediately.
If the user doesn’t click Resume, the session expires, and they’re redirected to the login screen.
In the main window, the dialog appears over the workview (which widens if needed). Once the dialog is dismissed, the workview returns to its original state.
Behavior Across Multiple Windows
If a user has multiple Mosaic windows open, the system shows the same dialog in each window except Configuration Tools windows. Clicking a button in one dialog closes them all and triggers the corresponding action across all windows.
When the session times out, either naturally or because the user clicks Logout Immediately, all Mosaic windows close without showing additional warnings. Configuration Tools windows stay open, and some secondary windows like Lock Manager may also remain open if the main window was refreshed after they were launched.
Logging and Dialog Visibility
Session expiry countdowns and timeout events are logged at the INFO level through the RequestLoggingInterceptor. To locate them in the logs, search for expiring and expired.
Some secondary windows like Chronology Manager don’t show the expiry dialog. Previously, certain windows Step Definition Editor, Template Manager prevented logout, while others Lock Manager, Mobile Manager, Activity Logger did not. Now, all of these will prevent automatic logout. Unless the main window was refreshed after opening them, they’ll also display the session expiry dialog and close when the session ends.
Known Issue
Full-screen refreshes of the main window, like when you close a Step Definition Editor or create a new person record, can interfere with certain tool windows (Lock Manager, Mobile Manager, Activity Logger, Privileged Access Manager). If the main window has been refreshed since opening one of these, and a session countdown begins, the warning dialog may not appear, and the tool window won’t close when the session expires.