@aws-sdk/client-securityhub 3.458.0 → 3.460.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/README.md +80 -0
  2. package/dist-cjs/SecurityHub.js +20 -0
  3. package/dist-cjs/commands/BatchGetConfigurationPolicyAssociationsCommand.js +51 -0
  4. package/dist-cjs/commands/CreateConfigurationPolicyCommand.js +51 -0
  5. package/dist-cjs/commands/DeleteConfigurationPolicyCommand.js +51 -0
  6. package/dist-cjs/commands/GetConfigurationPolicyAssociationCommand.js +51 -0
  7. package/dist-cjs/commands/GetConfigurationPolicyCommand.js +51 -0
  8. package/dist-cjs/commands/ListConfigurationPoliciesCommand.js +51 -0
  9. package/dist-cjs/commands/ListConfigurationPolicyAssociationsCommand.js +51 -0
  10. package/dist-cjs/commands/StartConfigurationPolicyAssociationCommand.js +51 -0
  11. package/dist-cjs/commands/StartConfigurationPolicyDisassociationCommand.js +51 -0
  12. package/dist-cjs/commands/UpdateConfigurationPolicyCommand.js +51 -0
  13. package/dist-cjs/commands/index.js +10 -0
  14. package/dist-cjs/models/models_0.js +10 -1
  15. package/dist-cjs/models/models_2.js +34 -1
  16. package/dist-cjs/pagination/ListConfigurationPoliciesPaginator.js +29 -0
  17. package/dist-cjs/pagination/ListConfigurationPolicyAssociationsPaginator.js +29 -0
  18. package/dist-cjs/pagination/index.js +2 -0
  19. package/dist-cjs/protocols/Aws_restJson1.js +943 -35
  20. package/dist-es/SecurityHub.js +20 -0
  21. package/dist-es/commands/BatchGetConfigurationPolicyAssociationsCommand.js +47 -0
  22. package/dist-es/commands/CreateConfigurationPolicyCommand.js +47 -0
  23. package/dist-es/commands/DeleteConfigurationPolicyCommand.js +47 -0
  24. package/dist-es/commands/GetConfigurationPolicyAssociationCommand.js +47 -0
  25. package/dist-es/commands/GetConfigurationPolicyCommand.js +47 -0
  26. package/dist-es/commands/ListConfigurationPoliciesCommand.js +47 -0
  27. package/dist-es/commands/ListConfigurationPolicyAssociationsCommand.js +47 -0
  28. package/dist-es/commands/StartConfigurationPolicyAssociationCommand.js +47 -0
  29. package/dist-es/commands/StartConfigurationPolicyDisassociationCommand.js +47 -0
  30. package/dist-es/commands/UpdateConfigurationPolicyCommand.js +47 -0
  31. package/dist-es/commands/index.js +10 -0
  32. package/dist-es/models/models_0.js +9 -0
  33. package/dist-es/models/models_2.js +33 -0
  34. package/dist-es/pagination/ListConfigurationPoliciesPaginator.js +25 -0
  35. package/dist-es/pagination/ListConfigurationPolicyAssociationsPaginator.js +25 -0
  36. package/dist-es/pagination/index.js +2 -0
  37. package/dist-es/protocols/Aws_restJson1.js +920 -33
  38. package/dist-types/SecurityHub.d.ts +70 -0
  39. package/dist-types/SecurityHubClient.d.ts +12 -2
  40. package/dist-types/commands/BatchDisableStandardsCommand.d.ts +3 -0
  41. package/dist-types/commands/BatchEnableStandardsCommand.d.ts +3 -0
  42. package/dist-types/commands/BatchGetAutomationRulesCommand.d.ts +3 -0
  43. package/dist-types/commands/BatchGetConfigurationPolicyAssociationsCommand.d.ts +176 -0
  44. package/dist-types/commands/BatchGetSecurityControlsCommand.d.ts +22 -2
  45. package/dist-types/commands/BatchImportFindingsCommand.d.ts +4 -0
  46. package/dist-types/commands/BatchUpdateAutomationRulesCommand.d.ts +3 -0
  47. package/dist-types/commands/BatchUpdateStandardsControlAssociationsCommand.d.ts +3 -0
  48. package/dist-types/commands/CreateAutomationRuleCommand.d.ts +3 -0
  49. package/dist-types/commands/CreateConfigurationPolicyCommand.d.ts +265 -0
  50. package/dist-types/commands/CreateInsightCommand.d.ts +3 -0
  51. package/dist-types/commands/CreateMembersCommand.d.ts +3 -0
  52. package/dist-types/commands/DeleteConfigurationPolicyCommand.d.ts +109 -0
  53. package/dist-types/commands/DescribeOrganizationConfigurationCommand.d.ts +27 -2
  54. package/dist-types/commands/DisableOrganizationAdminAccountCommand.d.ts +3 -0
  55. package/dist-types/commands/DisableSecurityHubCommand.d.ts +3 -0
  56. package/dist-types/commands/DisassociateMembersCommand.d.ts +3 -0
  57. package/dist-types/commands/EnableOrganizationAdminAccountCommand.d.ts +3 -0
  58. package/dist-types/commands/GetConfigurationPolicyAssociationCommand.d.ts +131 -0
  59. package/dist-types/commands/GetConfigurationPolicyCommand.d.ts +191 -0
  60. package/dist-types/commands/GetFindingsCommand.d.ts +7 -0
  61. package/dist-types/commands/GetInsightsCommand.d.ts +3 -0
  62. package/dist-types/commands/GetSecurityControlDefinitionCommand.d.ts +35 -0
  63. package/dist-types/commands/ListConfigurationPoliciesCommand.d.ts +131 -0
  64. package/dist-types/commands/ListConfigurationPolicyAssociationsCommand.d.ts +140 -0
  65. package/dist-types/commands/ListSecurityControlDefinitionsCommand.d.ts +6 -0
  66. package/dist-types/commands/StartConfigurationPolicyAssociationCommand.d.ts +133 -0
  67. package/dist-types/commands/StartConfigurationPolicyDisassociationCommand.d.ts +116 -0
  68. package/dist-types/commands/UpdateConfigurationPolicyCommand.d.ts +271 -0
  69. package/dist-types/commands/UpdateFindingsCommand.d.ts +3 -0
  70. package/dist-types/commands/UpdateInsightCommand.d.ts +3 -0
  71. package/dist-types/commands/UpdateOrganizationConfigurationCommand.d.ts +16 -2
  72. package/dist-types/commands/UpdateSecurityControlCommand.d.ts +23 -0
  73. package/dist-types/commands/UpdateSecurityHubConfigurationCommand.d.ts +3 -0
  74. package/dist-types/commands/UpdateStandardsControlCommand.d.ts +3 -0
  75. package/dist-types/commands/index.d.ts +10 -0
  76. package/dist-types/models/models_0.d.ts +86 -192
  77. package/dist-types/models/models_1.d.ts +192 -49
  78. package/dist-types/models/models_2.d.ts +1180 -37
  79. package/dist-types/pagination/ListConfigurationPoliciesPaginator.d.ts +7 -0
  80. package/dist-types/pagination/ListConfigurationPolicyAssociationsPaginator.d.ts +7 -0
  81. package/dist-types/pagination/index.d.ts +2 -0
  82. package/dist-types/protocols/Aws_restJson1.d.ts +90 -0
  83. package/dist-types/ts3.4/SecurityHub.d.ts +200 -0
  84. package/dist-types/ts3.4/SecurityHubClient.d.ts +60 -0
  85. package/dist-types/ts3.4/commands/BatchGetConfigurationPolicyAssociationsCommand.d.ts +42 -0
  86. package/dist-types/ts3.4/commands/CreateConfigurationPolicyCommand.d.ts +42 -0
  87. package/dist-types/ts3.4/commands/DeleteConfigurationPolicyCommand.d.ts +42 -0
  88. package/dist-types/ts3.4/commands/GetConfigurationPolicyAssociationCommand.d.ts +42 -0
  89. package/dist-types/ts3.4/commands/GetConfigurationPolicyCommand.d.ts +42 -0
  90. package/dist-types/ts3.4/commands/ListConfigurationPoliciesCommand.d.ts +42 -0
  91. package/dist-types/ts3.4/commands/ListConfigurationPolicyAssociationsCommand.d.ts +42 -0
  92. package/dist-types/ts3.4/commands/StartConfigurationPolicyAssociationCommand.d.ts +42 -0
  93. package/dist-types/ts3.4/commands/StartConfigurationPolicyDisassociationCommand.d.ts +42 -0
  94. package/dist-types/ts3.4/commands/UpdateConfigurationPolicyCommand.d.ts +42 -0
  95. package/dist-types/ts3.4/commands/index.d.ts +10 -0
  96. package/dist-types/ts3.4/models/models_0.d.ts +21 -26
  97. package/dist-types/ts3.4/models/models_1.d.ts +32 -9
  98. package/dist-types/ts3.4/models/models_2.d.ts +243 -4
  99. package/dist-types/ts3.4/pagination/ListConfigurationPoliciesPaginator.d.ts +11 -0
  100. package/dist-types/ts3.4/pagination/ListConfigurationPolicyAssociationsPaginator.d.ts +11 -0
  101. package/dist-types/ts3.4/pagination/index.d.ts +2 -0
  102. package/dist-types/ts3.4/protocols/Aws_restJson1.d.ts +120 -0
  103. package/package.json +12 -12
