Activities
Search User Logins
Search for user logins in your environment by invoking the following endpoint:
POST https://YourAccount.lacework.net/api/v2/Activities/UserLogins/search
FortiCNAPP highly recommends specifying a time range. Without a specified time range, the request uses the default time range of 24 hours prior to the current time. The maximum time range per API request is 7 days. To use the current time as the end time, exclude the endTime field.
You can optionally filter the returned login activities by start time, end time, created time, machine ID, and more. For more information, see USER_LOGIN_V View.
Here are some example body payloads:
- { "timeFilter": { "startTime": "2021-08-28T20:30:00Z", "endTime": "2021-08-28T22:30:00Z"}, "filters": [ { "field": "mid", "expression": "eq", "value": "48011" } ] }
- { "timeFilter": { "startTime": "2021-08-28T20:30:00Z", "endTime": "2021-08-28T22:30:00Z"},
"filters": [ { "field": "mid", "expression": "eq", "value": "48011" }, { "field": "username", "expression": "eq", "value": "ec2-user" } ],
"returns": [ "username", "activityType", "activityTime" ] }
post/api/v2/Activities/UserLogins/search
Headers
Authorizationstring required
Bearer Access Token. For example, "Bearer {YourAPIToken}"
Content-Typestring required
application/json
Request body
Response
No Error (List of User Logins)