# CfnConfigurationPolicyProps

Properties for defining a `CfnConfigurationPolicy`.

Extends: CfnConfigurationPolicyProps
Used as props by: CfnConfigurationPolicy

- Source: Generated code
- Type last changed: v2.145.0 · 7 Jun 2024

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_securityhub as securityhub } from 'aws-cdk-lib';
const cfnConfigurationPolicyProps: securityhub.CfnConfigurationPolicyProps = {
  configurationPolicy: {
    securityHub: {
      enabledStandardIdentifiers: ['enabledStandardIdentifiers'],
      securityControlsConfiguration: {
        disabledSecurityControlIdentifiers: ['disabledSecurityControlIdentifiers'],
        enabledSecurityControlIdentifiers: ['enabledSecurityControlIdentifiers'],
        securityControlCustomParameters: [{
          parameters: {
            parametersKey: {
              valueType: 'valueType',

              // the properties below are optional
              value: {
                boolean: false,
                double: 123,
                enum: 'enum',
                enumList: ['enumList'],
                integer: 123,
                integerList: [123],
                string: 'string',
                stringList: ['stringList'],
              },
            },
          },
          securityControlId: 'securityControlId',
        }],
      },
      serviceEnabled: false,
    },
  },
  name: 'name',

  // the properties below are optional
  description: 'description',
  tags: {
    tagsKey: 'tags',
  },
};
```

## Properties

- `configurationPolicy`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnConfigurationPolicy.PolicyProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_securityhub.CfnConfigurationPolicy.PolicyProperty.html) (required) — An object that defines how AWS Security Hub CSPM is configured.

  It includes whether Security Hub CSPM is enabled or disabled, a list of enabled security standards, a list of enabled or disabled security controls, and a list of custom parameter values for specified controls. If you provide a list of security controls that are enabled in the configuration policy, Security Hub CSPM disables all other controls (including newly released controls). If you provide a list of security controls that are disabled in the configuration policy, Security Hub CSPM enables all other controls (including newly released controls).

- `description`: string — The description of the configuration policy.

- `name`: string (required) — The name of the configuration policy.

  Alphanumeric characters and the following ASCII characters are permitted: `-, ., !, *, /` .

- `tags`: { [key: string]: string } — User-defined tags associated with a configuration policy.

  For more information, see [Tagging AWS Security Hub CSPM resources](https://docs.aws.amazon.com/securityhub/latest/userguide/tagging-resources.html) in the *Security Hub CSPM user guide* .