@@ -1,7 +1,55 @@
1
1
  import { ExceptionOptionType as __ExceptionOptionType } from "@smithy/smithy-client";
2
- import { AccountDetails, Action, ActionTarget, Adjustment, AdminAccount, AssociationStatus, AutoEnableStandards, AutomationRulesAction, AutomationRulesConfig, AutomationRulesFindingFilters, AutomationRulesMetadata, AwsAmazonMqBrokerDetails, AwsApiGatewayRestApiDetails, AwsApiGatewayStageDetails, AwsApiGatewayV2ApiDetails, AwsApiGatewayV2StageDetails, AwsAppSyncGraphQlApiDetails, AwsAthenaWorkGroupDetails, AwsAutoScalingAutoScalingGroupDetails, AwsAutoScalingLaunchConfigurationDetails, AwsBackupBackupPlanDetails, AwsBackupBackupVaultDetails, AwsBackupRecoveryPointDetails, AwsCertificateManagerCertificateDetails, AwsCloudFormationStackDetails, AwsCloudFrontDistributionDetails, AwsCloudTrailTrailDetails, AwsCloudWatchAlarmDetails, AwsCodeBuildProjectDetails, AwsDmsEndpointDetails, AwsDmsReplicationInstanceDetails, AwsDmsReplicationTaskDetails, AwsDynamoDbTableDetails, AwsEc2EipDetails, AwsEc2InstanceDetails, AwsEc2LaunchTemplateDetails, AwsEc2NetworkAclDetails, AwsEc2NetworkInterfaceDetails, AwsEc2RouteTableDetails, AwsEc2SecurityGroupDetails, AwsEc2SubnetDetails, AwsEc2TransitGatewayDetails, AwsEc2VolumeDetails, AwsEc2VpcDetails, AwsEc2VpcEndpointServiceDetails, AwsEc2VpcPeeringConnectionDetails, AwsEc2VpnConnectionDetails, AwsEcrContainerImageDetails, AwsEcrRepositoryDetails, AwsEcsClusterDetails, AwsEcsContainerDetails, AwsEcsServiceDetails, AwsEcsTaskDefinitionDetails, DateFilter, MapFilter, NoteUpdate, NumberFilter, RelatedFinding, RuleStatus, SeverityLabel, SeverityUpdate, StringFilter, VerificationState, WorkflowStatus, WorkflowUpdate } from "./models_0";
3
- import { AwsEcsTaskDetails, AwsEfsAccessPointDetails, AwsEksClusterDetails, AwsElasticBeanstalkEnvironmentDetails, AwsElasticsearchDomainDetails, AwsElbLoadBalancerDetails, AwsElbv2LoadBalancerDetails, AwsEventSchemasRegistryDetails, AwsEventsEndpointDetails, AwsEventsEventbusDetails, AwsGuardDutyDetectorDetails, AwsIamAccessKeyDetails, AwsIamGroupDetails, AwsIamPolicyDetails, AwsIamRoleDetails, AwsIamUserDetails, AwsKinesisStreamDetails, AwsKmsKeyDetails, AwsLambdaFunctionDetails, AwsLambdaLayerVersionDetails, AwsMskClusterDetails, AwsNetworkFirewallFirewallDetails, AwsNetworkFirewallFirewallPolicyDetails, AwsNetworkFirewallRuleGroupDetails, AwsOpenSearchServiceDomainDetails, AwsRdsDbClusterDetails, AwsRdsDbClusterSnapshotDetails, AwsRdsDbInstanceDetails, AwsRdsDbSecurityGroupDetails, AwsRdsDbSnapshotDetails, AwsRdsEventSubscriptionDetails, AwsRedshiftClusterDetails, AwsRoute53HostedZoneDetails, AwsS3AccountPublicAccessBlockDetails, AwsS3BucketDetails, AwsS3ObjectDetails, AwsSageMakerNotebookInstanceDetails, AwsSecretsManagerSecretDetails, AwsSnsTopicDetails, AwsSqsQueueDetails, AwsSsmPatchComplianceDetails, AwsStepFunctionStateMachineDetails, AwsWafRateBasedRuleDetails, AwsWafRegionalRateBasedRuleDetails, AwsWafRegionalRuleDetails, AwsWafRegionalRuleGroupDetails, AwsWafRegionalWebAclDetails, AwsWafRuleDetails, AwsWafRuleGroupDetails, AwsWafv2ActionAllowDetails, AwsWafv2ActionBlockDetails, AwsWafv2RulesActionCaptchaDetails, AwsWafv2RulesActionCountDetails, Compliance, DataClassificationDetails, FindingProviderFields, GeneratorDetails, Malware, Network, NetworkPathComponent, Note, PatchSummary, ProcessDetails, RecordState, Remediation } from "./models_1";
2
+ import { AccountDetails, Action, ActionTarget, Adjustment, AdminAccount, AssociationFilters, AssociationStatus, AssociationType, AutoEnableStandards, AutomationRulesAction, AutomationRulesConfig, AutomationRulesFindingFilters, AutomationRulesMetadata, AwsAmazonMqBrokerDetails, AwsApiGatewayRestApiDetails, AwsApiGatewayStageDetails, AwsApiGatewayV2ApiDetails, AwsApiGatewayV2StageDetails, AwsAppSyncGraphQlApiDetails, AwsAthenaWorkGroupDetails, AwsAutoScalingAutoScalingGroupDetails, AwsAutoScalingLaunchConfigurationDetails, AwsBackupBackupPlanDetails, AwsBackupBackupVaultDetails, AwsBackupRecoveryPointDetails, AwsCertificateManagerCertificateDetails, AwsCloudFormationStackDetails, AwsCloudFrontDistributionDetails, AwsCloudTrailTrailDetails, AwsCloudWatchAlarmDetails, AwsCodeBuildProjectDetails, AwsDmsEndpointDetails, AwsDmsReplicationInstanceDetails, AwsDmsReplicationTaskDetails, AwsDynamoDbTableDetails, AwsEc2EipDetails, AwsEc2InstanceDetails, AwsEc2LaunchTemplateDetails, AwsEc2NetworkAclDetails, AwsEc2NetworkInterfaceDetails, AwsEc2RouteTableDetails, AwsEc2SecurityGroupDetails, AwsEc2SubnetDetails, AwsEc2TransitGatewayDetails, AwsEc2VolumeDetails, AwsEc2VpcDetails, AwsEc2VpcEndpointServiceDetails, AwsEc2VpcPeeringConnectionDetails, AwsEc2VpnConnectionDetails, AwsEcrContainerImageDetails, AwsEcrRepositoryDetails, AwsEcsClusterDetails, AwsEcsContainerDetails, AwsEcsServiceDetails, ConfigurationPolicyAssociationStatus, DateFilter, MapFilter, NoteUpdate, NumberFilter, RelatedFinding, RuleStatus, SeverityLabel, SeverityUpdate, StringFilter, VerificationState, WorkflowStatus, WorkflowUpdate } from "./models_0";
3
+ import { AwsEcsTaskDefinitionDetails, AwsEcsTaskDetails, AwsEfsAccessPointDetails, AwsEksClusterDetails, AwsElasticBeanstalkEnvironmentDetails, AwsElasticsearchDomainDetails, AwsElbLoadBalancerDetails, AwsElbv2LoadBalancerDetails, AwsEventSchemasRegistryDetails, AwsEventsEndpointDetails, AwsEventsEventbusDetails, AwsGuardDutyDetectorDetails, AwsIamAccessKeyDetails, AwsIamGroupDetails, AwsIamPolicyDetails, AwsIamRoleDetails, AwsIamUserDetails, AwsKinesisStreamDetails, AwsKmsKeyDetails, AwsLambdaFunctionDetails, AwsLambdaLayerVersionDetails, AwsMskClusterDetails, AwsNetworkFirewallFirewallDetails, AwsNetworkFirewallFirewallPolicyDetails, AwsNetworkFirewallRuleGroupDetails, AwsOpenSearchServiceDomainDetails, AwsRdsDbClusterDetails, AwsRdsDbClusterSnapshotDetails, AwsRdsDbInstanceDetails, AwsRdsDbSecurityGroupDetails, AwsRdsDbSnapshotDetails, AwsRdsEventSubscriptionDetails, AwsRedshiftClusterDetails, AwsRoute53HostedZoneDetails, AwsS3AccountPublicAccessBlockDetails, AwsS3BucketDetails, AwsS3ObjectDetails, AwsSageMakerNotebookInstanceDetails, AwsSecretsManagerSecretDetails, AwsSnsTopicDetails, AwsSqsQueueDetails, AwsSsmPatchComplianceDetails, AwsStepFunctionStateMachineDetails, AwsWafRateBasedRuleDetails, AwsWafRegionalRateBasedRuleDetails, AwsWafRegionalRuleDetails, AwsWafRegionalRuleGroupDetails, AwsWafRegionalWebAclDetails, AwsWafRuleDetails, AwsWafRuleGroupDetails, AwsWafv2ActionAllowDetails, AwsWafv2CustomRequestHandlingDetails, AwsWafv2CustomResponseDetails, Compliance, DataClassificationDetails, FindingProviderFields, GeneratorDetails, Malware, Network, NetworkPathComponent, Note, PatchSummary, ProcessDetails, RecordState, Remediation } from "./models_1";
4
4
  import { SecurityHubServiceException as __BaseException } from "./SecurityHubServiceException";
