current_configuration
Creates, updates, deletes, gets or lists a current_configuration
resource.
Overview
Name | current_configuration |
Type | Resource |
Id | okta.threats.current_configuration |
Fields
The following fields are returned by SELECT
queries:
- get_current_configuration
Name | Datatype | Description |
---|---|---|
_links | object | Specifies link relations (see Web Linking) available using the JSON Hypertext Application Language specification. This object is used for dynamic discovery of related resources and lifecycle operations. |
action | string | Specifies how Okta responds to authentication requests from suspicious IP addresses (example: none) |
created | string (date-time) | Timestamp when the ThreatInsight Configuration object was created (example: 2020-08-05T22:18:30.629Z) |
excludeZones | array | Accepts a list of Network Zone IDs. IPs in the excluded network zones aren't logged or blocked. This ensures that traffic from known, trusted IPs isn't accidentally logged or blocked. |
lastUpdated | string (date-time) | Timestamp when the ThreatInsight Configuration object was last updated (example: 2020-09-08T20:53:20.882Z) |
Methods
The following methods are available for this resource:
Name | Accessible by | Required Params | Optional Params | Description |
---|---|---|---|---|
get_current_configuration | select | subdomain | Retrieves the ThreatInsight configuration for the org | |
update_configuration | update | subdomain , data__action | Updates the ThreatInsight configuration for the org |
Parameters
Parameters can be passed in the WHERE
clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
Name | Datatype | Description |
---|---|---|
subdomain | string | The domain of your organization. This can be a provided subdomain of an official okta domain (okta.com, oktapreview.com, etc) or one of your configured custom domains. (default: my-org) |
SELECT
examples
- get_current_configuration
Retrieves the ThreatInsight configuration for the org
SELECT
_links,
action,
created,
excludeZones,
lastUpdated
FROM okta.threats.current_configuration
WHERE subdomain = '{{ subdomain }}' -- required;
UPDATE
examples
- update_configuration
Updates the ThreatInsight configuration for the org
UPDATE okta.threats.current_configuration
SET
data__action = '{{ action }}',
data__excludeZones = '{{ excludeZones }}'
WHERE
subdomain = '{{ subdomain }}' --required
AND data__action = '{{ action }}' --required
RETURNING
_links,
action,
created,
excludeZones,
lastUpdated;