Extend embedded web sessions
Extend embedded web sessions to keep mobile users logged in until the mobile OAuth token expires.
Before you begin
Role required: admin
About this task
The extend_web_session mobile property is enabled by default. This property helps make hybrid experiences on ServiceNow® mobile apps seamless. The extend_web_session property extends an embedded web session so it’s valid for the same amount of time that native mobile apps are valid. Web session timeout is 30 minutes by default. Mobile sessions remain valid for 100 days. To keep mobile users logged in until the mobile OAuth token expires, use the extend_web_session mobile property to extend the web session timeout. You can turn off this feature by setting the Value field for this property to False.
Procedure
Navigate to All > sys_sg_properties.list.
The Mobile Properties list appears.
In the Mobile Properties list, select New.
The Mobile Properties form appears.
On the form, fill in the fields.
| Field | Description |
|---|---|
| Name | Name for the mobile property record. Enter Mobile web sessions have a default timeout value. The extend_web_session mobile property overrides the default timeout value. End users remain logged in to the embedded web session for as long as the mobile OAuth token is valid. Note: The record name is case-sensitive and must be entered as |
| Application | Application scope where the mobile property is applied. To select a different application scope, select the globe icon ( Image omitted: globe-icon.png Globe) on the instance banner. Then select <strong>Application scope: <em>application_scope</em></strong>.</p> For information about how mobile properties are affected by application scope, see Mobile properties. |
| Description | Description of the mobile property. Enter a description of the property. |
| Type | Data type of the mobile property record. You must select True/False for the extend_web_session mobile property. |
| Value | Enter one of the following options: - To enable extending web sessions to match mobile apps, enter `True`. - To keep the 30-minute web session length, enter `False`. |
| Active | Indicates if the mobile property is activated. If the check box is cleared, the mobile property isn't activated for use. |
| Is Public | Determines whether the pre_auth property is included in the API response. By default, this option is not selected. If you want this property included in the /pre_auth API response, select this checkbox. For more information, see Adaptive authentication events. Mobile properties with this checkbox enabled are excluded from the /user_client API response. |
| Mobile App Config | Mobile app configuration for which you want to use the mobile property. This setting limits the mobile property behavior to users who have access to this mobile app configuration. Other users don't have access to this mobile property and instead experience default behavior. Note: For the extend_web_session mobile property, which is turned on by default, you can only turn off the extended web session time for users with the mobile app configuration that you specify for this field. If you don’t specify a Mobile App Config, all end-user web sessions are extended in Washington DC family release versions and later. To enter a value, either start typing the configuration name or select the search icon ( Image omitted: search-icon.png Magnifying glass). The search dialog box lists the configurations from which you can choose.</p> Select one of the following mobile app configs:
|
| Mobile Application | Mobile application to which you want to send the mobile property. This setting limits the mobile property behavior to users who have access to this mobile app. Other users don't have access to this mobile property and instead experience default behavior. Note: For the extend_web_session mobile property, which is turned on by default, you can only turn off the extended web session time for users with the mobile application that you specify for this field. If you don’t specify a Mobile Application, all end-user web sessions are extended in Washington DC family release versions and later. To enter a value, either start typing the application name or select the search icon ( Image omitted: search-icon.png Magnifying glass). The search dialog box lists the applications from which you can choose.</p> Select one of the following mobile applications:
|
- Select Submit.
What to do next
After updating this property, the end user must pull to refresh and get the latest feature configurations.
Parent Topic:Mobile properties