5
+ /**
6
+ * @public
7
+ * <p>
8
+ * Specifies that WAF should block the request and optionally defines additional custom handling for the response to the web request.
9
+ * </p>
10
+ */
11
+ export interface AwsWafv2ActionBlockDetails {
12
+ /**
13
+ * @public
14
+ * <p>
15
+ * Defines a custom response for the web request. For information, see
16
+ * <a href="https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html">Customizing web requests and responses in WAF</a> in the <i>WAF Developer Guide.</i>.
17
+ * </p>
18
+ */
19
+ CustomResponse?: AwsWafv2CustomResponseDetails;
20
+ }
21
+ /**
22
+ * @public
23
+ * <p>
24
+ * Specifies that WAF should run a CAPTCHA check against the request.
25
+ * </p>
26
+ */
27
+ export interface AwsWafv2RulesActionCaptchaDetails {
28
+ /**
29
+ * @public
30
+ * <p>
31
+ * Defines custom handling for the web request, used when the CAPTCHA inspection determines that the request's token is valid and unexpired. For more information,
32
+ * see <a href="https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html">Customizing web requests and responses in WAF</a> in the <i>WAF Developer Guide.</i>.
33
+ * </p>
34
+ */
35
+ CustomRequestHandling?: AwsWafv2CustomRequestHandlingDetails;
36
+ }
37
+ /**
38
+ * @public
39
+ * <p>
40
+ * Specifies that WAF should count the request.
41
+ * </p>
42
+ */
43
+ export interface AwsWafv2RulesActionCountDetails {
44
+ /**
45
+ * @public
46
+ * <p>
47
+ * Defines custom handling for the web request. For more information,
48
+ * see <a href="https://docs.aws.amazon.com/waf/latest/developerguide/waf-custom-request-response.html">Customizing web requests and responses in WAF</a> in the <i>WAF Developer Guide.</i>.
49
+ * </p>
50
+ */
51
+ CustomRequestHandling?: AwsWafv2CustomRequestHandlingDetails;
52
+ }
5
53
  /**
6
54
  * @public
7
55
  * <p>
@@ -1172,6 +1220,20 @@ export interface Resource {
1172
1220
  * <p>Additional details about the resource related to a finding.</p>
1173
1221
  */
1174
1222
  Details?: ResourceDetails;
1223
+ /**
1224
+ * @public
1225
+ * <p>
1226
+ * The name of the application that is related to a finding.
1227
+ * </p>
1228
+ */
1229
+ ApplicationName?: string;
1230
+ /**
1231
+ * @public
1232
+ * <p>
1233
+ * The Amazon Resource Name (ARN) of the application that is related to a finding.
1234
+ * </p>
1235
+ */
1236
+ ApplicationArn?: string;
1175
1237
  }
1176
1238
  /**
1177
1239
  * @public
@@ -2061,6 +2123,18 @@ export interface AwsSecurityFinding {
2061
2123
  * </p>
2062
2124
  */
2063
2125
  GeneratorDetails?: GeneratorDetails;
2126
+ /**
2127
+ * @public
2128
+ * <p>An ISO8601-formatted timestamp that indicates when Security Hub received a finding and begins to process it.</p>
2129
+ * <p>A correctly formatted example is <code>2020-05-21T20:16:34.724Z</code>. The value cannot contain spaces, and date and time should be separated by <code>T</code>. For more information, see <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC 3339 section 5.6, Internet Date/Time Format</a>.</p>
2130
+ */
2131
+ ProcessedAt?: string;
2132
+ /**
2133
+ * @public
2134
+ * <p>The name of the Amazon Web Services account from which a finding was generated.
2135
+ * </p>
2136
+ */
2137
+ AwsAccountName?: string;
2064
2138
  }
2065
2139
  /**
2066
2140
  * @public
@@ -2111,7 +2185,7 @@ export interface AwsSecurityFindingFilters {
2111
2185
  ProductArn?: StringFilter[];
2112
2186
  /**
2113
2187
  * @public
2114
- * <p>The Amazon Web Services account ID that a finding is generated in.</p>
2188
+ * <p>The Amazon Web Services account ID in which a finding is generated.</p>
2115
2189
  */
2116
2190
  AwsAccountId?: StringFilter[];
2117
2191
  /**
@@ -2743,6 +2817,25 @@ export interface AwsSecurityFindingFilters {
2743
2817
  * </p>
2744
2818
  */
2745
2819
  ComplianceSecurityControlParametersValue?: StringFilter[];
2820
+ /**
2821
+ * @public
2822
+ * <p>The name of the Amazon Web Services account in which a finding is generated.</p>
2823
+ */
2824
+ AwsAccountName?: StringFilter[];
2825
+ /**
2826
+ * @public
2827
+ * <p>
2828
+ * The name of the application that is related to a finding.
2829
+ * </p>
2830
+ */
2831
+ ResourceApplicationName?: StringFilter[];
2832
+ /**
2833
+ * @public
2834
+ * <p>
2835
+ * The ARN of the application that is related to a finding.
2836
+ * </p>
2837
+ */
2838
+ ResourceApplicationArn?: StringFilter[];
2746
2839
  }
2747
2840
  /**
2748
2841
  * @public
@@ -3005,6 +3098,223 @@ export interface BatchGetAutomationRulesResponse {
3005
3098
  */
3006
3099
  UnprocessedAutomationRules?: UnprocessedAutomationRule[];
3007
3100
  }
