Skip to main content

references

Creates, updates, deletes, gets or lists a references resource.

Overview

Namereferences
TypeResource
Idcloudflare.zero_trust.references

Fields

The following fields are returned by SELECT queries:

Get response.

NameDatatypeDescription
idstring (uuid)The id of the integration, a UUIDv4.
reference_idstringA reference ID defined by the client. Should be set to the Access-Okta IDP integration ID. Useful when the risk-score integration needs to be associated with a secondary asset and recalled using that ID.
account_tagstringThe Cloudflare account tag.
activebooleanWhether this integration is enabled and should export changes in risk score.
created_atstring (date-time)When the integration was created in RFC3339 format.
integration_typestring (Okta)
tenant_urlstringThe base URL for the tenant. E.g. "https://tenant.okta.com".
well_known_urlstringThe URL for the Shared Signals Framework configuration, e.g. "/.well-known/sse-configuration/{integration_uuid}/". https://openid.net/specs/openid-sse-framework-1_0.html#rfc.section.6.2.1.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectaccount_id, reference_idRetrieves a Zero Trust risk score integration using its external reference ID.

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.

NameDatatypeDescription
account_idstringThe Cloudflare account ID.
reference_idstring

SELECT examples

Retrieves a Zero Trust risk score integration using its external reference ID.

SELECT
id,
reference_id,
account_tag,
active,
created_at,
integration_type,
tenant_url,
well_known_url
FROM cloudflare.zero_trust.references
WHERE account_id = '{{ account_id }}' -- required
AND reference_id = '{{ reference_id }}' -- required
;