trusted_origins
Creates, updates, deletes, gets or lists a trusted_origins
resource.
Overview
Name | trusted_origins |
Type | Resource |
Id | okta.trustedorigins.trusted_origins |
Fields
The following fields are returned by SELECT
queries:
- list_trusted_origins
- get_trusted_origin
Name | Datatype | Description |
---|---|---|
id | string | Unique identifier for the trusted origin |
name | string | Unique name for the trusted origin |
_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. |
created | string (date-time) | Timestamp when the trusted origin was created |
createdBy | string | The ID of the user who created the trusted origin |
lastUpdated | string (date-time) | Timestamp when the trusted origin was last updated |
lastUpdatedBy | string | The ID of the user who last updated the trusted origin |
origin | string | Unique origin URL for the trusted origin. The supported schemes for this attribute are HTTP, HTTPS, FTP, Ionic 2, and Capacitor. |
scopes | array | Array of scope types that this trusted origin is used for |
status | string |
Name | Datatype | Description |
---|---|---|
id | string | Unique identifier for the trusted origin |
name | string | Unique name for the trusted origin |
_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. |
created | string (date-time) | Timestamp when the trusted origin was created |
createdBy | string | The ID of the user who created the trusted origin |
lastUpdated | string (date-time) | Timestamp when the trusted origin was last updated |
lastUpdatedBy | string | The ID of the user who last updated the trusted origin |
origin | string | Unique origin URL for the trusted origin. The supported schemes for this attribute are HTTP, HTTPS, FTP, Ionic 2, and Capacitor. |
scopes | array | Array of scope types that this trusted origin is used for |
status | string |
Methods
The following methods are available for this resource:
Name | Accessible by | Required Params | Optional Params | Description |
---|---|---|---|---|
list_trusted_origins | select | subdomain | q , filter , after , limit | Lists all trusted origins |
get_trusted_origin | select | subdomain | Retrieves a trusted origin | |
create_trusted_origin | insert | subdomain | Creates a trusted origin | |
replace_trusted_origin | replace | subdomain | Replaces a trusted origin | |
delete_trusted_origin | delete | subdomain | Deletes a trusted origin | |
activate_trusted_origin | exec | subdomain | Activates a trusted origin. Sets the status to ACTIVE . | |
deactivate_trusted_origin | exec | subdomain | Deactivates a trusted origin. Sets the status to INACTIVE . |
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) |
after | string | After cursor provided by a prior request |
filter | string | Filter trusted origins with a supported expression for a subset of properties. You can filter on the following properties: name , origin , status , and type (type of scopes). |
limit | integer (int32) | Specifies the number of results |
q | string | A search string that prefix matches against the name and origin |
SELECT
examples
- list_trusted_origins
- get_trusted_origin
Lists all trusted origins
SELECT
id,
name,
_links,
created,
createdBy,
lastUpdated,
lastUpdatedBy,
origin,
scopes,
status
FROM okta.trustedorigins.trusted_origins
WHERE subdomain = '{{ subdomain }}' -- required
AND q = '{{ q }}'
AND filter = '{{ filter }}'
AND after = '{{ after }}'
AND limit = '{{ limit }}';
Retrieves a trusted origin
SELECT
id,
name,
_links,
created,
createdBy,
lastUpdated,
lastUpdatedBy,
origin,
scopes,
status
FROM okta.trustedorigins.trusted_origins
WHERE subdomain = '{{ subdomain }}' -- required;
INSERT
examples
- create_trusted_origin
- Manifest
Creates a trusted origin
INSERT INTO okta.trustedorigins.trusted_origins (
data__name,
data__origin,
data__scopes,
subdomain
)
SELECT
'{{ name }}',
'{{ origin }}',
'{{ scopes }}',
'{{ subdomain }}'
RETURNING
id,
name,
_links,
created,
createdBy,
lastUpdated,
lastUpdatedBy,
origin,
scopes,
status
;
# Description fields are for documentation purposes
- name: trusted_origins
props:
- name: subdomain
value: string
description: Required parameter for the trusted_origins resource.
- name: name
value: string
description: >
Unique name for the trusted origin
- name: origin
value: string
description: >
Unique origin URL for the trusted origin. The supported schemes for this attribute are HTTP, HTTPS, FTP, Ionic 2, and Capacitor.
- name: scopes
value: array
description: >
Array of scope types that this trusted origin is used for
REPLACE
examples
- replace_trusted_origin
Replaces a trusted origin
REPLACE okta.trustedorigins.trusted_origins
SET
data__createdBy = '{{ createdBy }}',
data__lastUpdatedBy = '{{ lastUpdatedBy }}',
data__name = '{{ name }}',
data__origin = '{{ origin }}',
data__scopes = '{{ scopes }}',
data__status = '{{ status }}'
WHERE
subdomain = '{{ subdomain }}' --required
RETURNING
id,
name,
_links,
created,
createdBy,
lastUpdated,
lastUpdatedBy,
origin,
scopes,
status;
DELETE
examples
- delete_trusted_origin
Deletes a trusted origin
DELETE FROM okta.trustedorigins.trusted_origins
WHERE subdomain = '{{ subdomain }}' --required;
Lifecycle Methods
- activate_trusted_origin
- deactivate_trusted_origin
Activates a trusted origin. Sets the status
to ACTIVE
.
EXEC okta.trustedorigins.trusted_origins.activate_trusted_origin
@subdomain='{{ subdomain }}' --required;
Deactivates a trusted origin. Sets the status
to INACTIVE
.
EXEC okta.trustedorigins.trusted_origins.deactivate_trusted_origin
@subdomain='{{ subdomain }}' --required;