3101
+ /**
3102
+ * @public
3103
+ * <p>
3104
+ * The target account, organizational unit, or the root that is associated with an Security Hub configuration. The configuration
3105
+ * can be a configuration policy or self-managed behavior.
3106
+ * </p>
3107
+ */
3108
+ export type Target = Target.AccountIdMember | Target.OrganizationalUnitIdMember | Target.RootIdMember | Target.$UnknownMember;
3109
+ /**
3110
+ * @public
3111
+ */
3112
+ export declare namespace Target {
3113
+ /**
3114
+ * @public
3115
+ * <p>
3116
+ * The Amazon Web Services account ID of the target account.
3117
+ * </p>
3118
+ */
3119
+ interface AccountIdMember {
3120
+ AccountId: string;
3121
+ OrganizationalUnitId?: never;
3122
+ RootId?: never;
3123
+ $unknown?: never;
3124
+ }
3125
+ /**
3126
+ * @public
3127
+ * <p>
3128
+ * The organizational unit ID of the target organizational unit.
3129
+ * </p>
3130
+ */
3131
+ interface OrganizationalUnitIdMember {
3132
+ AccountId?: never;
3133
+ OrganizationalUnitId: string;
3134
+ RootId?: never;
3135
+ $unknown?: never;
3136
+ }
3137
+ /**
3138
+ * @public
3139
+ * <p>
3140
+ * The ID of the organization root.
3141
+ * </p>
3142
+ */
3143
+ interface RootIdMember {
3144
+ AccountId?: never;
3145
+ OrganizationalUnitId?: never;
3146
+ RootId: string;
3147
+ $unknown?: never;
3148
+ }
3149
+ /**
3150
+ * @public
3151
+ */
3152
+ interface $UnknownMember {
3153
+ AccountId?: never;
3154
+ OrganizationalUnitId?: never;
3155
+ RootId?: never;
3156
+ $unknown: [string, any];
3157
+ }
3158
+ interface Visitor<T> {
3159
+ AccountId: (value: string) => T;
3160
+ OrganizationalUnitId: (value: string) => T;
3161
+ RootId: (value: string) => T;
3162
+ _: (name: string, value: any) => T;
3163
+ }
3164
+ const visit: <T>(value: Target, visitor: Visitor<T>) => T;
3165
+ }
3166
+ /**
3167
+ * @public
3168
+ * <p>
3169
+ * Provides details about the association between an Security Hub configuration and a target account, organizational unit, or
3170
+ * the root. An association can exist between a target and a configuration policy, or between a target and self-managed
3171
+ * behavior.
3172
+ * </p>
3173
+ */
3174
+ export interface ConfigurationPolicyAssociation {
3175
+ /**
3176
+ * @public
3177
+ * <p>
3178
+ * The target account, organizational unit, or the root.
3179
+ * </p>
3180
+ */
3181
+ Target?: Target;
3182
+ }
3183
+ /**
3184
+ * @public
3185
+ */
3186
+ export interface BatchGetConfigurationPolicyAssociationsRequest {
3187
+ /**
3188
+ * @public
3189
+ * <p>
3190
+ * Specifies one or more target account IDs, organizational unit (OU) IDs, or the root ID to retrieve associations for.
3191
+ * </p>
3192
+ */
3193
+ ConfigurationPolicyAssociationIdentifiers: ConfigurationPolicyAssociation[] | undefined;
3194
+ }
3195
+ /**
3196
+ * @public
3197
+ * @enum
3198
+ */
3199
+ export declare const TargetType: {
3200
+ readonly ACCOUNT: "ACCOUNT";
3201
+ readonly ORGANIZATIONAL_UNIT: "ORGANIZATIONAL_UNIT";
3202
+ };
3203
+ /**
3204
+ * @public
3205
+ */
3206
+ export type TargetType = (typeof TargetType)[keyof typeof TargetType];
3207
+ /**
3208
+ * @public
3209
+ * <p>
3210
+ * An object that contains the details of a configuration policy association that’s returned in a
3211
+ * <code>ListConfigurationPolicyAssociations</code> request.
3212
+ * </p>
3213
+ */
3214
+ export interface ConfigurationPolicyAssociationSummary {
3215
+ /**
3216
+ * @public
3217
+ * <p>
3218
+ * The universally unique identifier (UUID) of the configuration policy.
3219
+ * </p>
3220
+ */
3221
+ ConfigurationPolicyId?: string;
3222
+ /**
3223
+ * @public
3224
+ * <p>
3225
+ * The identifier of the target account, organizational unit, or the root.
3226
+ * </p>
3227
+ */
3228
+ TargetId?: string;
3229
+ /**
3230
+ * @public
3231
+ * <p>
3232
+ * Specifies whether the target is an Amazon Web Services account, organizational unit, or the root.
3233
+ * </p>
3234
+ */
3235
+ TargetType?: TargetType;
3236
+ /**
3237
+ * @public
3238
+ * <p>
3239
+ * Indicates whether the association between the specified target and the configuration was directly applied by the
3240
+ * Security Hub delegated administrator or inherited from a parent.
3241
+ * </p>
3242
+ */
3243
+ AssociationType?: AssociationType;
3244
+ /**
3245
+ * @public
3246
+ * <p>
3247
+ * The date and time, in UTC and ISO 8601 format, that the configuration policy association was last updated.
3248
+ * </p>
3249
+ */
3250
+ UpdatedAt?: Date;
3251
+ /**
3252
+ * @public
3253
+ * <p>
3254
+ * The current status of the association between the specified target and the configuration.
3255
+ * </p>
3256
+ */
3257
+ AssociationStatus?: ConfigurationPolicyAssociationStatus;
3258
+ /**
3259
+ * @public
3260
+ * <p>
3261
+ * The explanation for a <code>FAILED</code> value for <code>AssociationStatus</code>.
3262
+ * </p>
3263
+ */
3264
+ AssociationStatusMessage?: string;
3265
+ }
3266
+ /**
3267
+ * @public
3268
+ * <p>
3269
+ * An array of configuration policy associations, one for each configuration policy association identifier, that
3270
+ * was specified in a <code>BatchGetConfigurationPolicyAssociations</code> request but couldn’t be processed due
3271
+ * to an error.
3272
+ * </p>
3273
+ */
3274
+ export interface UnprocessedConfigurationPolicyAssociation {
3275
+ /**
3276
+ * @public
3277
+ * <p>
3278
+ * Configuration policy association identifiers that were specified in a <code>BatchGetConfigurationPolicyAssociations</code>
3279
+ * request but couldn’t be processed due to an error.
3280
+ * </p>
3281
+ */
3282
+ ConfigurationPolicyAssociationIdentifiers?: ConfigurationPolicyAssociation;
3283
+ /**
3284
+ * @public
3285
+ * <p>
3286
+ * An HTTP status code that identifies why the configuration policy association failed.
3287
+ * </p>
3288
+ */
3289
+ ErrorCode?: string;
3290
+ /**
3291
+ * @public
3292
+ * <p>
3293
+ * A string that identifies why the configuration policy association failed.
3294
+ * </p>
3295
+ */
3296
+ ErrorReason?: string;
3297
+ }
3298
+ /**
3299
+ * @public
3300
+ */
3301
+ export interface BatchGetConfigurationPolicyAssociationsResponse {
3302
+ /**
3303
+ * @public
3304
+ * <p>
3305
+ * Describes associations for the target accounts, OUs, or the root.
3306
+ * </p>
3307
+ */
3308
+ ConfigurationPolicyAssociations?: ConfigurationPolicyAssociationSummary[];
3309
+ /**
3310
+ * @public
3311
+ * <p>
3312
+ * An array of configuration policy associations, one for each configuration policy association identifier, that was
3313
+ * specified in the request but couldn’t be processed due to an error.
3314
+ * </p>
3315
+ */
3316
+ UnprocessedConfigurationPolicyAssociations?: UnprocessedConfigurationPolicyAssociation[];
3317
+ }
3008
3318
  /**
3009
3319
  * @public
3010
3320
  */
@@ -4423,6 +4733,57 @@ export declare namespace ConfigurationOptions {
4423
4733
  }
4424
4734
  const visit: <T>(value: ConfigurationOptions, visitor: Visitor<T>) => T;
4425
4735
  }
4736
+ /**
4737
+ * @public
4738
+ * <p>
4739
+ * An object that contains the details of an Security Hub configuration policy that’s returned in a
4740
+ * <code>ListConfigurationPolicies</code> request.
4741
+ * </p>
4742
+ */
4743
+ export interface ConfigurationPolicySummary {
4744
+ /**
4745
+ * @public
4746
+ * <p>
4747
+ * The Amazon Resource Name (ARN) of the configuration policy.
4748
+ * </p>
4749
+ */
4750
+ Arn?: string;
4751
+ /**
4752
+ * @public
4753
+ * <p>
4754
+ * The universally unique identifier (UUID) of the configuration policy.
4755
+ * </p>
4756
+ */
4757
+ Id?: string;
4758
+ /**
4759
+ * @public
4760
+ * <p>
4761
+ * The name of the configuration policy.
4762
+ * </p>
4763
+ */
4764
+ Name?: string;
4765
+ /**
4766
+ * @public
4767
+ * <p>
4768
+ * The description of the configuration policy.
4769
+ * </p>
4770
+ */
4771
+ Description?: string;
4772
+ /**
4773
+ * @public
4774
+ * <p>
4775
+ * The date and time, in UTC and ISO 8601 format, that the configuration policy was last updated.
4776
+ * </p>
4777
+ */
4778
+ UpdatedAt?: Date;
4779
+ /**
4780
+ * @public
4781
+ * <p>
4782
+ * Indicates whether the service that the configuration policy applies to is enabled in the policy.
4783
+ * </p>
4784
+ */
4785
+ ServiceEnabled?: boolean;
4786
+ }
4426
4787
  /**
4427
4788
  * @public
4428
4789
  * @enum
@@ -4486,7 +4847,7 @@ export interface CreateAutomationRuleRequest {
4486
4847
  /**
4487
4848
  * @public
4488
4849
  * <p>
4489
- * User-defined tags that help you label the purpose of a rule.
4850
+ * User-defined tags associated with an automation rule.
4490
4851
  * </p>
4491
4852
  */
4492
4853
  Tags?: Record<string, string>;
@@ -4563,12 +4924,237 @@ export interface CreateAutomationRuleResponse {
4563
4924
  }
4564
4925
  /**
4565
4926
  * @public
4927
+ * <p>
4928
+ * A list of security controls and control parameter values that are included in a configuration policy.
4929
+ * </p>
4566
4930
  */
