The Trusted Origins API provides operations to manage Trusted Origins and sources.
When external URLs are requested during sign-in, sign-out, or recovery operations, Okta checks those URLs against the allowed list of Trusted Origins. Trusted Origins also enable browser-based applications to access Okta APIs from JavaScript (CORS). If the origins aren't specified, the related operation (redirect or Okta API access) isn't permitted.
You can also configure Trusted Origins to allow iFrame embedding of Okta resources, such as Okta sign-in pages and the Okta End-User Dashboard, within that origin. This is an Early Access feature. To enable it, contact Okta Support.
Note: This Early Access feature is supported for Okta domains only. It isn't currently supported for custom domains.
okta.trustedOrigins.read
Lists all trusted origins
Success
Forbidden
Too Many Requests
[- {
- "created": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "id": "string",
- "lastUpdated": "2019-08-24T14:15:22Z",
- "lastUpdatedBy": "string",
- "name": "string",
- "origin": "string",
- "scopes": [
- {
- "allowedOktaApps": [
- "OKTA_ENDUSER"
], - "type": "CORS"
}
], - "status": "string",
- "_links": {
- "self": {
- "hints": {
- "allow": [
- "DELETE"
]
}, - "href": "string",
- "name": "string",
- "type": "string"
}
}
}
]
okta.trustedOrigins.manage
Creates a trusted origin
Success
Bad Request
Forbidden
Too Many Requests
{- "createdBy": "string",
- "lastUpdatedBy": "string",
- "name": "string",
- "origin": "string",
- "scopes": [
- {
- "allowedOktaApps": [
- "OKTA_ENDUSER"
], - "type": "CORS"
}
], - "status": "string"
}
{- "created": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "id": "string",
- "lastUpdated": "2019-08-24T14:15:22Z",
- "lastUpdatedBy": "string",
- "name": "string",
- "origin": "string",
- "scopes": [
- {
- "allowedOktaApps": [
- "OKTA_ENDUSER"
], - "type": "CORS"
}
], - "status": "string",
- "_links": {
- "self": {
- "hints": {
- "allow": [
- "DELETE"
]
}, - "href": "string",
- "name": "string",
- "type": "string"
}
}
}
okta.trustedOrigins.read
Retrieves a trusted origin
Success
Forbidden
Not Found
Too Many Requests
{- "created": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "id": "string",
- "lastUpdated": "2019-08-24T14:15:22Z",
- "lastUpdatedBy": "string",
- "name": "string",
- "origin": "string",
- "scopes": [
- {
- "allowedOktaApps": [
- "OKTA_ENDUSER"
], - "type": "CORS"
}
], - "status": "string",
- "_links": {
- "self": {
- "hints": {
- "allow": [
- "DELETE"
]
}, - "href": "string",
- "name": "string",
- "type": "string"
}
}
}
okta.trustedOrigins.manage
Replaces a trusted origin
Success
Bad Request
Forbidden
Not Found
Too Many Requests
{- "createdBy": "string",
- "lastUpdatedBy": "string",
- "name": "string",
- "origin": "string",
- "scopes": [
- {
- "allowedOktaApps": [
- "OKTA_ENDUSER"
], - "type": "CORS"
}
], - "status": "string"
}
{- "created": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "id": "string",
- "lastUpdated": "2019-08-24T14:15:22Z",
- "lastUpdatedBy": "string",
- "name": "string",
- "origin": "string",
- "scopes": [
- {
- "allowedOktaApps": [
- "OKTA_ENDUSER"
], - "type": "CORS"
}
], - "status": "string",
- "_links": {
- "self": {
- "hints": {
- "allow": [
- "DELETE"
]
}, - "href": "string",
- "name": "string",
- "type": "string"
}
}
}
okta.trustedOrigins.manage
Deletes a trusted origin
Success
Forbidden
Not Found
Too Many Requests
{- "errorCode": "E0000006",
- "errorSummary": "You do not have permission to perform the requested action",
- "errorLink": "E0000006",
- "errorId": "sampleNUSD_8fdkFd8fs8SDBK",
- "errorCauses": [ ]
}
okta.trustedOrigins.manage
Activates a trusted origin
Success
Forbidden
Not Found
Too Many Requests
{- "created": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "id": "string",
- "lastUpdated": "2019-08-24T14:15:22Z",
- "lastUpdatedBy": "string",
- "name": "string",
- "origin": "string",
- "scopes": [
- {
- "allowedOktaApps": [
- "OKTA_ENDUSER"
], - "type": "CORS"
}
], - "status": "string",
- "_links": {
- "self": {
- "hints": {
- "allow": [
- "DELETE"
]
}, - "href": "string",
- "name": "string",
- "type": "string"
}
}
}
okta.trustedOrigins.manage
Deactivates a trusted origin
Success
Forbidden
Not Found
Too Many Requests
{- "created": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "id": "string",
- "lastUpdated": "2019-08-24T14:15:22Z",
- "lastUpdatedBy": "string",
- "name": "string",
- "origin": "string",
- "scopes": [
- {
- "allowedOktaApps": [
- "OKTA_ENDUSER"
], - "type": "CORS"
}
], - "status": "string",
- "_links": {
- "self": {
- "hints": {
- "allow": [
- "DELETE"
]
}, - "href": "string",
- "name": "string",
- "type": "string"
}
}
}