activityBasedTimeoutPolicy resource type

Article
12/18/2024

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a policy that can control the idle timeout for web sessions for applications that support activity-based timeout functionality. Applications enforce automatic sign out after a period of inactivity. This type of policy can only be applied at the organization level (by setting the isOrganizationDefault property to true).

Inherits from stsPolicy.

Methods

Method	Return Type	Description
Create	activityBasedTimeoutPolicy	Create an activityBasedTimeoutPolicy object.
Get	activityBasedTimeoutPolicy	Read properties and relationships of an activityBasedTimeoutPolicy object.
List	activityBasedTimeoutPolicy	Read properties and relationships of activityBasedTimeoutPolicy objects.
Update	None	Update an activityBasedTimeoutPolicy object.
Delete	None	Delete an activityBasedTimeoutPolicy object.

Properties

Property	Type	Description
id	String	Unique identifier for this policy. Read-only.
definition	String collection	A string collection containing a JSON string that defines the rules and settings for this policy. See below for more details about the JSON schema for this property. Required.
displayName	String	Display name for this policy. Required.
isOrganizationDefault	Boolean	If set to true, activates this policy. There can be many policies for the same policy type, but only one can be activated as the organization default. Optional, default value is false.

Properties of an activity-based timeout policy definition

The properties below form the JSON object that represents an activity-based timeout policy. This JSON object must be converted to a string with quotations escaped to be inserted into the definition property. An example is shown below in JSON format:

{
  "definition":["{\"ActivityBasedTimeoutPolicy\":{\"Version\":1,\"ApplicationPolicies\":[{\"ApplicationId\":\"default\",\"WebSessionIdleTimeout\":\"01:00:00\"},{\"ApplicationId\":\"c44b4083-3bb0-49c1-b47d-974e53cbdf3c\",\"WebSessionIdleTimeout\":\"00:15:00\"}]}}"]
}

Note: All time durations in these properties are specified in the format "dd.hh:mm:ss".

Note: Max values for properties denoted in "days" are 1 second short of the denoted number of days. For example, the max value of 1 days is specified as "23:59:59".

Property	Type	Description
Version	Integer	Policy version. Set value of 1. Required.
ApplicationPolicies	JSON object	Collection of application policy. An application policy, is a combination of an ApplicationId and a WebSessionIdleTimeout: ApplicationId: Allowed values: default: applies the policy to all applications that support activity-based timeout functionality but don't have application-specific override c44b4083-3bb0-49c1-b47d-974e53cbdf3c: applies the policy to the Azure portal WebSessionIdleTimeout: The period of user inactivity after which the user's web session is considered expired. The minimum value is 5 minutes; the maximum value is one day.

Relationships

None

JSON representation

The following JSON representation shows the resource type.

{
  "definition": ["String"],
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "isOrganizationDefault": true
}

Share via