4567
- export interface CreateFindingAggregatorRequest {
4931
+ export interface SecurityControlCustomParameter {
4568
4932
  /**
4569
4933
  * @public
4570
- * <p>Indicates whether to aggregate findings from all of the available Regions in the current partition. Also determines whether to automatically aggregate findings from new Regions as Security Hub supports them and you opt into them.</p>
4571
- * <p>The selected option also determines how to use the Regions provided in the Regions list.</p>
4934
+ * <p>
4935
+ * The ID of the security control.
4936
+ * </p>
4937
+ */
4938
+ SecurityControlId?: string;
4939
+ /**
4940
+ * @public
4941
+ * <p>
4942
+ * An object that specifies parameter values for a control in a configuration policy.
4943
+ * </p>
4944
+ */
4945
+ Parameters?: Record<string, ParameterConfiguration>;
4946
+ }
4947
+ /**
4948
+ * @public
4949
+ * <p>
4950
+ * An object that defines which security controls are enabled in an Security Hub configuration policy.
4951
+ * The enablement status of a control is aligned across all of the enabled standards in an account.
4952
+ * </p>
4953
+ */
4954
+ export interface SecurityControlsConfiguration {
4955
+ /**
4956
+ * @public
4957
+ * <p>
4958
+ * A list of security controls that are enabled in the configuration policy. Security Hub disables all other
4959
+ * controls (including newly released controls) other than the listed controls.
4960
+ * </p>
4961
+ */
4962
+ EnabledSecurityControlIdentifiers?: string[];
4963
+ /**
4964
+ * @public
4965
+ * <p>
4966
+ * A list of security controls that are disabled in the configuration policy. Security Hub enables all other
4967
+ * controls (including newly released controls) other than the listed controls.
4968
+ * </p>
4969
+ */
4970
+ DisabledSecurityControlIdentifiers?: string[];
4971
+ /**
4972
+ * @public
4973
+ * <p>
4974
+ * A list of security controls and control parameter values that are included in a configuration policy.
4975
+ * </p>
4976
+ */
4977
+ SecurityControlCustomParameters?: SecurityControlCustomParameter[];
4978
+ }
4979
+ /**
4980
+ * @public
4981
+ * <p>
4982
+ * An object that defines how Security Hub is configured. The configuration policy includes whether
4983
+ * Security Hub is enabled or disabled, a list of enabled security standards, a list of enabled or
4984
+ * 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
4985
+ * policy, Security Hub disables all other controls (including newly released controls). If you provide a
4986
+ * list of security controls that are disabled in the configuration policy, Security Hub enables all other
4987
+ * controls (including newly released controls).
4988
+ * </p>
4989
+ */
4990
+ export interface SecurityHubPolicy {
4991
+ /**
4992
+ * @public
4993
+ * <p>
4994
+ * Indicates whether Security Hub is enabled in the policy.
4995
+ * </p>
4996
+ */
4997
+ ServiceEnabled?: boolean;
4998
+ /**
4999
+ * @public
5000
+ * <p>
5001
+ * A list that defines which security standards are enabled in the configuration policy.
5002
+ * </p>
5003
+ */
5004
+ EnabledStandardIdentifiers?: string[];
5005
+ /**
5006
+ * @public
5007
+ * <p>
5008
+ * An object that defines which security controls are enabled in the configuration policy. The enablement status
5009
+ * of a control is aligned across all of the enabled standards in an account.
5010
+ * </p>
5011
+ */
5012
+ SecurityControlsConfiguration?: SecurityControlsConfiguration;
5013
+ }
5014
+ /**
5015
+ * @public
5016
+ * <p>
5017
+ * An object that defines how Security Hub is configured. It includes whether Security Hub is
5018
+ * 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.
5019
+ * If you provide a list of security controls that are enabled in the configuration policy, Security Hub
5020
+ * disables all other controls (including newly released controls). If you provide a list of security controls that
5021
+ * are disabled in the configuration policy, Security Hub enables all other controls (including newly
5022
+ * released controls).
5023
+ * </p>
5024
+ */
5025
+ export type Policy = Policy.SecurityHubMember | Policy.$UnknownMember;
5026
+ /**
5027
+ * @public
5028
+ */
5029
+ export declare namespace Policy {
5030
+ /**
5031
+ * @public
5032
+ * <p>
5033
+ * The Amazon Web Service that the configuration policy applies to.
5034
+ * </p>
5035
+ */
5036
+ interface SecurityHubMember {
5037
+ SecurityHub: SecurityHubPolicy;
5038
+ $unknown?: never;
5039
+ }
5040
+ /**
5041
+ * @public
5042
+ */
5043
+ interface $UnknownMember {
5044
+ SecurityHub?: never;
5045
+ $unknown: [string, any];
5046
+ }
5047
+ interface Visitor<T> {
5048
+ SecurityHub: (value: SecurityHubPolicy) => T;
5049
+ _: (name: string, value: any) => T;
5050
+ }
5051
+ const visit: <T>(value: Policy, visitor: Visitor<T>) => T;
5052
+ }
5053
+ /**
5054
+ * @public
5055
+ */
5056
+ export interface CreateConfigurationPolicyRequest {
5057
+ /**
5058
+ * @public
5059
+ * <p>
5060
+ * The name of the configuration policy.
5061
+ * </p>
5062
+ */
5063
+ Name: string | undefined;
5064
+ /**
5065
+ * @public
5066
+ * <p>
5067
+ * The description of the configuration policy.
5068
+ * </p>
5069
+ */
5070
+ Description?: string;
5071
+ /**
5072
+ * @public
5073
+ * <p>
5074
+ * An object that defines how Security Hub is configured. It includes whether Security Hub is enabled or
5075
+ * 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.
5076
+ * If you provide a list of security controls that are enabled in the configuration policy, Security Hub disables all other controls (including newly
5077
+ * released controls). If you provide a list of security controls that are disabled in the configuration policy, Security Hub
5078
+ * enables all other controls (including newly released controls).
5079
+ * </p>
5080
+ */
5081
+ ConfigurationPolicy: Policy | undefined;
5082
+ /**
5083
+ * @public
5084
+ * <p>
5085
+ * User-defined tags associated with a configuration policy. For more information, see
5086
+ * <a href="https://docs.aws.amazon.com/securityhub/latest/userguide/tagging-resources.html">Tagging Security Hub resources</a>
5087
+ * in the <i>Security Hub user guide</i>.
5088
+ * </p>
5089
+ */
5090
+ Tags?: Record<string, string>;
5091
+ }
5092
+ /**
5093
+ * @public
5094
+ */
5095
+ export interface CreateConfigurationPolicyResponse {
5096
+ /**
5097
+ * @public
5098
+ * <p>
5099
+ * The Amazon Resource Name (ARN) of the configuration policy.
5100
+ * </p>
5101
+ */
5102
+ Arn?: string;
5103
+ /**
5104
+ * @public
5105
+ * <p>
5106
+ * The universally unique identifier (UUID) of the configuration policy.
5107
+ * </p>
5108
+ */
5109
+ Id?: string;
5110
+ /**
5111
+ * @public
5112
+ * <p>
5113
+ * The name of the configuration policy.
5114
+ * </p>
5115
+ */
5116
+ Name?: string;
5117
+ /**
5118
+ * @public
5119
+ * <p>
5120
+ * The description of the configuration policy.
5121
+ * </p>
5122
+ */
5123
+ Description?: string;
5124
+ /**
5125
+ * @public
5126
+ * <p>
5127
+ * The date and time, in UTC and ISO 8601 format, that the configuration policy was last updated.
5128
+ * </p>
5129
+ */
5130
+ UpdatedAt?: Date;
5131
+ /**
5132
+ * @public
5133
+ * <p>
5134
+ * The date and time, in UTC and ISO 8601 format, that the configuration policy was created.
5135
+ * </p>
5136
+ */
5137
+ CreatedAt?: Date;
5138
+ /**
5139
+ * @public
5140
+ * <p>
5141
+ * An object that defines how Security Hub is configured. It includes whether Security Hub is enabled or disabled, a
5142
+ * list of enabled security standards, a list of enabled or disabled security controls, and a list of custom parameter values for specified controls.
5143
+ * If the request included a list of security controls that are enabled in the configuration policy, Security Hub disables all other controls (including newly
5144
+ * released controls). If the request included a list of security controls that are disabled in the configuration policy,
5145
+ * Security Hub enables all other controls (including newly released controls).
5146
+ * </p>
5147
+ */
5148
+ ConfigurationPolicy?: Policy;
5149
+ }
5150
+ /**
5151
+ * @public
5152
+ */
5153
+ export interface CreateFindingAggregatorRequest {
5154
+ /**
5155
+ * @public
5156
+ * <p>Indicates whether to aggregate findings from all of the available Regions in the current partition. Also determines whether to automatically aggregate findings from new Regions as Security Hub supports them and you opt into them.</p>
5157
+ * <p>The selected option also determines how to use the Regions provided in the Regions list.</p>
4572
5158
  * <p>The options are as follows:</p>
4573
5159
  * <ul>
4574
5160
  * <li>
@@ -4746,6 +5332,23 @@ export interface DeleteActionTargetResponse {
4746
5332
  */
4747
5333
  ActionTargetArn: string | undefined;
4748
5334
  }
5335
+ /**
5336
+ * @public
5337
+ */
5338
+ export interface DeleteConfigurationPolicyRequest {
5339
+ /**
5340
+ * @public
5341
+ * <p>
5342
+ * The Amazon Resource Name (ARN) or universally unique identifier (UUID) of the configuration policy.
5343
+ * </p>
5344
+ */
5345
+ Identifier: string | undefined;
5346
+ }
5347
+ /**
5348
+ * @public
5349
+ */
5350
+ export interface DeleteConfigurationPolicyResponse {
5351
+ }
4749
5352
  /**
4750
5353
  * @public
4751
5354
  */
@@ -4915,15 +5518,88 @@ export interface DescribeHubResponse {
4915
5518
  */
4916
5519
  export interface DescribeOrganizationConfigurationRequest {
4917
5520
  }
5521
+ /**
5522
+ * @public
5523
+ * @enum
5524
+ */
5525
+ export declare const OrganizationConfigurationConfigurationType: {
5526
+ readonly CENTRAL: "CENTRAL";
5527
+ readonly LOCAL: "LOCAL";
5528
+ };
5529
+ /**
5530
+ * @public
5531
+ */
5532
+ export type OrganizationConfigurationConfigurationType = (typeof OrganizationConfigurationConfigurationType)[keyof typeof OrganizationConfigurationConfigurationType];
5533
+ /**
5534
+ * @public
5535
+ * @enum
5536
+ */
5537
+ export declare const OrganizationConfigurationStatus: {
5538
+ readonly ENABLED: "ENABLED";
5539
+ readonly FAILED: "FAILED";
5540
+ readonly PENDING: "PENDING";
5541
+ };
5542
+ /**
5543
+ * @public
5544
+ */
5545
+ export type OrganizationConfigurationStatus = (typeof OrganizationConfigurationStatus)[keyof typeof OrganizationConfigurationStatus];
5546
+ /**
5547
+ * @public
5548
+ * <p>
5549
+ * Provides information about the way an organization is configured in Security Hub.
5550
+ * </p>
5551
+ */
5552
+ export interface OrganizationConfiguration {
5553
+ /**
5554
+ * @public
5555
+ * <p>
5556
+ * Indicates whether the organization uses local or central configuration.
5557
+ * </p>
5558
+ * <p>If you use local configuration, the
5559
+ * Security Hub delegated administrator can set <code>AutoEnable</code> to <code>true</code> and
5560
+ * <code>AutoEnableStandards</code> to <code>DEFAULT</code>. This automatically enables Security Hub and
5561
+ * default security standards in new organization accounts. These new account settings must be set separately in
5562
+ * each Amazon Web Services Region, and settings may be different in each Region.
5563
+ * </p>
5564
+ * <p>
5565
+ * If you use central configuration, the delegated administrator can create configuration policies. Configuration
5566
+ * policies can be used to configure Security Hub, security standards, and security controls in multiple
5567
+ * accounts and Regions. If you want new organization accounts to use a specific configuration, you can create a
5568
+ * configuration policy and associate it with the root or specific organizational units (OUs). New accounts will
5569
+ * inherit the policy from the root or their assigned OU.
5570
+ * </p>
5571
+ */
5572
+ ConfigurationType?: OrganizationConfigurationConfigurationType;
5573
+ /**
5574
+ * @public
5575
+ * <p>
5576
+ * Describes whether central configuration could be enabled as the <code>ConfigurationType</code> for the
5577
+ * organization. If your <code>ConfigurationType</code> is local configuration, then the value of <code>Status</code>
5578
+ * is always <code>ENABLED</code>.
5579
+ * </p>
5580
+ */
5581
+ Status?: OrganizationConfigurationStatus;
5582
+ /**
5583
+ * @public
5584
+ * <p>
5585
+ * Provides an explanation if the value of <code>Status</code> is equal to <code>FAILED</code> when <code>ConfigurationType</code>
5586
+ * is equal to <code>CENTRAL</code>.
5587
+ * </p>
5588
+ */
5589
+ StatusMessage?: string;
5590
+ }
4918
5591
  /**
4919
5592
  * @public
4920
5593
  */
4921
5594
  export interface DescribeOrganizationConfigurationResponse {
4922
5595
  /**
4923
5596
  * @public
4924
- * <p>Whether to automatically enable Security Hub for new accounts in the organization.</p>
4925
- * <p>If set to <code>true</code>, then Security Hub is enabled for new accounts. If set to false,
4926
- * then new accounts are not added automatically.</p>
5597
+ * <p>Whether to automatically enable Security Hub in new member accounts when they join the organization.</p>
5598
+ * <p>If set to <code>true</code>, then Security Hub is automatically enabled in new accounts. If set to <code>false</code>,
5599
+ * then Security Hub isn't enabled in new accounts automatically. The default value is <code>false</code>.</p>
5600
+ * <p>If the <code>ConfigurationType</code> of your organization is set to <code>CENTRAL</code>, then this field is set
5601
+ * to <code>false</code> and can't be changed in the home Region and linked Regions. However, in that case, the delegated administrator can create a configuration
5602
+ * policy in which Security Hub is enabled and associate the policy with new organization accounts.</p>
4927
5603
  */
4928
5604
  AutoEnable?: boolean;
4929
5605
  /**
@@ -4935,13 +5611,22 @@ export interface DescribeOrganizationConfigurationResponse {
4935
5611
  /**
4936
5612
  * @public
4937
5613
  * <p>Whether to automatically enable Security Hub <a href="https://docs.aws.amazon.com/securityhub/latest/userguide/securityhub-standards-enable-disable.html">default standards</a>
4938
- * for new member accounts in the organization.</p>
4939
- * <p>The default value of this parameter is equal to <code>DEFAULT</code>.</p>
5614
+ * in new member accounts when they join the organization.</p>
4940
5615
  * <p>If equal to <code>DEFAULT</code>, then Security Hub default standards are automatically enabled for new member
4941
5616
  * accounts. If equal to <code>NONE</code>, then default standards are not automatically enabled for new member
4942
- * accounts.</p>
5617
+ * accounts. The default value of this parameter is equal to <code>DEFAULT</code>.</p>
5618
+ * <p>If the <code>ConfigurationType</code> of your organization is set to <code>CENTRAL</code>, then this field is set
5619
+ * to <code>NONE</code> and can't be changed in the home Region and linked Regions. However, in that case, the delegated administrator can create a configuration
5620
+ * policy in which specific security standards are enabled and associate the policy with new organization accounts.</p>
4943
5621
  */
4944
5622
  AutoEnableStandards?: AutoEnableStandards;
5623
+ /**
5624
+ * @public
5625
+ * <p>
5626
+ * Provides information about the way an organization is configured in Security Hub.
5627
+ * </p>
5628
+ */
5629
+ OrganizationConfiguration?: OrganizationConfiguration;
4945
5630
  }
4946
5631
  /**
4947
5632
  * @public
@@ -5559,34 +6244,172 @@ export interface GetAdministratorAccountRequest {
5559
6244
  export interface Invitation {
5560
6245
  /**
5561
6246
  * @public
5562
- * <p>The account ID of the Security Hub administrator account that the invitation was sent from.</p>
6247
+ * <p>The account ID of the Security Hub administrator account that the invitation was sent from.</p>
6248
+ */
6249
+ AccountId?: string;
6250
+ /**
6251
+ * @public
6252
+ * <p>The ID of the invitation sent to the member account.</p>
6253
+ */
6254
+ InvitationId?: string;
6255
+ /**
6256
+ * @public
6257
+ * <p>The timestamp of when the invitation was sent.</p>
6258
+ */
6259
+ InvitedAt?: Date;
6260
+ /**
6261
+ * @public
6262
+ * <p>The current status of the association between the member and administrator accounts.</p>
6263
+ */
6264
+ MemberStatus?: string;
6265
+ }
6266
+ /**
6267
+ * @public
6268
+ */
6269
+ export interface GetAdministratorAccountResponse {
6270
+ /**
6271
+ * @public
6272
+ * <p>Details about an invitation.</p>
6273
+ */
6274
+ Administrator?: Invitation;
6275
+ }
6276
+ /**
6277
+ * @public
6278
+ */
6279
+ export interface GetConfigurationPolicyRequest {
6280
+ /**
6281
+ * @public
6282
+ * <p>
6283
+ * The Amazon Resource Name (ARN) or universally unique identifier (UUID) of the configuration policy.
6284
+ * </p>
6285
+ */
6286
+ Identifier: string | undefined;
6287
+ }
6288
+ /**
6289
+ * @public
6290
+ */
6291
+ export interface GetConfigurationPolicyResponse {
6292
+ /**
6293
+ * @public
6294
+ * <p>
6295
+ * The ARN of the configuration policy.
6296
+ * </p>
6297
+ */
6298
+ Arn?: string;
6299
+ /**
6300
+ * @public
6301
+ * <p>
6302
+ * The UUID of the configuration policy.
6303
+ * </p>
6304
+ */
6305
+ Id?: string;
6306
+ /**
6307
+ * @public
6308
+ * <p>
6309
+ * The name of the configuration policy.
6310
+ * </p>
6311
+ */
6312
+ Name?: string;
6313
+ /**
6314
+ * @public
6315
+ * <p>
6316
+ * The description of the configuration policy.
6317
+ * </p>
6318
+ */
6319
+ Description?: string;
6320
+ /**
6321
+ * @public
6322
+ * <p>
6323
+ * The date and time, in UTC and ISO 8601 format, that the configuration policy was last updated.
6324
+ * </p>
6325
+ */
6326
+ UpdatedAt?: Date;
6327
+ /**
6328
+ * @public
6329
+ * <p>
6330
+ * The date and time, in UTC and ISO 8601 format, that the configuration policy was created.
6331
+ * </p>
6332
+ */
6333
+ CreatedAt?: Date;
6334
+ /**
6335
+ * @public
6336
+ * <p>
6337
+ * An object that defines how Security Hub is configured. It includes whether Security Hub is enabled or
6338
+ * 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.
6339
+ * If the policy includes a list of security controls that are enabled, Security Hub disables all other controls (including newly released controls).
6340
+ * If the policy includes a list of security controls that are disabled, Security Hub enables all other controls (including
6341
+ * newly released controls).
6342
+ * </p>
6343
+ */
6344
+ ConfigurationPolicy?: Policy;
6345
+ }
6346
+ /**
6347
+ * @public
6348
+ */
6349
+ export interface GetConfigurationPolicyAssociationRequest {
6350
+ /**
6351
+ * @public
6352
+ * <p>
6353
+ * The target account ID, organizational unit ID, or the root ID to retrieve the association for.
6354
+ * </p>
6355
+ */
6356
+ Target: Target | undefined;
6357
+ }
6358
+ /**
6359
+ * @public
6360
+ */
6361
+ export interface GetConfigurationPolicyAssociationResponse {
6362
+ /**
6363
+ * @public
6364
+ * <p>
6365
+ * The universally unique identifier (UUID) of a configuration policy. For self-managed behavior, the value is
6366
+ * <code>SELF_MANAGED_SECURITY_HUB</code>.
6367
+ * </p>
6368
+ */
6369
+ ConfigurationPolicyId?: string;
6370
+ /**
6371
+ * @public
6372
+ * <p>
6373
+ * The target account ID, organizational unit ID, or the root ID for which the association is retrieved.
6374
+ * </p>
5563
6375
  */
5564
- AccountId?: string;
6376
+ TargetId?: string;
5565
6377
  /**
5566
6378
  * @public
5567
- * <p>The ID of the invitation sent to the member account.</p>
6379
+ * <p>
6380
+ * Specifies whether the target is an Amazon Web Services account, organizational unit, or the organization root.
6381
+ * </p>
5568
6382
  */
5569
- InvitationId?: string;
6383
+ TargetType?: TargetType;
5570
6384
  /**
5571
6385
  * @public
5572
- * <p>The timestamp of when the invitation was sent.</p>
6386
+ * <p>
6387
+ * Indicates whether the association between the specified target and the configuration was directly applied by the
6388
+ * Security Hub delegated administrator or inherited from a parent.
6389
+ * </p>
5573
6390
  */
5574
- InvitedAt?: Date;
6391
+ AssociationType?: AssociationType;
5575
6392
  /**
5576
6393
  * @public
5577
- * <p>The current status of the association between the member and administrator accounts.</p>
6394
+ * <p>
6395
+ * The date and time, in UTC and ISO 8601 format, that the configuration policy association was last updated.
6396
+ * </p>
5578
6397
  */
5579
- MemberStatus?: string;
5580
- }
5581
- /**
5582
- * @public
5583
- */
5584
- export interface GetAdministratorAccountResponse {
6398
+ UpdatedAt?: Date;
5585
6399
  /**
5586
6400
  * @public
5587
- * <p>Details about an invitation.</p>
6401
+ * <p>
6402
+ * The current status of the association between the specified target and the configuration.
6403
+ * </p>
5588
6404
  */
5589
- Administrator?: Invitation;
6405
+ AssociationStatus?: ConfigurationPolicyAssociationStatus;
6406
+ /**
6407
+ * @public
6408
+ * <p>
6409
+ * The explanation for a <code>FAILED</code> value for <code>AssociationStatus</code>.
6410
+ * </p>
6411
+ */
6412
+ AssociationStatusMessage?: string;
5590
6413
  }
5591
6414
  /**
5592
6415
  * @public
@@ -6289,6 +7112,110 @@ export interface ListAutomationRulesResponse {
6289
7112
  */
6290
7113
  NextToken?: string;
6291
7114
  }
