posture_integration

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

Overview

Name	posture_integration
Type	Resource
Id	cloudflare.zero_trust.posture_integration

Fields

The following fields are returned by SELECT queries:

get

Get device posture integration details response.

Name	Datatype	Description
id	string	API UUID. (example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415)
name	string	The name of the device posture integration. (example: My Workspace One Integration)
config	object	The configuration object containing third-party integration information.
interval	string	The interval between each posture check with the third-party API. Use m for minutes (e.g. 5m) and h for hours (e.g. 12h). (example: 10m)
type	string	The type of device posture integration. (workspace_one, crowdstrike_s2s, uptycs, intune, kolide, tanium_s2s, sentinelone_s2s, custom_s2s) (example: workspace_one)

list

List your device posture integrations response.

Name	Datatype	Description
id	string	API UUID. (example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415)
name	string	The name of the device posture integration. (example: My Workspace One Integration)
config	object	The configuration object containing third-party integration information.
interval	string	The interval between each posture check with the third-party API. Use m for minutes (e.g. 5m) and h for hours (e.g. 12h). (example: 10m)
type	string	The type of device posture integration. (workspace_one, crowdstrike_s2s, uptycs, intune, kolide, tanium_s2s, sentinelone_s2s, custom_s2s) (example: workspace_one)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	integration_id, account_id		Fetches details for a single device posture integration.
list	select	account_id		Fetches the list of device posture integrations for an account.
create	insert	account_id, name, type, interval, config		Create a new device posture integration.
delete	delete	integration_id, account_id		Delete a configured device posture integration.

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
account_id	string	The Cloudflare account ID.
integration_id	string

SELECT examples

get

Fetches details for a single device posture integration.

SELECT
id,
name,
config,
interval,
type
FROM cloudflare.zero_trust.posture_integration
WHERE integration_id = '{{ integration_id }}' -- required
AND account_id = '{{ account_id }}' -- required
;

list

Fetches the list of device posture integrations for an account.

SELECT
id,
name,
config,
interval,
type
FROM cloudflare.zero_trust.posture_integration
WHERE account_id = '{{ account_id }}' -- required
;

INSERT examples

create

Create a new device posture integration.

INSERT INTO cloudflare.zero_trust.posture_integration (
config,
interval,
name,
type,
account_id
)
SELECT 
'{{ config }}' /* required */,
'{{ interval }}' /* required */,
'{{ name }}' /* required */,
'{{ type }}' /* required */,
'{{ account_id }}'
RETURNING
errors,
messages,
result,
success
;

Manifest

# Description fields are for documentation purposes
- name: posture_integration
props:
  - name: account_id
    value: "{{ account_id }}"
    description: Required parameter for the posture_integration resource.
  - name: config
    description: |
      The configuration object containing third-party integration information.
    value:
      api_url: "{{ api_url }}"
      auth_url: "{{ auth_url }}"
      client_id: "{{ client_id }}"
      client_secret: "{{ client_secret }}"
      customer_id: "{{ customer_id }}"
      client_key: "{{ client_key }}"
      access_client_id: "{{ access_client_id }}"
      access_client_secret: "{{ access_client_secret }}"
  - name: interval
    value: "{{ interval }}"
    description: |
      The interval between each posture check with the third-party API. Use `m` for minutes (e.g. `5m`) and `h` for hours (e.g. `12h`).
  - name: name
    value: "{{ name }}"
    description: |
      The name of the device posture integration.
  - name: type
    value: "{{ type }}"
    description: |
      The type of device posture integration.
    valid_values: ['workspace_one', 'crowdstrike_s2s', 'uptycs', 'intune', 'kolide', 'tanium_s2s', 'sentinelone_s2s', 'custom_s2s']

DELETE examples

delete

Delete a configured device posture integration.

DELETE FROM cloudflare.zero_trust.posture_integration
WHERE integration_id = '{{ integration_id }}' --required
AND account_id = '{{ account_id }}' --required
;