On This Page
ASA Audit Events API
Get started
The Advanced Server Access (ASA) API is logically separate from the rest of the Okta APIs and uses a different API namespace:
https://app.scaleft.com/v1/
Advanced Server Access (ASA) Audit Events provide log data of ASA User actions such as accessing ASA Servers, enrolling ASA Clients, and creating resources.
Explore the Audit Events API: (opens new window).
Audit Events API operation
The Audit Events API has the following operation:
List the Audits for a Team
GET https://app.scaleft.com/v1/teams/${team_name}/auditsV2
Lists the Audits for a Team
This endpoint requires one of the following roles: access_user
, access_admin
, or reporting_user
.
Request path parameters
Parameter | Type | Description |
---|---|---|
team_name | string | The name of your Team |
Request query parameters
Parameter | Type | Description |
---|---|---|
count | number | (Optional) The number of objects per page |
descending | boolean | (Optional) The object order |
offset | string | (Optional) The page offset |
prev | boolean | (Optional) The direction of paging |
Request body
This endpoint has no request body.
Response body
This endpoint returns a list of objects with the following fields and a 200
code on a successful call.
Properties | Type | Description |
---|---|---|
list | array | The list of Audit events |
related_objects | object | All objects related to the Audit events |
Usage example
Request
curl -v -X GET \
-H "Authorization: Bearer ${jwt}" \
https://app.scaleft.com/v1/teams/${team_name}/auditsV2
Response
{
"list": [
{
"details": {
"actor": "FWUysQmguH4ns9NT1Uszl5j2a1t9SK2lYNACeu03uBs=",
"client": "WvajuG7IeAjPYPdzN0zJTSmujqXLpYd90s4haNXLzRA=",
"session_type": "authenticated_client",
"target_server": "",
"team_id": "",
"team_name": "william-faulkner",
"trace_id": "YqabgEzI",
"type": "auth_token.issue",
"via": null
},
"id": "UD5pqjIhjKVQPmmqMiGMpQ==",
"timestamp": "2020-11-18T18:05:08.277119888Z"
}
],
"related_objects": {
"FWUysQmguH4ns9NT1Uszl5j2a1t9SK2lYNACeu03uBs=": {
"object": {
"deleted_at": null,
"details": {
"email": "jason.compson@example.com",
"first_name": "Jason",
"full_name": "Jason Compson IV",
"last_name": "Compson"
},
"id": "e4c22cba-f8ec-4beb-98f4-b1a03725b204",
"name": "Jason.Compson.IV",
"oauth_client_application_id": null,
"role_grants": null,
"status": "ACTIVE",
"user_type": "human"
},
"type": "user"
},
"WvajuG7IeAjPYPdzN0zJTSmujqXLpYd90s4haNXLzRA=": {
"object": {
"deleted_at": null,
"description": "Personal laptop",
"encrypted": true,
"hostname": "Absalom",
"id": "65d9e9d0-b0e5-48d9-aea6-420b9da6d1a3",
"os": "macOS 10.14.6",
"state": "ACTIVE",
"user_name": "Jason.Compson.IV"
},
"type": "client"
}
}
}