7115
+ /**
7116
+ * @public
7117
+ */
7118
+ export interface ListConfigurationPoliciesRequest {
7119
+ /**
7120
+ * @public
7121
+ * <p>
7122
+ * The NextToken value that's returned from a previous paginated <code>ListConfigurationPolicies</code> request where
7123
+ * <code>MaxResults</code> was used but the results exceeded the value of that parameter. Pagination continues from the
7124
+ * <code>MaxResults</code> was used but the results exceeded the value of that parameter. Pagination continues from the
7125
+ * end of the previous response that returned the <code>NextToken</code> value. This value is <code>null</code> when
7126
+ * there are no more results to return.
7127
+ * </p>
7128
+ */
7129
+ NextToken?: string;
7130
+ /**
7131
+ * @public
7132
+ * <p>
7133
+ * The maximum number of results that's returned by <code>ListConfigurationPolicies</code> in each page of the response.
7134
+ * When this parameter is used, <code>ListConfigurationPolicies</code> returns the specified number of results in a
7135
+ * single page and a <code>NextToken</code> response element. You can see the remaining results of the initial request
7136
+ * by sending another <code>ListConfigurationPolicies</code> request with the returned <code>NextToken</code> value. A
7137
+ * valid range for <code>MaxResults</code> is between 1 and 100.
7138
+ * </p>
7139
+ */
7140
+ MaxResults?: number;
7141
+ }
7142
+ /**
7143
+ * @public
7144
+ */
7145
+ export interface ListConfigurationPoliciesResponse {
7146
+ /**
7147
+ * @public
7148
+ * <p>
7149
+ * Provides metadata for each of your configuration policies.
7150
+ * </p>
7151
+ */
7152
+ ConfigurationPolicySummaries?: ConfigurationPolicySummary[];
7153
+ /**
7154
+ * @public
7155
+ * <p>
7156
+ * The <code>NextToken</code> value to include in the next <code>ListConfigurationPolicies</code> request. When the
7157
+ * results of a <code>ListConfigurationPolicies</code> request exceed <code>MaxResults</code>, this value can be used to
7158
+ * retrieve the next page of results. This value is <code>null</code> when there are no more results to return.
7159
+ * </p>
7160
+ */
7161
+ NextToken?: string;
7162
+ }
7163
+ /**
7164
+ * @public
7165
+ */
7166
+ export interface ListConfigurationPolicyAssociationsRequest {
7167
+ /**
7168
+ * @public
7169
+ * <p>
7170
+ * The <code>NextToken</code> value that's returned from a previous paginated <code>ListConfigurationPolicyAssociations</code>
7171
+ * request where <code>MaxResults</code> was used but the results exceeded the value of that parameter. Pagination
7172
+ * continues from the end of the previous response that returned the <code>NextToken</code> value. This value is <code>null</code>
7173
+ * when there are no more results to return.
7174
+ * </p>
7175
+ */
7176
+ NextToken?: string;
7177
+ /**
7178
+ * @public
7179
+ * <p>
7180
+ * The maximum number of results that's returned by <code>ListConfigurationPolicies</code> in each page of the response.
7181
+ * When this parameter is used, <code>ListConfigurationPolicyAssociations</code> returns the specified number of results
7182
+ * in a single page and a <code>NextToken</code> response element. You can see the remaining results of the initial
7183
+ * request by sending another <code>ListConfigurationPolicyAssociations</code> request with the returned <code>NextToken</code>
7184
+ * value. A valid range for <code>MaxResults</code> is between 1 and 100.
7185
+ * </p>
7186
+ */
7187
+ MaxResults?: number;
7188
+ /**
7189
+ * @public
7190
+ * <p>
7191
+ * Options for filtering the <code>ListConfigurationPolicyAssociations</code> response. You can filter by the Amazon Resource Name (ARN) or
7192
+ * universally unique identifier (UUID) of a configuration, <code>AssociationType</code>, or <code>AssociationStatus</code>.
7193
+ * </p>
7194
+ */
7195
+ Filters?: AssociationFilters;
7196
+ }
7197
+ /**
7198
+ * @public
7199
+ */
7200
+ export interface ListConfigurationPolicyAssociationsResponse {
7201
+ /**
7202
+ * @public
7203
+ * <p>
7204
+ * An object that contains the details of each configuration policy association that’s returned in a
7205
+ * <code>ListConfigurationPolicyAssociations</code> request.
7206
+ * </p>
7207
+ */
7208
+ ConfigurationPolicyAssociationSummaries?: ConfigurationPolicyAssociationSummary[];
7209
+ /**
7210
+ * @public
7211
+ * <p>
7212
+ * The <code>NextToken</code> value to include in the next <code>ListConfigurationPolicyAssociations</code> request. When
7213
+ * the results of a <code>ListConfigurationPolicyAssociations</code> request exceed <code>MaxResults</code>, this value
7214
+ * can be used to retrieve the next page of results. This value is <code>null</code> when there are no more results to return.
7215
+ * </p>
7216
+ */
7217
+ NextToken?: string;
7218
+ }
6292
7219
  /**
6293
7220
  * @public
6294
7221
  */
