The authentications per application service calculates the number of successful sign-on actions for all applications in a specified environment during a specified time period. The count of successful authentications is the total number of
FLOW.UPDATED events with
COMPLETED status during the specified period.
For example, suppose you want to see the number of authentications (per application) per day for a three-day period starting on September 1, 2019. Requests to this service require the following filter parameter to define the query:
Specifies the start date for the period of interest. For this example, to specify a date range starting on September 1, 2019, the value is
occurredAt ge "2019-09-01T00:00:00Z".
Requests to this service also require the following query parameters to define the query:
Specifies the time interval in hours. For this example, to specify a daily interval, the value is
Specifies the number of sample periods. For this example, to specify three days of results, the value is
The authentications per application service supports
limit as an optional query parameter to specify a subset of applications returned in the response. For information about limiting collections, see Conventions.
These SCIM operators can be applied to the following query parameters:
ge (greater than or equal to)
||The date and time the authentication data collection ends (ISO 8601 format).|
||A boolean that specifies the partial period. This is an optional property that, when visible in the response data and set to
||An integer that represents the number of authentications for the application identified by its application ID between the start and end dates of the sample period.|
||The date and time the authentication data collection starts (ISO 8601 format).|
|400||The request could not be completed.|
|401||You do not have access to this resource.|
|403||You do not have permissions or are not licensed to make this request.|
|404||The requested resource was not found.|
|500||Internal server error.|
The following query parameter value ranges are allowed in the request:
In addition, the following product,
samplePeriod * samplePeriodCount * limit
must be less than or equal to 100,000. If one query parameter limitation is violated, the service returns an error with HTTP status code 400.