# CfnConnectorProps

Properties for defining a `CfnConnector`.

Extends: CfnConnectorProps
Used as props by: CfnConnector

- Source: Generated code
- Type last changed: v2.234.0 · 8 Jan 2026

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_kafkaconnect as kafkaconnect } from 'aws-cdk-lib';
const cfnConnectorProps: kafkaconnect.CfnConnectorProps = {
  capacity: {
    autoScaling: {
      maxWorkerCount: 123,
      mcuCount: 123,
      minWorkerCount: 123,
      scaleInPolicy: {
        cpuUtilizationPercentage: 123,
      },
      scaleOutPolicy: {
        cpuUtilizationPercentage: 123,
      },

      // the properties below are optional
      maxAutoscalingTaskCount: 123,
    },
    provisionedCapacity: {
      mcuCount: 123,
      workerCount: 123,
    },
  },
  connectorConfiguration: {
    connectorConfigurationKey: 'connectorConfiguration',
  },
  connectorName: 'connectorName',
  kafkaCluster: {
    apacheKafkaCluster: {
      bootstrapServers: 'bootstrapServers',
      vpc: {
        securityGroups: ['securityGroups'],
        subnets: ['subnets'],
      },
    },
  },
  kafkaClusterClientAuthentication: {
    authenticationType: 'authenticationType',
  },
  kafkaClusterEncryptionInTransit: {
    encryptionType: 'encryptionType',
  },
  kafkaConnectVersion: 'kafkaConnectVersion',
  plugins: [{
    customPlugin: {
      customPluginArn: 'customPluginArn',
      revision: 123,
    },
  }],
  serviceExecutionRoleArn: 'serviceExecutionRoleArn',

  // the properties below are optional
  connectorDescription: 'connectorDescription',
  logDelivery: {
    workerLogDelivery: {
      cloudWatchLogs: {
        enabled: false,

        // the properties below are optional
        logGroup: 'logGroup',
      },
      firehose: {
        enabled: false,

        // the properties below are optional
        deliveryStream: 'deliveryStream',
      },
      s3: {
        enabled: false,

        // the properties below are optional
        bucket: 'bucket',
        prefix: 'prefix',
      },
    },
  },
  networkType: 'networkType',
  tags: [{
    key: 'key',
    value: 'value',
  }],
  workerConfiguration: {
    revision: 123,
    workerConfigurationArn: 'workerConfigurationArn',
  },
};
```

## Properties

- `capacity`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnConnector.CapacityProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_kafkaconnect.CfnConnector.CapacityProperty.html) (required) — The connector's compute capacity settings.

- `connectorConfiguration`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | { [key: string]: string } (required) — The configuration of the connector.

- `connectorDescription`: string — The description of the connector.

- `connectorName`: string (required) — The name of the connector.

  The connector name must be unique and can include up to 128 characters. Valid characters you can include in a connector name are: a-z, A-Z, 0-9, and -.

- `kafkaCluster`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnConnector.KafkaClusterProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_kafkaconnect.CfnConnector.KafkaClusterProperty.html) (required) — The details of the Apache Kafka cluster to which the connector is connected.

- `kafkaClusterClientAuthentication`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnConnector.KafkaClusterClientAuthenticationProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_kafkaconnect.CfnConnector.KafkaClusterClientAuthenticationProperty.html) (required) — The type of client authentication used to connect to the Apache Kafka cluster.

  The value is NONE when no client authentication is used.

- `kafkaClusterEncryptionInTransit`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnConnector.KafkaClusterEncryptionInTransitProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_kafkaconnect.CfnConnector.KafkaClusterEncryptionInTransitProperty.html) (required) — Details of encryption in transit to the Apache Kafka cluster.

- `kafkaConnectVersion`: string (required) — The version of Kafka Connect.

  It has to be compatible with both the Apache Kafka cluster's version and the plugins.

- `logDelivery`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnConnector.LogDeliveryProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_kafkaconnect.CfnConnector.LogDeliveryProperty.html) — The settings for delivering connector logs to Amazon CloudWatch Logs.

- `networkType`: string — The network type of the connector.

  It gives connectors connectivity to either IPv4 (IPV4) or IPv4 and IPv6 (DUAL) destinations. Defaults to IPV4.

- `plugins`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnConnector.PluginProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_kafkaconnect.CfnConnector.PluginProperty.html)[] (required) — Specifies which plugin to use for the connector.

  You must specify a single-element list. Amazon MSK Connect does not currently support specifying multiple plugins.

- `serviceExecutionRoleArn`: string (required) — The Amazon Resource Name (ARN) of the IAM role used by the connector to access Amazon Web Services resources.

- `tags`: [CfnTag](/cdk/api/v2/docs/aws-cdk-lib.CfnTag.html)[] — A collection of tags associated with a resource.

- `workerConfiguration`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnConnector.WorkerConfigurationProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_kafkaconnect.CfnConnector.WorkerConfigurationProperty.html) — The worker configurations that are in use with the connector.