@@ -6587,12 +7514,12 @@ export interface StandardsControlAssociationSummary {
6587
7514
  RelatedRequirements?: string[];
6588
7515
  /**
6589
7516
  * @public
6590
- * <p> The last time that a control's enablement status in a specified standard was updated. </p>
7517
+ * <p>The last time that a control's enablement status in a specified standard was updated.</p>
6591
7518
  */
6592
7519
  UpdatedAt?: Date;
6593
7520
  /**
6594
7521
  * @public
6595
- * <p> The reason for updating the control's enablement status in a specified standard. </p>
7522
+ * <p>The reason for updating a control's enablement status in a specified standard.</p>
6596
7523
  */
6597
7524
  UpdatedReason?: string;
6598
7525
  /**
@@ -6665,6 +7592,104 @@ export declare class ResourceInUseException extends __BaseException {
6665
7592
  */
6666
7593
  constructor(opts: __ExceptionOptionType<ResourceInUseException, __BaseException>);
6667
7594
  }
7595
+ /**
7596
+ * @public
7597
+ */
7598
+ export interface StartConfigurationPolicyAssociationRequest {
7599
+ /**
7600
+ * @public
7601
+ * <p>
7602
+ * The Amazon Resource Name (ARN) or universally unique identifier (UUID) of the configuration policy.
7603
+ * </p>
7604
+ */
7605
+ ConfigurationPolicyIdentifier: string | undefined;
7606
+ /**
7607
+ * @public
7608
+ * <p>
7609
+ * The identifier of the target account, organizational unit, or the root to associate with the specified configuration.
7610
+ * </p>
7611
+ */
7612
+ Target: Target | undefined;
7613
+ }
7614
+ /**
7615
+ * @public
7616
+ */
7617
+ export interface StartConfigurationPolicyAssociationResponse {
7618
+ /**
7619
+ * @public
7620
+ * <p>
7621
+ * The UUID of the configuration policy.
7622
+ * </p>
7623
+ */
7624
+ ConfigurationPolicyId?: string;
7625
+ /**
7626
+ * @public
7627
+ * <p>
7628
+ * The identifier of the target account, organizational unit, or the organization root with which the configuration is associated.
7629
+ * </p>
7630
+ */
7631
+ TargetId?: string;
7632
+ /**
7633
+ * @public
7634
+ * <p>
7635
+ * Indicates whether the target is an Amazon Web Services account, organizational unit, or the organization root.
7636
+ * </p>
7637
+ */
7638
+ TargetType?: TargetType;
7639
+ /**
7640
+ * @public
7641
+ * <p>
7642
+ * Indicates whether the association between the specified target and the configuration was directly applied by the
7643
+ * Security Hub delegated administrator or inherited from a parent.
7644
+ * </p>
7645
+ */
7646
+ AssociationType?: AssociationType;
7647
+ /**
7648
+ * @public
7649
+ * <p>
7650
+ * The date and time, in UTC and ISO 8601 format, that the configuration policy association was last updated.
7651
+ * </p>
7652
+ */
7653
+ UpdatedAt?: Date;
7654
+ /**
7655
+ * @public
7656
+ * <p>
7657
+ * The current status of the association between the specified target and the configuration.
7658
+ * </p>
7659
+ */
7660
+ AssociationStatus?: ConfigurationPolicyAssociationStatus;
7661
+ /**
7662
+ * @public
7663
+ * <p>
7664
+ * An explanation for a <code>FAILED</code> value for <code>AssociationStatus</code>.
7665
+ * </p>
7666
+ */
7667
+ AssociationStatusMessage?: string;
7668
+ }
7669
+ /**
7670
+ * @public
7671
+ */
7672
+ export interface StartConfigurationPolicyDisassociationRequest {
7673
+ /**
7674
+ * @public
7675
+ * <p>
7676
+ * The identifier of the target account, organizational unit, or the root to disassociate from the specified configuration.
7677
+ * </p>
7678
+ */
7679
+ Target?: Target;
7680
+ /**
7681
+ * @public
7682
+ * <p>
7683
+ * The Amazon Resource Name (ARN) or universally unique identifier (UUID) of the configuration policy.
7684
+ * </p>
7685
+ */
7686
+ ConfigurationPolicyIdentifier: string | undefined;
7687
+ }
7688
+ /**
7689
+ * @public
7690
+ */
7691
+ export interface StartConfigurationPolicyDisassociationResponse {
7692
+ }
6668
7693
  /**
6669
7694
  * @public
6670
7695
  */
