# CfnOrganizationConfigurationProps

Properties for defining a `CfnOrganizationConfiguration`.

Used as props by: [CfnOrganizationConfiguration](/cdk/api/v2/docs/aws-cdk-lib.aws_securityhub.CfnOrganizationConfiguration.html)

- Source: Generated at build time
- Type last changed: v2.145.0 · 7 Jun 2024

## Example

TypeScript:

```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 cfnOrganizationConfigurationProps: securityhub.CfnOrganizationConfigurationProps = {
  autoEnable: false,

  // the properties below are optional
  autoEnableStandards: 'autoEnableStandards',
  configurationType: 'configurationType',
};
```

Python:

```python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_securityhub as securityhub

cfn_organization_configuration_props = securityhub.CfnOrganizationConfigurationProps(
    auto_enable=False,

    # the properties below are optional
    auto_enable_standards="autoEnableStandards",
    configuration_type="configurationType"
)
```

Java:

```java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.securityhub.*;

CfnOrganizationConfigurationProps cfnOrganizationConfigurationProps = CfnOrganizationConfigurationProps.builder()
        .autoEnable(false)

        // the properties below are optional
        .autoEnableStandards("autoEnableStandards")
        .configurationType("configurationType")
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.SecurityHub;

var cfnOrganizationConfigurationProps = new CfnOrganizationConfigurationProps {
    AutoEnable = false,

    // the properties below are optional
    AutoEnableStandards = "autoEnableStandards",
    ConfigurationType = "configurationType"
};
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import "github.com/aws/aws-cdk-go/awscdk"

cfnOrganizationConfigurationProps := &CfnOrganizationConfigurationProps{
	AutoEnable: jsii.Boolean(false),

	// the properties below are optional
	AutoEnableStandards: jsii.String("autoEnableStandards"),
	ConfigurationType: jsii.String("configurationType"),
}
```

## Properties

- `autoEnable`: boolean | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) (required) — Whether to automatically enable Security Hub CSPM in new member accounts when they join the organization.

  If set to `true` , then Security Hub CSPM is automatically enabled in new accounts. If set to `false` , then Security Hub CSPM isn't enabled in new accounts automatically. The default value is `false` .

  If the `ConfigurationType` of your organization is set to `CENTRAL` , then this field is set to `false` and can't be changed in the home Region and linked Regions. However, in that case, the delegated administrator can create a configuration policy in which Security Hub CSPM is enabled and associate the policy with new organization accounts.

- `autoEnableStandards`: string — Whether to automatically enable Security Hub CSPM [default standards](https://docs.aws.amazon.com/securityhub/latest/userguide/securityhub-standards-enable-disable.html) in new member accounts when they join the organization.

  The default value of this parameter is equal to `DEFAULT` .

  If equal to `DEFAULT` , then Security Hub CSPM default standards are automatically enabled for new member accounts. If equal to `NONE` , then default standards are not automatically enabled for new member accounts.

  If the `ConfigurationType` of your organization is set to `CENTRAL` , then this field is set to `NONE` and can't be changed in the home Region and linked Regions. However, in that case, the delegated administrator can create a configuration policy in which specific security standards are enabled and associate the policy with new organization accounts.

- `configurationType`: string — Indicates whether the organization uses local or central configuration.

  If you use local configuration, the Security Hub CSPM delegated administrator can set `AutoEnable` to `true` and `AutoEnableStandards` to `DEFAULT` . This automatically enables Security Hub CSPM and default security standards in new organization accounts. These new account settings must be set separately in each AWS Region , and settings may be different in each Region.

  If you use central configuration, the delegated administrator can create configuration policies. Configuration policies can be used to configure Security Hub CSPM, security standards, and security controls in multiple accounts and Regions. If you want new organization accounts to use a specific configuration, you can create a configuration policy and associate it with the root or specific organizational units (OUs). New accounts will inherit the policy from the root or their assigned OU.
