Admin settings - Sessions

By default, when a user logs in to Looker, they are given an option to stay logged in. This option appears as a checkbox at the bottom of the login page.

The Sessions page, in the Authentication section of the Admin menu, lets you configure whether users have the option to stay logged in, how long they stay logged in if they don't choose that option, and whether they can stay logged in from multiple devices.

Inactivity Logout

By default, a user stays logged in to Looker for a set length of time that is determined by the Persistent Sessions and Session Duration settings, regardless of whether the user is actively using Looker.

If you enable Inactivity Logout, users are automatically logged out of Looker after 15 minutes of inactivity. Activity is defined as a user clicking anywhere in Looker, or touching the screen in the case of touchscreens, or typing anything into Looker. Therefore, if this setting is enabled, a user is logged out if they do not click or type anything for 15 minutes.

Two minutes before the user is logged out, Looker displays a dialog box to warn the user and give them the opportunity to stay logged in.

When a user is forcibly logged out due to inactivity, they are logged out of their inactive session. A session is unique to each browser, so if a user has multiple tabs open and logged in to Looker, they are logged out on all tabs. But, if they are logged in through multiple browsers, they are logged out only of the session on the inactive browser.

Any unsaved changes in the Looker IDE are stored. When the user logs back in and loads a file that has any unsaved changes in it, they are given the option to restore the unsaved changes.

When Inactivity Logout is enabled, Persistent Sessions is automatically disabled. In addition, Session Duration is set to a default of one day. The Session Duration setting can still be changed. The value set in Session Duration remains the maximum length of time a user can stay logged in, even if they are active the entire time.

For example, if Inactivity Logout is enabled and Session Duration is set to 5 hours, a user will be logged out if there is a 15-minute period of inactivity at any time during the five hours, or will be logged out after 5 hours if they have not already been logged out due to a period of inactivity. In addition, with the settings as above, a user who has been active for 4 hours and 50 minutes will still be logged out after 5 hours, even though the period of inactivity was only 10 minutes, since Session Duration remains the maximum time a user can stay logged in. If you remain active during that entire five-hour session, a pop-up screen will ask you to re-authenticate to continue working.

Users who access Looker using either the Looker API or a signed embed are not affected by Inactivity Logout.

Persistent Sessions

When a user selects the option to stay logged in, they will be authorized to access Looker for 30 days. When they close and reopen their browser, they can navigate to Looker without being required to log in again.

Disabling Persistent Sessions removes the "Stay logged in" option from the login screen. Users will be automatically logged out after the amount of time specified in the Session Duration section, or whenever they close their browser. This forces users to re-authenticate the next time they access Looker.

Persistent Sessions is automatically disabled when Inactivity Logout is enabled.

Session Duration

By default, when a user does not select the option to stay logged in, their session will expire after 30 minutes. Two minutes before a session expires, the user is given the option to extend the session. If they do not extend their session, their session ends and they are logged out of Looker.

The Session Duration field lets you change the amount of time a user can stay logged in before they will be notified and their session will expire. You can set this value from 5 minutes to 30 days.

If Inactivity Logout is enabled, Session Duration must be set to a value between 15 minutes and 1 day. If Session Duration is set to a value outside of this range, the value will be set to 1 day.

Concurrent Sessions

By default, users can remain logged in to Looker from multiple browsers and devices simultaneously. Disabling Concurrent Sessions lets you require users to log in from only one browser and device at a time. When Concurrent Sessions is disabled, a user is automatically logged out of any other browser session when they log in from a different browser or device.

Session Location

If Session Location is enabled, a user's location will be tracked when they log in to Looker. This location information is based on the user's browser IP address and is available to users and admins on the Sessions page for visibility and management of sessions. The location information can help admins determine which sessions are current and which sessions should be deleted.

If Session Location is disabled, whenever a user logs in to Looker, their location will not be tracked.