@@ -6730,6 +7755,110 @@ export interface UpdateActionTargetRequest {
6730
7755
  */
6731
7756
  export interface UpdateActionTargetResponse {
6732
7757
  }
7758
+ /**
7759
+ * @public
7760
+ */
7761
+ export interface UpdateConfigurationPolicyRequest {
7762
+ /**
7763
+ * @public
7764
+ * <p>
7765
+ * The Amazon Resource Name (ARN) or universally unique identifier (UUID) of the configuration policy.
7766
+ * </p>
7767
+ */
7768
+ Identifier: string | undefined;
7769
+ /**
7770
+ * @public
7771
+ * <p>
7772
+ * The name of the configuration policy.
7773
+ * </p>
7774
+ */
7775
+ Name?: string;
7776
+ /**
7777
+ * @public
7778
+ * <p>
7779
+ * The description of the configuration policy.
7780
+ * </p>
7781
+ */
7782
+ Description?: string;
7783
+ /**
7784
+ * @public
7785
+ * <p>
7786
+ * The reason for updating the configuration policy.
7787
+ * </p>
7788
+ */
7789
+ UpdatedReason?: string;
7790
+ /**
7791
+ * @public
7792
+ * <p>
7793
+ * An object that defines how Security Hub is configured. It includes whether Security Hub is enabled or
7794
+ * 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.
7795
+ * If you provide a list of security controls that are enabled in the configuration policy, Security Hub disables all other controls (including newly
7796
+ * released controls). If you provide a list of security controls that are disabled in the configuration policy, Security Hub
7797
+ * enables all other controls (including newly released controls).
7798
+ * </p>
7799
+ * <p>When updating a configuration policy, provide a complete list of standards that you want to enable and a complete list
7800
+ * of controls that you want to enable or disable. The updated configuration replaces the current configuration.</p>
7801
+ */
7802
+ ConfigurationPolicy?: Policy;
7803
+ }
7804
+ /**
7805
+ * @public
7806
+ */
7807
+ export interface UpdateConfigurationPolicyResponse {
7808
+ /**
7809
+ * @public
7810
+ * <p>
7811
+ * The ARN of the configuration policy.
7812
+ * </p>
7813
+ */
7814
+ Arn?: string;
7815
+ /**
7816
+ * @public
7817
+ * <p>
7818
+ * The UUID of the configuration policy.
7819
+ * </p>
7820
+ */
7821
+ Id?: string;
7822
+ /**
7823
+ * @public
7824
+ * <p>
7825
+ * The name of the configuration policy.
7826
+ * </p>
7827
+ */
7828
+ Name?: string;
7829
+ /**
7830
+ * @public
7831
+ * <p>
7832
+ * The description of the configuration policy.
7833
+ * </p>
7834
+ */
7835
+ Description?: string;
7836
+ /**
7837
+ * @public
7838
+ * <p>
7839
+ * The date and time, in UTC and ISO 8601 format, that the configuration policy was last updated.
7840
+ * </p>
7841
+ */
7842
+ UpdatedAt?: Date;
7843
+ /**
7844
+ * @public
7845
+ * <p>
7846
+ * The date and time, in UTC and ISO 8601 format, that the configuration policy was created.
7847
+ * </p>
7848
+ */
7849
+ CreatedAt?: Date;
7850
+ /**
7851
+ * @public
7852
+ * <p>
7853
+ * An object that defines how Security Hub is configured. It includes whether Security Hub is enabled or
7854
+ * 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 the request included a
7855
+ * list of security controls that are enabled in the configuration policy, Security Hub disables all other controls (including
7856
+ * newly released controls). If the request included a list of security controls that are disabled in the configuration policy,
7857
+ * Security Hub enables all other controls (including newly released controls).
7858
+ * </p>
7859
+ */
7860
+ ConfigurationPolicy?: Policy;
7861
+ }
6733
7862
  /**
6734
7863
  * @public
6735
7864
  */
@@ -6856,20 +7985,34 @@ export interface UpdateInsightResponse {
6856
7985
  export interface UpdateOrganizationConfigurationRequest {
6857
7986
  /**
6858
7987
  * @public
6859
- * <p>Whether to automatically enable Security Hub for new accounts in the organization.</p>
6860
- * <p>By default, this is <code>false</code>, and new accounts are not added
6861
- * automatically.</p>
6862
- * <p>To automatically enable Security Hub for new accounts, set this to <code>true</code>.</p>
7988
+ * <p>Whether to automatically enable Security Hub in new member accounts when they join the organization.</p>
7989
+ * <p>If set to <code>true</code>, then Security Hub is automatically enabled in new accounts. If set to <code>false</code>,
7990
+ * then Security Hub isn't enabled in new accounts automatically. The default value is <code>false</code>.</p>
7991
+ * <p>If the <code>ConfigurationType</code> of your organization is set to <code>CENTRAL</code>, then this field is set
7992
+ * to <code>false</code> and can't be changed in the home Region and linked Regions. However, in that case, the delegated administrator can create a configuration
7993
+ * policy in which Security Hub is enabled and associate the policy with new organization accounts.</p>
6863
7994
  */
6864
7995
  AutoEnable: boolean | undefined;
6865
7996
  /**
6866
7997
  * @public
6867
7998
  * <p>Whether to automatically enable Security Hub <a href="https://docs.aws.amazon.com/securityhub/latest/userguide/securityhub-standards-enable-disable.html">default standards</a>
6868
- * for new member accounts in the organization.</p>
6869
- * <p>By default, this parameter is equal to <code>DEFAULT</code>, and new member accounts are automatically enabled with default Security Hub standards.</p>
6870
- * <p>To opt out of enabling default standards for new member accounts, set this parameter equal to <code>NONE</code>.</p>
7999
+ * in new member accounts when they join the organization.</p>
8000
+ * <p>The default value of this parameter is equal to <code>DEFAULT</code>.</p>
8001
+ * <p>If equal to <code>DEFAULT</code>, then Security Hub default standards are automatically enabled for new member
8002
+ * accounts. If equal to <code>NONE</code>, then default standards are not automatically enabled for new member
8003
+ * accounts.</p>
8004
+ * <p>If the <code>ConfigurationType</code> of your organization is set to <code>CENTRAL</code>, then this field is set
8005
+ * to <code>NONE</code> and can't be changed in the home Region and linked Regions. However, in that case, the delegated administrator can create a configuration
8006
+ * policy in which specific security standards are enabled and associate the policy with new organization accounts.</p>
6871
8007
  */
6872
8008
  AutoEnableStandards?: AutoEnableStandards;
8009
+ /**
8010
+ * @public
8011
+ * <p>
8012
+ * Provides information about the way an organization is configured in Security Hub.
8013
+ * </p>
8014
+ */
8015
+ OrganizationConfiguration?: OrganizationConfiguration;
6873
8016
  }
6874
8017
  /**
6875
8018
  * @public