UserRBASettingsApi
| Method | HTTP request | Description |
|---|---|---|
| DeleteUserLocationsUsingDELETE | DELETE /api/web/v1/users/{userid}/userlocations | Delete user location history |
| GetUserRbaSettingsUsingGET | GET /api/web/v1/users/{userid}/userrbasettings | Get user risk-based authentication settings |
| IpLocationFromIpAddressUsingPOST | POST /api/web/v1/iplocations | Create IP location |
| ListUserExpectedLocationsUsingGET | GET /api/web/v1/users/{userid}/expectedlocations | List expected locations for a user |
| ListUserLocationsUsingGET | GET /api/web/v1/users/{userid}/userlocations | Get user location history |
| SetUserExpectedLocationsUsingPUT | PUT /api/web/v1/users/{userid}/expectedlocations | Set expected locations for a user |
| UpdateUserRbaSettingsUsingPUT | PUT /api/web/v1/users/{userid}/userrbasettings | Update user risk-based authentication settings |
DeleteUserLocationsUsingDELETE
void DeleteUserLocationsUsingDELETE (string userid, List<string> requestBody)
Delete user location history
Delete one or more entries from a user's location history. Caller requires the USERRBASETTINGS:REMOVE permission.
Using the DeleteUserLocationsUsingDELETEWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | string | The UUID of the user whose location history is to be updated. | |
| requestBody | List<string> |
Return type
void (empty response body)
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
GetUserRbaSettingsUsingGET
UserRbaSettings GetUserRbaSettingsUsingGET (string userid)
Get user risk-based authentication settings
Get the user risk-based authentication settings for the specified user. Caller requires the USERRBASETTINGS:VIEW permission.
Example
Using the GetUserRbaSettingsUsingGETWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | string | The UUID of the user whose RBA settings will be retrieved. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
IpLocationFromIpAddressUsingPOST
IpLocation IpLocationFromIpAddressUsingPOST (IpLocation ipLocation)
Create IP location
Gets IP location information for an IP address. The IP location can be used to create an ExpectedLocation. Caller requires the USERRBASETTINGS:ADD permission.
Example
Using the IpLocationFromIpAddressUsingPOSTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| ipLocation | IpLocation |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
ListUserExpectedLocationsUsingGET
UserExpectedLocations ListUserExpectedLocationsUsingGET (string userid)
List expected locations for a user
Lists the expected locations for the specified user. Caller requires the USERRBASETTINGS:VIEW permission.
Example
Using the ListUserExpectedLocationsUsingGETWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | string | The UUID of the user whose expected locations will be returned. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
ListUserLocationsUsingGET
List<UserLocation> ListUserLocationsUsingGET (string userid)
Get user location history
Get the location history of the specified user. Caller requires the USERRBASETTINGS:VIEW permission.
Example
Using the ListUserLocationsUsingGETWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | string | The UUID of the user whose location history is to be retrieved. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
SetUserExpectedLocationsUsingPUT
void SetUserExpectedLocationsUsingPUT (string userid, List<ExpectedLocation> expectedLocation)
Set expected locations for a user
Sets the list of expected locations for the specified user. Caller requires the USERRBASETTINGS:EDIT permission.
Example
Using the SetUserExpectedLocationsUsingPUTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | string | The UUID of the user whose expected locations will be updated. | |
| expectedLocation | List<ExpectedLocation> |
Return type
void (empty response body)
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
UpdateUserRbaSettingsUsingPUT
void UpdateUserRbaSettingsUsingPUT (string userid, UserRbaSettings userRbaSettings)
Update user risk-based authentication settings
Update the user risk-based authentication settings for the specified user. Caller requires the USERRBASETTINGS:EDIT permission.
Example
Using the UpdateUserRbaSettingsUsingPUTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| userid | string | The UUID of the user whose RBA settings will be updated. | |
| userRbaSettings | UserRbaSettings |
Return type
void (empty response body)
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |