1. Packages
  2. Cloudflare
  3. API Docs
  4. DevicePostureIntegration
Cloudflare v5.26.0 published on Wednesday, Apr 17, 2024 by Pulumi

cloudflare.DevicePostureIntegration

Explore with Pulumi AI

cloudflare logo
Cloudflare v5.26.0 published on Wednesday, Apr 17, 2024 by Pulumi

    Provides a Cloudflare Device Posture Integration resource. Device posture integrations configure third-party data providers for device posture rules.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as cloudflare from "@pulumi/cloudflare";
    
    const example = new cloudflare.DevicePostureIntegration("example", {
        accountId: "f037e56e89293a057740de681ac9abbe",
        configs: [{
            apiUrl: "https://example.com/api",
            authUrl: "https://example.com/connect/token",
            clientId: "client-id",
            clientSecret: "client-secret",
        }],
        interval: "24h",
        name: "Device posture integration",
        type: "workspace_one",
    });
    
    import pulumi
    import pulumi_cloudflare as cloudflare
    
    example = cloudflare.DevicePostureIntegration("example",
        account_id="f037e56e89293a057740de681ac9abbe",
        configs=[cloudflare.DevicePostureIntegrationConfigArgs(
            api_url="https://example.com/api",
            auth_url="https://example.com/connect/token",
            client_id="client-id",
            client_secret="client-secret",
        )],
        interval="24h",
        name="Device posture integration",
        type="workspace_one")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-cloudflare/sdk/v5/go/cloudflare"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := cloudflare.NewDevicePostureIntegration(ctx, "example", &cloudflare.DevicePostureIntegrationArgs{
    			AccountId: pulumi.String("f037e56e89293a057740de681ac9abbe"),
    			Configs: cloudflare.DevicePostureIntegrationConfigArray{
    				&cloudflare.DevicePostureIntegrationConfigArgs{
    					ApiUrl:       pulumi.String("https://example.com/api"),
    					AuthUrl:      pulumi.String("https://example.com/connect/token"),
    					ClientId:     pulumi.String("client-id"),
    					ClientSecret: pulumi.String("client-secret"),
    				},
    			},
    			Interval: pulumi.String("24h"),
    			Name:     pulumi.String("Device posture integration"),
    			Type:     pulumi.String("workspace_one"),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Cloudflare = Pulumi.Cloudflare;
    
    return await Deployment.RunAsync(() => 
    {
        var example = new Cloudflare.DevicePostureIntegration("example", new()
        {
            AccountId = "f037e56e89293a057740de681ac9abbe",
            Configs = new[]
            {
                new Cloudflare.Inputs.DevicePostureIntegrationConfigArgs
                {
                    ApiUrl = "https://example.com/api",
                    AuthUrl = "https://example.com/connect/token",
                    ClientId = "client-id",
                    ClientSecret = "client-secret",
                },
            },
            Interval = "24h",
            Name = "Device posture integration",
            Type = "workspace_one",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.cloudflare.DevicePostureIntegration;
    import com.pulumi.cloudflare.DevicePostureIntegrationArgs;
    import com.pulumi.cloudflare.inputs.DevicePostureIntegrationConfigArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var example = new DevicePostureIntegration("example", DevicePostureIntegrationArgs.builder()        
                .accountId("f037e56e89293a057740de681ac9abbe")
                .configs(DevicePostureIntegrationConfigArgs.builder()
                    .apiUrl("https://example.com/api")
                    .authUrl("https://example.com/connect/token")
                    .clientId("client-id")
                    .clientSecret("client-secret")
                    .build())
                .interval("24h")
                .name("Device posture integration")
                .type("workspace_one")
                .build());
    
        }
    }
    
    resources:
      example:
        type: cloudflare:DevicePostureIntegration
        properties:
          accountId: f037e56e89293a057740de681ac9abbe
          configs:
            - apiUrl: https://example.com/api
              authUrl: https://example.com/connect/token
              clientId: client-id
              clientSecret: client-secret
          interval: 24h
          name: Device posture integration
          type: workspace_one
    

    Create DevicePostureIntegration Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new DevicePostureIntegration(name: string, args: DevicePostureIntegrationArgs, opts?: CustomResourceOptions);
    @overload
    def DevicePostureIntegration(resource_name: str,
                                 args: DevicePostureIntegrationArgs,
                                 opts: Optional[ResourceOptions] = None)
    
    @overload
    def DevicePostureIntegration(resource_name: str,
                                 opts: Optional[ResourceOptions] = None,
                                 account_id: Optional[str] = None,
                                 name: Optional[str] = None,
                                 type: Optional[str] = None,
                                 configs: Optional[Sequence[DevicePostureIntegrationConfigArgs]] = None,
                                 identifier: Optional[str] = None,
                                 interval: Optional[str] = None)
    func NewDevicePostureIntegration(ctx *Context, name string, args DevicePostureIntegrationArgs, opts ...ResourceOption) (*DevicePostureIntegration, error)
    public DevicePostureIntegration(string name, DevicePostureIntegrationArgs args, CustomResourceOptions? opts = null)
    public DevicePostureIntegration(String name, DevicePostureIntegrationArgs args)
    public DevicePostureIntegration(String name, DevicePostureIntegrationArgs args, CustomResourceOptions options)
    
    type: cloudflare:DevicePostureIntegration
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args DevicePostureIntegrationArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args DevicePostureIntegrationArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args DevicePostureIntegrationArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DevicePostureIntegrationArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DevicePostureIntegrationArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Example

    The following reference example uses placeholder values for all input properties.

    var devicePostureIntegrationResource = new Cloudflare.DevicePostureIntegration("devicePostureIntegrationResource", new()
    {
        AccountId = "string",
        Name = "string",
        Type = "string",
        Configs = new[]
        {
            new Cloudflare.Inputs.DevicePostureIntegrationConfigArgs
            {
                AccessClientId = "string",
                AccessClientSecret = "string",
                ApiUrl = "string",
                AuthUrl = "string",
                ClientId = "string",
                ClientKey = "string",
                ClientSecret = "string",
                CustomerId = "string",
            },
        },
        Identifier = "string",
        Interval = "string",
    });
    
    example, err := cloudflare.NewDevicePostureIntegration(ctx, "devicePostureIntegrationResource", &cloudflare.DevicePostureIntegrationArgs{
    	AccountId: pulumi.String("string"),
    	Name:      pulumi.String("string"),
    	Type:      pulumi.String("string"),
    	Configs: cloudflare.DevicePostureIntegrationConfigArray{
    		&cloudflare.DevicePostureIntegrationConfigArgs{
    			AccessClientId:     pulumi.String("string"),
    			AccessClientSecret: pulumi.String("string"),
    			ApiUrl:             pulumi.String("string"),
    			AuthUrl:            pulumi.String("string"),
    			ClientId:           pulumi.String("string"),
    			ClientKey:          pulumi.String("string"),
    			ClientSecret:       pulumi.String("string"),
    			CustomerId:         pulumi.String("string"),
    		},
    	},
    	Identifier: pulumi.String("string"),
    	Interval:   pulumi.String("string"),
    })
    
    var devicePostureIntegrationResource = new DevicePostureIntegration("devicePostureIntegrationResource", DevicePostureIntegrationArgs.builder()        
        .accountId("string")
        .name("string")
        .type("string")
        .configs(DevicePostureIntegrationConfigArgs.builder()
            .accessClientId("string")
            .accessClientSecret("string")
            .apiUrl("string")
            .authUrl("string")
            .clientId("string")
            .clientKey("string")
            .clientSecret("string")
            .customerId("string")
            .build())
        .identifier("string")
        .interval("string")
        .build());
    
    device_posture_integration_resource = cloudflare.DevicePostureIntegration("devicePostureIntegrationResource",
        account_id="string",
        name="string",
        type="string",
        configs=[cloudflare.DevicePostureIntegrationConfigArgs(
            access_client_id="string",
            access_client_secret="string",
            api_url="string",
            auth_url="string",
            client_id="string",
            client_key="string",
            client_secret="string",
            customer_id="string",
        )],
        identifier="string",
        interval="string")
    
    const devicePostureIntegrationResource = new cloudflare.DevicePostureIntegration("devicePostureIntegrationResource", {
        accountId: "string",
        name: "string",
        type: "string",
        configs: [{
            accessClientId: "string",
            accessClientSecret: "string",
            apiUrl: "string",
            authUrl: "string",
            clientId: "string",
            clientKey: "string",
            clientSecret: "string",
            customerId: "string",
        }],
        identifier: "string",
        interval: "string",
    });
    
    type: cloudflare:DevicePostureIntegration
    properties:
        accountId: string
        configs:
            - accessClientId: string
              accessClientSecret: string
              apiUrl: string
              authUrl: string
              clientId: string
              clientKey: string
              clientSecret: string
              customerId: string
        identifier: string
        interval: string
        name: string
        type: string
    

    DevicePostureIntegration Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The DevicePostureIntegration resource accepts the following input properties:

    AccountId string
    The account identifier to target for the resource.
    Name string
    Name of the device posture integration.
    Type string
    The device posture integration type. Available values: workspace_one, uptycs, crowdstrike_s2s, intune, kolide, sentinelone_s2s, tanium_s2s.
    Configs List<DevicePostureIntegrationConfig>
    The device posture integration's connection authorization parameters.
    Identifier string
    Interval string
    Indicates the frequency with which to poll the third-party API. Must be in the format 1h or 30m.
    AccountId string
    The account identifier to target for the resource.
    Name string
    Name of the device posture integration.
    Type string
    The device posture integration type. Available values: workspace_one, uptycs, crowdstrike_s2s, intune, kolide, sentinelone_s2s, tanium_s2s.
    Configs []DevicePostureIntegrationConfigArgs
    The device posture integration's connection authorization parameters.
    Identifier string
    Interval string
    Indicates the frequency with which to poll the third-party API. Must be in the format 1h or 30m.
    accountId String
    The account identifier to target for the resource.
    name String
    Name of the device posture integration.
    type String
    The device posture integration type. Available values: workspace_one, uptycs, crowdstrike_s2s, intune, kolide, sentinelone_s2s, tanium_s2s.
    configs List<DevicePostureIntegrationConfig>
    The device posture integration's connection authorization parameters.
    identifier String
    interval String
    Indicates the frequency with which to poll the third-party API. Must be in the format 1h or 30m.
    accountId string
    The account identifier to target for the resource.
    name string
    Name of the device posture integration.
    type string
    The device posture integration type. Available values: workspace_one, uptycs, crowdstrike_s2s, intune, kolide, sentinelone_s2s, tanium_s2s.
    configs DevicePostureIntegrationConfig[]
    The device posture integration's connection authorization parameters.
    identifier string
    interval string
    Indicates the frequency with which to poll the third-party API. Must be in the format 1h or 30m.
    account_id str
    The account identifier to target for the resource.
    name str
    Name of the device posture integration.
    type str
    The device posture integration type. Available values: workspace_one, uptycs, crowdstrike_s2s, intune, kolide, sentinelone_s2s, tanium_s2s.
    configs Sequence[DevicePostureIntegrationConfigArgs]
    The device posture integration's connection authorization parameters.
    identifier str
    interval str
    Indicates the frequency with which to poll the third-party API. Must be in the format 1h or 30m.
    accountId String
    The account identifier to target for the resource.
    name String
    Name of the device posture integration.
    type String
    The device posture integration type. Available values: workspace_one, uptycs, crowdstrike_s2s, intune, kolide, sentinelone_s2s, tanium_s2s.
    configs List<Property Map>
    The device posture integration's connection authorization parameters.
    identifier String
    interval String
    Indicates the frequency with which to poll the third-party API. Must be in the format 1h or 30m.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the DevicePostureIntegration resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing DevicePostureIntegration Resource

    Get an existing DevicePostureIntegration resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: DevicePostureIntegrationState, opts?: CustomResourceOptions): DevicePostureIntegration
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            account_id: Optional[str] = None,
            configs: Optional[Sequence[DevicePostureIntegrationConfigArgs]] = None,
            identifier: Optional[str] = None,
            interval: Optional[str] = None,
            name: Optional[str] = None,
            type: Optional[str] = None) -> DevicePostureIntegration
    func GetDevicePostureIntegration(ctx *Context, name string, id IDInput, state *DevicePostureIntegrationState, opts ...ResourceOption) (*DevicePostureIntegration, error)
    public static DevicePostureIntegration Get(string name, Input<string> id, DevicePostureIntegrationState? state, CustomResourceOptions? opts = null)
    public static DevicePostureIntegration get(String name, Output<String> id, DevicePostureIntegrationState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AccountId string
    The account identifier to target for the resource.
    Configs List<DevicePostureIntegrationConfig>
    The device posture integration's connection authorization parameters.
    Identifier string
    Interval string
    Indicates the frequency with which to poll the third-party API. Must be in the format 1h or 30m.
    Name string
    Name of the device posture integration.
    Type string
    The device posture integration type. Available values: workspace_one, uptycs, crowdstrike_s2s, intune, kolide, sentinelone_s2s, tanium_s2s.
    AccountId string
    The account identifier to target for the resource.
    Configs []DevicePostureIntegrationConfigArgs
    The device posture integration's connection authorization parameters.
    Identifier string
    Interval string
    Indicates the frequency with which to poll the third-party API. Must be in the format 1h or 30m.
    Name string
    Name of the device posture integration.
    Type string
    The device posture integration type. Available values: workspace_one, uptycs, crowdstrike_s2s, intune, kolide, sentinelone_s2s, tanium_s2s.
    accountId String
    The account identifier to target for the resource.
    configs List<DevicePostureIntegrationConfig>
    The device posture integration's connection authorization parameters.
    identifier String
    interval String
    Indicates the frequency with which to poll the third-party API. Must be in the format 1h or 30m.
    name String
    Name of the device posture integration.
    type String
    The device posture integration type. Available values: workspace_one, uptycs, crowdstrike_s2s, intune, kolide, sentinelone_s2s, tanium_s2s.
    accountId string
    The account identifier to target for the resource.
    configs DevicePostureIntegrationConfig[]
    The device posture integration's connection authorization parameters.
    identifier string
    interval string
    Indicates the frequency with which to poll the third-party API. Must be in the format 1h or 30m.
    name string
    Name of the device posture integration.
    type string
    The device posture integration type. Available values: workspace_one, uptycs, crowdstrike_s2s, intune, kolide, sentinelone_s2s, tanium_s2s.
    account_id str
    The account identifier to target for the resource.
    configs Sequence[DevicePostureIntegrationConfigArgs]
    The device posture integration's connection authorization parameters.
    identifier str
    interval str
    Indicates the frequency with which to poll the third-party API. Must be in the format 1h or 30m.
    name str
    Name of the device posture integration.
    type str
    The device posture integration type. Available values: workspace_one, uptycs, crowdstrike_s2s, intune, kolide, sentinelone_s2s, tanium_s2s.
    accountId String
    The account identifier to target for the resource.
    configs List<Property Map>
    The device posture integration's connection authorization parameters.
    identifier String
    interval String
    Indicates the frequency with which to poll the third-party API. Must be in the format 1h or 30m.
    name String
    Name of the device posture integration.
    type String
    The device posture integration type. Available values: workspace_one, uptycs, crowdstrike_s2s, intune, kolide, sentinelone_s2s, tanium_s2s.

    Supporting Types

    DevicePostureIntegrationConfig, DevicePostureIntegrationConfigArgs

    AccessClientId string
    The Access client ID to be used as the Cf-Access-Client-ID header when making a request to the api_url.
    AccessClientSecret string
    The Access client secret to be used as the Cf-Access-Client-Secret header when making a request to the api_url.
    ApiUrl string
    The third-party API's URL.
    AuthUrl string
    The third-party authorization API URL.
    ClientId string
    The client identifier for authenticating API calls.
    ClientKey string
    The client key for authenticating API calls.
    ClientSecret string
    The client secret for authenticating API calls.
    CustomerId string
    The customer identifier for authenticating API calls.
    AccessClientId string
    The Access client ID to be used as the Cf-Access-Client-ID header when making a request to the api_url.
    AccessClientSecret string
    The Access client secret to be used as the Cf-Access-Client-Secret header when making a request to the api_url.
    ApiUrl string
    The third-party API's URL.
    AuthUrl string
    The third-party authorization API URL.
    ClientId string
    The client identifier for authenticating API calls.
    ClientKey string
    The client key for authenticating API calls.
    ClientSecret string
    The client secret for authenticating API calls.
    CustomerId string
    The customer identifier for authenticating API calls.
    accessClientId String
    The Access client ID to be used as the Cf-Access-Client-ID header when making a request to the api_url.
    accessClientSecret String
    The Access client secret to be used as the Cf-Access-Client-Secret header when making a request to the api_url.
    apiUrl String
    The third-party API's URL.
    authUrl String
    The third-party authorization API URL.
    clientId String
    The client identifier for authenticating API calls.
    clientKey String
    The client key for authenticating API calls.
    clientSecret String
    The client secret for authenticating API calls.
    customerId String
    The customer identifier for authenticating API calls.
    accessClientId string
    The Access client ID to be used as the Cf-Access-Client-ID header when making a request to the api_url.
    accessClientSecret string
    The Access client secret to be used as the Cf-Access-Client-Secret header when making a request to the api_url.
    apiUrl string
    The third-party API's URL.
    authUrl string
    The third-party authorization API URL.
    clientId string
    The client identifier for authenticating API calls.
    clientKey string
    The client key for authenticating API calls.
    clientSecret string
    The client secret for authenticating API calls.
    customerId string
    The customer identifier for authenticating API calls.
    access_client_id str
    The Access client ID to be used as the Cf-Access-Client-ID header when making a request to the api_url.
    access_client_secret str
    The Access client secret to be used as the Cf-Access-Client-Secret header when making a request to the api_url.
    api_url str
    The third-party API's URL.
    auth_url str
    The third-party authorization API URL.
    client_id str
    The client identifier for authenticating API calls.
    client_key str
    The client key for authenticating API calls.
    client_secret str
    The client secret for authenticating API calls.
    customer_id str
    The customer identifier for authenticating API calls.
    accessClientId String
    The Access client ID to be used as the Cf-Access-Client-ID header when making a request to the api_url.
    accessClientSecret String
    The Access client secret to be used as the Cf-Access-Client-Secret header when making a request to the api_url.
    apiUrl String
    The third-party API's URL.
    authUrl String
    The third-party authorization API URL.
    clientId String
    The client identifier for authenticating API calls.
    clientKey String
    The client key for authenticating API calls.
    clientSecret String
    The client secret for authenticating API calls.
    customerId String
    The customer identifier for authenticating API calls.

    Import

    $ pulumi import cloudflare:index/devicePostureIntegration:DevicePostureIntegration example <account_id>/<device_posture_integration_id>
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    Cloudflare pulumi/pulumi-cloudflare
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the cloudflare Terraform Provider.
    cloudflare logo
    Cloudflare v5.26.0 published on Wednesday, Apr 17, 2024 by Pulumi