@aws-sdk/client-securityhub 3.370.0 → 3.377.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.
@@ -1,4 +1,113 @@
1
- import { Action, Adjustment, AssociatedStandard, AvailabilityZone, AwsAmazonMqBrokerDetails, AwsApiGatewayRestApiDetails, AwsApiGatewayStageDetails, AwsApiGatewayV2ApiDetails, AwsApiGatewayV2StageDetails, AwsAppSyncGraphQlApiDetails, AwsAutoScalingAutoScalingGroupDetails, AwsAutoScalingLaunchConfigurationDetails, AwsBackupBackupPlanDetails, AwsBackupBackupVaultDetails, AwsBackupRecoveryPointDetails, AwsCertificateManagerCertificateDetails, AwsCloudFormationStackDetails, AwsCloudFrontDistributionDetails, AwsCloudTrailTrailDetails, AwsCloudWatchAlarmDetails, AwsCodeBuildProjectDetails, AwsDynamoDbTableDetails, AwsEc2EipDetails, AwsEc2InstanceDetails, AwsEc2LaunchTemplateDetails, AwsEc2NetworkAclDetails, AwsEc2NetworkInterfaceDetails, AwsEc2RouteTableDetails, AwsEc2SecurityGroupDetails, AwsEc2SubnetDetails, AwsEc2TransitGatewayDetails, AwsEc2VolumeDetails, AwsEc2VpcDetails, AwsEc2VpcEndpointServiceDetails, AwsEc2VpcPeeringConnectionDetails, AwsEc2VpnConnectionDetails, AwsEcrContainerImageDetails, AwsEcrRepositoryDetails, AwsEcsClusterDetails, AwsEcsContainerDetails, AwsEcsServiceDetails, AwsEcsTaskDefinitionDetails, AwsEcsTaskDetails, AwsEfsAccessPointDetails, AwsEksClusterLoggingDetails, DateFilter, MapFilter, NumberFilter, RelatedFinding, SeverityLabel, StringFilter, VerificationState, WorkflowStatus } from "./models_0";
1
+ import { Adjustment, AssociatedStandard, AvailabilityZone, AwsAmazonMqBrokerDetails, AwsApiGatewayRestApiDetails, AwsApiGatewayStageDetails, AwsApiGatewayV2ApiDetails, AwsApiGatewayV2StageDetails, AwsAppSyncGraphQlApiDetails, AwsAthenaWorkGroupDetails, AwsAutoScalingAutoScalingGroupDetails, AwsAutoScalingLaunchConfigurationDetails, AwsBackupBackupPlanDetails, AwsBackupBackupVaultDetails, AwsBackupRecoveryPointDetails, AwsCertificateManagerCertificateDetails, AwsCloudFormationStackDetails, AwsCloudFrontDistributionDetails, AwsCloudTrailTrailDetails, AwsCloudWatchAlarmDetails, AwsCodeBuildProjectDetails, AwsDynamoDbTableDetails, AwsEc2EipDetails, AwsEc2InstanceDetails, AwsEc2LaunchTemplateDetails, AwsEc2NetworkAclDetails, AwsEc2NetworkInterfaceDetails, AwsEc2RouteTableDetails, AwsEc2SecurityGroupDetails, AwsEc2SubnetDetails, AwsEc2TransitGatewayDetails, AwsEc2VolumeDetails, AwsEc2VpcDetails, AwsEc2VpcEndpointServiceDetails, AwsEc2VpcPeeringConnectionDetails, AwsEc2VpnConnectionDetails, AwsEcrContainerImageDetails, AwsEcrRepositoryDetails, AwsEcsClusterDetails, AwsEcsContainerDetails, AwsEcsServiceDetails, AwsEcsTaskDefinitionDetails, AwsEcsTaskDetails, AwsEfsAccessPointPosixUserDetails, AwsEfsAccessPointRootDirectoryCreationInfoDetails, RelatedFinding, SeverityLabel, WorkflowStatus } from "./models_0";
2
+ /**
3
+ * @public
4
+ * <p>Provides information about the directory on the Amazon EFS file system that the access point exposes
5
+ * as the root directory to NFS clients using the access point.
6
+ * </p>
7
+ */
8
+ export interface AwsEfsAccessPointRootDirectoryDetails {
9
+ /**
10
+ * <p>Specifies the POSIX IDs and permissions to apply to the access point's root directory.
11
+ * </p>
12
+ */
13
+ CreationInfo?: AwsEfsAccessPointRootDirectoryCreationInfoDetails;
14
+ /**
15
+ * <p>Specifies the path on the Amazon EFS file system to expose as the root directory to NFS clients
16
+ * using the access point to access the EFS file system. A path can have up to four subdirectories. If the specified
17
+ * path does not exist, you are required to provide <code>CreationInfo</code>.
18
+ * </p>
19
+ */
20
+ Path?: string;
21
+ }
22
+ /**
23
+ * @public
24
+ * <p>Provides information about an Amazon EFS access point.
25
+ * </p>
26
+ */
27
+ export interface AwsEfsAccessPointDetails {
28
+ /**
29
+ * <p>The ID of the Amazon EFS access point.
30
+ * </p>
31
+ */
32
+ AccessPointId?: string;
33
+ /**
34
+ * <p>The Amazon Resource Name (ARN) of the Amazon EFS access point. </p>
35
+ */
36
+ Arn?: string;
37
+ /**
38
+ * <p>The opaque string specified in the request to ensure idempotent creation.
39
+ * </p>
40
+ */
41
+ ClientToken?: string;
42
+ /**
43
+ * <p>The ID of the Amazon EFS file system that the access point applies to.
44
+ * </p>
45
+ */
46
+ FileSystemId?: string;
47
+ /**
48
+ * <p>The full POSIX identity, including the user ID, group ID, and secondary group IDs on the access point,
49
+ * that is used for all file operations by NFS clients using the access point.
50
+ * </p>
51
+ */
52
+ PosixUser?: AwsEfsAccessPointPosixUserDetails;
53
+ /**
54
+ * <p>The directory on the Amazon EFS file system that the access point exposes as the root
55
+ * directory to NFS clients using the access point.
56
+ * </p>
57
+ */
58
+ RootDirectory?: AwsEfsAccessPointRootDirectoryDetails;
59
+ }
60
+ /**
61
+ * @public
62
+ * <p>Details for a cluster logging configuration.</p>
63
+ */
64
+ export interface AwsEksClusterLoggingClusterLoggingDetails {
65
+ /**
66
+ * <p>Whether the logging types that are listed in <code>Types</code> are enabled.</p>
67
+ */
68
+ Enabled?: boolean;
69
+ /**
70
+ * <p>A list of logging types. Valid values are as follows:</p>
71
+ * <ul>
72
+ * <li>
73
+ * <p>
74
+ * <code>api</code>
75
+ * </p>
76
+ * </li>
77
+ * <li>
78
+ * <p>
79
+ * <code>audit</code>
80
+ * </p>
81
+ * </li>
82
+ * <li>
83
+ * <p>
84
+ * <code>authenticator</code>
85
+ * </p>
86
+ * </li>
87
+ * <li>
88
+ * <p>
89
+ * <code>controllerManager</code>
90
+ * </p>
91
+ * </li>
92
+ * <li>
93
+ * <p>
94
+ * <code>scheduler</code>
95
+ * </p>
96
+ * </li>
97
+ * </ul>
98
+ */
99
+ Types?: string[];
100
+ }
101
+ /**
102
+ * @public
103
+ * <p>The logging configuration for an Amazon EKS cluster.</p>
104
+ */
105
+ export interface AwsEksClusterLoggingDetails {
106
+ /**
107
+ * <p>Cluster logging configurations.</p>
108
+ */
109
+ ClusterLogging?: AwsEksClusterLoggingClusterLoggingDetails[];
110
+ }
2
111
  /**
3
112
  * @public
4
113
  * <p>Information about the VPC configuration used by the cluster control plane.</p>
@@ -3259,6 +3368,30 @@ export interface AwsRdsDbClusterDetails {
3259
3368
  */
3260
3369
  IamDatabaseAuthenticationEnabled?: boolean;
3261
3370
  }
3371
+ /**
3372
+ * @public
3373
+ * <p>
3374
+ * Contains the name and values of a manual Amazon Relational Database Service (RDS) DB cluster snapshot attribute.
3375
+ * </p>
3376
+ */
3377
+ export interface AwsRdsDbClusterSnapshotDbClusterSnapshotAttribute {
3378
+ /**
3379
+ * <p>
3380
+ * The name of the manual DB cluster snapshot attribute. The attribute named <code>restore</code> refers to the list of
3381
+ * Amazon Web Services accounts that have permission to copy or restore the manual DB cluster snapshot.
3382
+ * </p>
3383
+ */
3384
+ AttributeName?: string;
3385
+ /**
3386
+ * <p>
3387
+ * The value(s) for the manual DB cluster snapshot attribute. If the <code>AttributeName</code> field is set to
3388
+ * <code>restore</code>, then this element returns a list of IDs of the Amazon Web Services accounts that are authorized
3389
+ * to copy or restore the manual DB cluster snapshot. If a value of <code>all</code> is in the list, then the manual
3390
+ * DB cluster snapshot is public and available for any Amazon Web Services account to copy or restore.
3391
+ * </p>
3392
+ */
3393
+ AttributeValues?: string[];
3394
+ }
3262
3395
  /**
3263
3396
  * @public
3264
3397
  * <p>Information about an Amazon RDS DB cluster snapshot.</p>
@@ -3343,6 +3476,12 @@ export interface AwsRdsDbClusterSnapshotDetails {
3343
3476
  * <p>Whether mapping of IAM accounts to database accounts is enabled.</p>
3344
3477
  */
3345
3478
  IamDatabaseAuthenticationEnabled?: boolean;
3479
+ /**
3480
+ * <p>
3481
+ * Contains the name and values of a manual DB cluster snapshot attribute.
3482
+ * </p>
3483
+ */
3484
+ DbClusterSnapshotAttributes?: AwsRdsDbClusterSnapshotDbClusterSnapshotAttribute[];
3346
3485
  }
3347
3486
  /**
3348
3487
  * @public
@@ -8338,6 +8477,13 @@ export interface ResourceDetails {
8338
8477
  * </p>
8339
8478
  */
8340
8479
  AwsStepFunctionStateMachine?: AwsStepFunctionStateMachineDetails;
8480
+ /**
8481
+ * <p>
8482
+ * Provides information about an Amazon Athena workgroup. A workgroup helps you separate users, teams,
8483
+ * applications, or workloads. It also helps you set limits on data processing and track costs.
8484
+ * </p>
8485
+ */
8486
+ AwsAthenaWorkGroup?: AwsAthenaWorkGroupDetails;
8341
8487
  }
8342
8488
  /**
8343
8489
  * @public
@@ -8865,781 +9011,3 @@ export declare const WorkflowState: {
8865
9011
  * @public
8866
9012
  */
8867
9013
  export type WorkflowState = (typeof WorkflowState)[keyof typeof WorkflowState];
8868
- /**
8869
- * @public
8870
- * <p>Provides a consistent format for Security Hub findings.
8871
- * <code>AwsSecurityFinding</code> format allows you to share findings between Amazon Web Services
8872
- * security services and third-party solutions.</p>
8873
- * <note>
8874
- * <p>A finding is a potential security issue generated either by Amazon Web Services services or by the integrated third-party
8875
- * solutions and standards checks.</p>
8876
- * </note>
8877
- */
8878
- export interface AwsSecurityFinding {
8879
- /**
8880
- * <p>The schema version that a finding is formatted for.</p>
8881
- */
8882
- SchemaVersion: string | undefined;
8883
- /**
8884
- * <p>The security findings provider-specific identifier for a finding.</p>
8885
- */
8886
- Id: string | undefined;
8887
- /**
8888
- * <p>The ARN generated by Security Hub that uniquely identifies a product that generates findings.
8889
- * This can be the ARN for a third-party product that is integrated with Security Hub, or the ARN for
8890
- * a custom integration.</p>
8891
- */
8892
- ProductArn: string | undefined;
8893
- /**
8894
- * <p>The name of the product that generated the finding.</p>
8895
- * <p>Security Hub populates this attribute automatically for each finding. You cannot update this attribute with <code>BatchImportFindings</code> or <code>BatchUpdateFindings</code>. The exception to this is a custom integration.</p>
8896
- * <p>When you use the Security Hub console or API to filter findings by product name, you use this attribute.</p>
8897
- */
8898
- ProductName?: string;
8899
- /**
8900
- * <p>The name of the company for the product that generated the finding.</p>
8901
- * <p>Security Hub populates this attribute automatically for each finding. You cannot update this attribute with <code>BatchImportFindings</code> or <code>BatchUpdateFindings</code>. The exception to this is a custom integration.</p>
8902
- * <p>When you use the Security Hub console or API to filter findings by company name, you use this attribute.</p>
8903
- */
8904
- CompanyName?: string;
8905
- /**
8906
- * <p>The Region from which the finding was generated.</p>
8907
- * <p>Security Hub populates this attribute automatically for each finding. You cannot update it using <code>BatchImportFindings</code> or <code>BatchUpdateFindings</code>.</p>
8908
- */
8909
- Region?: string;
8910
- /**
8911
- * <p>The identifier for the solution-specific component (a discrete unit of logic) that
8912
- * generated a finding. In various security findings providers' solutions, this generator can
8913
- * be called a rule, a check, a detector, a plugin, etc. </p>
8914
- */
8915
- GeneratorId: string | undefined;
8916
- /**
8917
- * <p>The Amazon Web Services account ID that a finding is generated in.</p>
8918
- */
8919
- AwsAccountId: string | undefined;
8920
- /**
8921
- * <p>One or more finding types in the format of <code>namespace/category/classifier</code>
8922
- * that classify a finding.</p>
8923
- * <p>Valid namespace values are: Software and Configuration Checks | TTPs | Effects | Unusual
8924
- * Behaviors | Sensitive Data Identifications</p>
8925
- */
8926
- Types?: string[];
8927
- /**
8928
- * <p>Indicates when the security findings provider first observed the potential security
8929
- * issue that a finding captured.</p>
8930
- * <p>Uses the <code>date-time</code> format specified in <a href="https://tools.ietf.org/html/rfc3339#section-5.6">RFC 3339 section 5.6, Internet
8931
- * Date/Time Format</a>. The value cannot contain spaces, and date and time should be separated by <code>T</code>. For example,
8932
- * <code>2020-03-22T13:22:13.933Z</code>.</p>
8933
- */
8934
- FirstObservedAt?: string;
8935
- /**
8936
- * <p>Indicates when the security findings provider most recently observed the potential
8937
- * security issue that a finding captured.</p>
8938
- * <p>Uses the <code>date-time</code> format specified in <a href="https://tools.ietf.org/html/rfc3339#section-5.6">RFC 3339 section 5.6, Internet
8939
- * Date/Time Format</a>. The value cannot contain spaces, and date and time should be separated by <code>T</code>. For example,
8940
- * <code>2020-03-22T13:22:13.933Z</code>.</p>
8941
- */
8942
- LastObservedAt?: string;
8943
- /**
8944
- * <p>Indicates when the security findings provider created the potential security issue that
8945
- * a finding captured.</p>
8946
- * <p>Uses the <code>date-time</code> format specified in <a href="https://tools.ietf.org/html/rfc3339#section-5.6">RFC 3339 section 5.6, Internet
8947
- * Date/Time Format</a>. The value cannot contain spaces, and date and time should be separated by <code>T</code>. For example,
8948
- * <code>2020-03-22T13:22:13.933Z</code>.</p>
8949
- */
8950
- CreatedAt: string | undefined;
8951
- /**
8952
- * <p>Indicates when the security findings provider last updated the finding record.</p>
8953
- * <p>Uses the <code>date-time</code> format specified in <a href="https://tools.ietf.org/html/rfc3339#section-5.6">RFC 3339 section 5.6, Internet
8954
- * Date/Time Format</a>. The value cannot contain spaces, and date and time should be separated by <code>T</code>. For example,
8955
- * <code>2020-03-22T13:22:13.933Z</code>.</p>
8956
- */
8957
- UpdatedAt: string | undefined;
8958
- /**
8959
- * <p>A finding's severity.</p>
8960
- */
8961
- Severity?: Severity;
8962
- /**
8963
- * <p>A finding's confidence. Confidence is defined as the likelihood that a finding
8964
- * accurately identifies the behavior or issue that it was intended to identify.</p>
8965
- * <p>Confidence is scored on a 0-100 basis using a ratio scale, where 0 means zero percent
8966
- * confidence and 100 means 100 percent confidence.</p>
8967
- */
8968
- Confidence?: number;
8969
- /**
8970
- * <p>The level of importance assigned to the resources associated with the finding.</p>
8971
- * <p>A score of 0 means that the underlying resources have no criticality, and a score of 100
8972
- * is reserved for the most critical resources.</p>
8973
- */
8974
- Criticality?: number;
8975
- /**
8976
- * <p>A finding's title.</p>
8977
- * <note>
8978
- * <p>In this release, <code>Title</code> is a required property.</p>
8979
- * </note>
8980
- */
8981
- Title: string | undefined;
8982
- /**
8983
- * <p>A finding's description.</p>
8984
- * <note>
8985
- * <p>In this release, <code>Description</code> is a required property.</p>
8986
- * </note>
8987
- */
8988
- Description: string | undefined;
8989
- /**
8990
- * <p>A data type that describes the remediation options for a finding.</p>
8991
- */
8992
- Remediation?: Remediation;
8993
- /**
8994
- * <p>A URL that links to a page about the current finding in the security findings provider's
8995
- * solution.</p>
8996
- */
8997
- SourceUrl?: string;
8998
- /**
8999
- * <p>A data type where security findings providers can include additional solution-specific
9000
- * details that aren't part of the defined <code>AwsSecurityFinding</code> format.</p>
9001
- * <p>Can contain up to 50 key-value pairs. For each key-value pair, the key can contain up to 128 characters, and the value can contain up to 2048 characters.</p>
9002
- */
9003
- ProductFields?: Record<string, string>;
9004
- /**
9005
- * <p>A list of name/value string pairs associated with the finding. These are custom,
9006
- * user-defined fields added to a finding. </p>
9007
- */
9008
- UserDefinedFields?: Record<string, string>;
9009
- /**
9010
- * <p>A list of malware related to a finding.</p>
9011
- */
9012
- Malware?: Malware[];
9013
- /**
9014
- * <p>The details of network-related information about a finding.</p>
9015
- */
9016
- Network?: Network;
9017
- /**
9018
- * <p>Provides information about a network path that is relevant to a finding. Each entry
9019
- * under <code>NetworkPath</code> represents a component of that path.</p>
9020
- */
9021
- NetworkPath?: NetworkPathComponent[];
9022
- /**
9023
- * <p>The details of process-related information about a finding.</p>
9024
- */
9025
- Process?: ProcessDetails;
9026
- /**
9027
- * <p>Details about the threat detected in a security finding and the file paths that were affected by the threat.
9028
- * </p>
9029
- */
9030
- Threats?: Threat[];
9031
- /**
9032
- * <p>Threat intelligence details related to a finding.</p>
9033
- */
9034
- ThreatIntelIndicators?: ThreatIntelIndicator[];
9035
- /**
9036
- * <p>A set of resource data types that describe the resources that the finding refers
9037
- * to.</p>
9038
- */
9039
- Resources: Resource[] | undefined;
9040
- /**
9041
- * <p>This data type is exclusive to findings that are generated as the result of a check run
9042
- * against a specific rule in a supported security standard, such as CIS Amazon Web Services Foundations.
9043
- * Contains security standard-related finding details.</p>
9044
- */
9045
- Compliance?: Compliance;
9046
- /**
9047
- * <p>Indicates the veracity of a finding. </p>
9048
- */
9049
- VerificationState?: VerificationState | string;
9050
- /**
9051
- * @deprecated
9052
- *
9053
- * <p>The workflow state of a finding. </p>
9054
- */
9055
- WorkflowState?: WorkflowState | string;
9056
- /**
9057
- * <p>Provides information about the status of the investigation into a finding.</p>
9058
- */
9059
- Workflow?: Workflow;
9060
- /**
9061
- * <p>The record state of a finding.</p>
9062
- */
9063
- RecordState?: RecordState | string;
9064
- /**
9065
- * <p>A list of related findings.</p>
9066
- */
9067
- RelatedFindings?: RelatedFinding[];
9068
- /**
9069
- * <p>A user-defined note added to a finding.</p>
9070
- */
9071
- Note?: Note;
9072
- /**
9073
- * <p>Provides a list of vulnerabilities associated with the findings.</p>
9074
- */
9075
- Vulnerabilities?: Vulnerability[];
9076
- /**
9077
- * <p>Provides an overview of the patch compliance status for an instance against a selected
9078
- * compliance standard.</p>
9079
- */
9080
- PatchSummary?: PatchSummary;
9081
- /**
9082
- * <p>Provides details about an action that affects or that was taken on a resource.</p>
9083
- */
9084
- Action?: Action;
9085
- /**
9086
- * <p>In a <code>BatchImportFindings</code> request, finding providers use <code>FindingProviderFields</code> to provide and update their own values for confidence, criticality, related findings, severity, and types.</p>
9087
- */
9088
- FindingProviderFields?: FindingProviderFields;
9089
- /**
9090
- * <p>Indicates whether the finding is a sample finding.</p>
9091
- */
9092
- Sample?: boolean;
9093
- }
9094
- /**
9095
- * @public
9096
- * <p>A keyword filter for querying findings.</p>
9097
- */
9098
- export interface KeywordFilter {
9099
- /**
9100
- * <p>A value for the keyword.</p>
9101
- */
9102
- Value?: string;
9103
- }
9104
- /**
9105
- * @public
9106
- * <p>The IP filter for querying findings.</p>
9107
- */
9108
- export interface IpFilter {
9109
- /**
9110
- * <p>A finding's CIDR value.</p>
9111
- */
9112
- Cidr?: string;
9113
- }
9114
- /**
9115
- * @public
9116
- * <p>Boolean filter for querying findings.</p>
9117
- */
9118
- export interface BooleanFilter {
9119
- /**
9120
- * <p>The value of the boolean.</p>
9121
- */
9122
- Value?: boolean;
9123
- }
9124
- /**
9125
- * @public
9126
- * <p>A collection of attributes that are applied to all active Security Hub-aggregated findings and
9127
- * that result in a subset of findings that are included in this insight.</p>
9128
- * <p>You can filter by up to 10 finding attributes. For each attribute, you can provide up to
9129
- * 20 filter values.</p>
9130
- */
9131
- export interface AwsSecurityFindingFilters {
9132
- /**
9133
- * <p>The ARN generated by Security Hub that uniquely identifies a third-party company
9134
- * (security findings provider) after this provider's product (solution that generates
9135
- * findings) is registered with Security Hub.</p>
9136
- */
9137
- ProductArn?: StringFilter[];
9138
- /**
9139
- * <p>The Amazon Web Services account ID that a finding is generated in.</p>
9140
- */
9141
- AwsAccountId?: StringFilter[];
9142
- /**
9143
- * <p>The security findings provider-specific identifier for a finding.</p>
9144
- */
9145
- Id?: StringFilter[];
9146
- /**
9147
- * <p>The identifier for the solution-specific component (a discrete unit of logic) that
9148
- * generated a finding. In various security findings providers' solutions, this generator can
9149
- * be called a rule, a check, a detector, a plugin, etc.</p>
9150
- */
9151
- GeneratorId?: StringFilter[];
9152
- /**
9153
- * <p>The Region from which the finding was generated.</p>
9154
- */
9155
- Region?: StringFilter[];
9156
- /**
9157
- * <p>A finding type in the format of <code>namespace/category/classifier</code> that
9158
- * classifies a finding.</p>
9159
- */
9160
- Type?: StringFilter[];
9161
- /**
9162
- * <p>An ISO8601-formatted timestamp that indicates when the security findings provider first
9163
- * observed the potential security issue that a finding captured.</p>
9164
- * <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>
9165
- */
9166
- FirstObservedAt?: DateFilter[];
9167
- /**
9168
- * <p>An ISO8601-formatted timestamp that indicates when the security findings provider most
9169
- * recently observed the potential security issue that a finding captured.</p>
9170
- * <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>
9171
- */
9172
- LastObservedAt?: DateFilter[];
9173
- /**
9174
- * <p>An ISO8601-formatted timestamp that indicates when the security findings provider
9175
- * captured the potential security issue that a finding captured.</p>
9176
- * <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>
9177
- */
9178
- CreatedAt?: DateFilter[];
9179
- /**
9180
- * <p>An ISO8601-formatted timestamp that indicates when the security findings provider last
9181
- * updated the finding record. </p>
9182
- * <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>
9183
- */
9184
- UpdatedAt?: DateFilter[];
9185
- /**
9186
- * @deprecated
9187
- *
9188
- * <p>The native severity as defined by the security findings provider's solution that
9189
- * generated the finding.</p>
9190
- */
9191
- SeverityProduct?: NumberFilter[];
9192
- /**
9193
- * @deprecated
9194
- *
9195
- * <p>The normalized severity of a finding.</p>
9196
- */
9197
- SeverityNormalized?: NumberFilter[];
9198
- /**
9199
- * <p>The label of a finding's severity.</p>
9200
- */
9201
- SeverityLabel?: StringFilter[];
9202
- /**
9203
- * <p>A finding's confidence. Confidence is defined as the likelihood that a finding
9204
- * accurately identifies the behavior or issue that it was intended to identify.</p>
9205
- * <p>Confidence is scored on a 0-100 basis using a ratio scale, where 0 means zero percent
9206
- * confidence and 100 means 100 percent confidence.</p>
9207
- */
9208
- Confidence?: NumberFilter[];
9209
- /**
9210
- * <p>The level of importance assigned to the resources associated with the finding.</p>
9211
- * <p>A score of 0 means that the underlying resources have no criticality, and a score of 100
9212
- * is reserved for the most critical resources.</p>
9213
- */
9214
- Criticality?: NumberFilter[];
9215
- /**
9216
- * <p>A finding's title.</p>
9217
- */
9218
- Title?: StringFilter[];
9219
- /**
9220
- * <p>A finding's description.</p>
9221
- */
9222
- Description?: StringFilter[];
9223
- /**
9224
- * <p>The recommendation of what to do about the issue described in a finding.</p>
9225
- */
9226
- RecommendationText?: StringFilter[];
9227
- /**
9228
- * <p>A URL that links to a page about the current finding in the security findings provider's
9229
- * solution.</p>
9230
- */
9231
- SourceUrl?: StringFilter[];
9232
- /**
9233
- * <p>A data type where security findings providers can include additional solution-specific
9234
- * details that aren't part of the defined <code>AwsSecurityFinding</code> format.</p>
9235
- */
9236
- ProductFields?: MapFilter[];
9237
- /**
9238
- * <p>The name of the solution (product) that generates findings.</p>
9239
- */
9240
- ProductName?: StringFilter[];
9241
- /**
9242
- * <p>The name of the findings provider (company) that owns the solution (product) that
9243
- * generates findings.</p>
9244
- */
9245
- CompanyName?: StringFilter[];
9246
- /**
9247
- * <p>A list of name/value string pairs associated with the finding. These are custom,
9248
- * user-defined fields added to a finding. </p>
9249
- */
9250
- UserDefinedFields?: MapFilter[];
9251
- /**
9252
- * <p>The name of the malware that was observed.</p>
9253
- */
9254
- MalwareName?: StringFilter[];
9255
- /**
9256
- * <p>The type of the malware that was observed.</p>
9257
- */
9258
- MalwareType?: StringFilter[];
9259
- /**
9260
- * <p>The filesystem path of the malware that was observed.</p>
9261
- */
9262
- MalwarePath?: StringFilter[];
9263
- /**
9264
- * <p>The state of the malware that was observed.</p>
9265
- */
9266
- MalwareState?: StringFilter[];
9267
- /**
9268
- * <p>Indicates the direction of network traffic associated with a finding.</p>
9269
- */
9270
- NetworkDirection?: StringFilter[];
9271
- /**
9272
- * <p>The protocol of network-related information about a finding.</p>
9273
- */
9274
- NetworkProtocol?: StringFilter[];
9275
- /**
9276
- * <p>The source IPv4 address of network-related information about a finding.</p>
9277
- */
9278
- NetworkSourceIpV4?: IpFilter[];
9279
- /**
9280
- * <p>The source IPv6 address of network-related information about a finding.</p>
9281
- */
9282
- NetworkSourceIpV6?: IpFilter[];
9283
- /**
9284
- * <p>The source port of network-related information about a finding.</p>
9285
- */
9286
- NetworkSourcePort?: NumberFilter[];
9287
- /**
9288
- * <p>The source domain of network-related information about a finding.</p>
9289
- */
9290
- NetworkSourceDomain?: StringFilter[];
9291
- /**
9292
- * <p>The source media access control (MAC) address of network-related information about a
9293
- * finding.</p>
9294
- */
9295
- NetworkSourceMac?: StringFilter[];
9296
- /**
9297
- * <p>The destination IPv4 address of network-related information about a finding.</p>
9298
- */
9299
- NetworkDestinationIpV4?: IpFilter[];
9300
- /**
9301
- * <p>The destination IPv6 address of network-related information about a finding.</p>
9302
- */
9303
- NetworkDestinationIpV6?: IpFilter[];
9304
- /**
9305
- * <p>The destination port of network-related information about a finding.</p>
9306
- */
9307
- NetworkDestinationPort?: NumberFilter[];
9308
- /**
9309
- * <p>The destination domain of network-related information about a finding.</p>
9310
- */
9311
- NetworkDestinationDomain?: StringFilter[];
9312
- /**
9313
- * <p>The name of the process.</p>
9314
- */
9315
- ProcessName?: StringFilter[];
9316
- /**
9317
- * <p>The path to the process executable.</p>
9318
- */
9319
- ProcessPath?: StringFilter[];
9320
- /**
9321
- * <p>The process ID.</p>
9322
- */
9323
- ProcessPid?: NumberFilter[];
9324
- /**
9325
- * <p>The parent process ID. This field accepts positive integers between <code>O</code> and <code>2147483647</code>.</p>
9326
- */
9327
- ProcessParentPid?: NumberFilter[];
9328
- /**
9329
- * <p>A timestamp that identifies when the process was launched.</p>
9330
- * <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>
9331
- */
9332
- ProcessLaunchedAt?: DateFilter[];
9333
- /**
9334
- * <p>A timestamp that identifies when the process was terminated.</p>
9335
- * <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>
9336
- */
9337
- ProcessTerminatedAt?: DateFilter[];
9338
- /**
9339
- * <p>The type of a threat intelligence indicator.</p>
9340
- */
9341
- ThreatIntelIndicatorType?: StringFilter[];
9342
- /**
9343
- * <p>The value of a threat intelligence indicator.</p>
9344
- */
9345
- ThreatIntelIndicatorValue?: StringFilter[];
9346
- /**
9347
- * <p>The category of a threat intelligence indicator.</p>
9348
- */
9349
- ThreatIntelIndicatorCategory?: StringFilter[];
9350
- /**
9351
- * <p>A timestamp that identifies the last observation of a threat intelligence indicator.</p>
9352
- */
9353
- ThreatIntelIndicatorLastObservedAt?: DateFilter[];
9354
- /**
9355
- * <p>The source of the threat intelligence.</p>
9356
- */
9357
- ThreatIntelIndicatorSource?: StringFilter[];
9358
- /**
9359
- * <p>The URL for more details from the source of the threat intelligence.</p>
9360
- */
9361
- ThreatIntelIndicatorSourceUrl?: StringFilter[];
9362
- /**
9363
- * <p>Specifies the type of the resource that details are provided for.</p>
9364
- */
9365
- ResourceType?: StringFilter[];
9366
- /**
9367
- * <p>The canonical identifier for the given resource type.</p>
9368
- */
9369
- ResourceId?: StringFilter[];
9370
- /**
9371
- * <p>The canonical Amazon Web Services partition name that the Region is assigned to.</p>
9372
- */
9373
- ResourcePartition?: StringFilter[];
9374
- /**
9375
- * <p>The canonical Amazon Web Services external Region name where this resource is located.</p>
9376
- */
9377
- ResourceRegion?: StringFilter[];
9378
- /**
9379
- * <p>A list of Amazon Web Services tags associated with a resource at the time the finding was
9380
- * processed.</p>
9381
- */
9382
- ResourceTags?: MapFilter[];
9383
- /**
9384
- * <p>The instance type of the instance.</p>
9385
- */
9386
- ResourceAwsEc2InstanceType?: StringFilter[];
9387
- /**
9388
- * <p>The Amazon Machine Image (AMI) ID of the instance.</p>
9389
- */
9390
- ResourceAwsEc2InstanceImageId?: StringFilter[];
9391
- /**
9392
- * <p>The IPv4 addresses associated with the instance.</p>
9393
- */
9394
- ResourceAwsEc2InstanceIpV4Addresses?: IpFilter[];
9395
- /**
9396
- * <p>The IPv6 addresses associated with the instance.</p>
9397
- */
9398
- ResourceAwsEc2InstanceIpV6Addresses?: IpFilter[];
9399
- /**
9400
- * <p>The key name associated with the instance.</p>
9401
- */
9402
- ResourceAwsEc2InstanceKeyName?: StringFilter[];
9403
- /**
9404
- * <p>The IAM profile ARN of the instance.</p>
9405
- */
9406
- ResourceAwsEc2InstanceIamInstanceProfileArn?: StringFilter[];
9407
- /**
9408
- * <p>The identifier of the VPC that the instance was launched in.</p>
9409
- */
9410
- ResourceAwsEc2InstanceVpcId?: StringFilter[];
9411
- /**
9412
- * <p>The identifier of the subnet that the instance was launched in.</p>
9413
- */
9414
- ResourceAwsEc2InstanceSubnetId?: StringFilter[];
9415
- /**
9416
- * <p>The date and time the instance was launched.</p>
9417
- */
9418
- ResourceAwsEc2InstanceLaunchedAt?: DateFilter[];
9419
- /**
9420
- * <p>The canonical user ID of the owner of the S3 bucket.</p>
9421
- */
9422
- ResourceAwsS3BucketOwnerId?: StringFilter[];
9423
- /**
9424
- * <p>The display name of the owner of the S3 bucket.</p>
9425
- */
9426
- ResourceAwsS3BucketOwnerName?: StringFilter[];
9427
- /**
9428
- * @deprecated
9429
- *
9430
- * <p>The user associated with the IAM access key related to a finding.</p>
9431
- */
9432
- ResourceAwsIamAccessKeyUserName?: StringFilter[];
9433
- /**
9434
- * <p>The name of the principal that is associated with an IAM access key.</p>
9435
- */
9436
- ResourceAwsIamAccessKeyPrincipalName?: StringFilter[];
9437
- /**
9438
- * <p>The status of the IAM access key related to a finding.</p>
9439
- */
9440
- ResourceAwsIamAccessKeyStatus?: StringFilter[];
9441
- /**
9442
- * <p>The creation date/time of the IAM access key related to a finding.</p>
9443
- */
9444
- ResourceAwsIamAccessKeyCreatedAt?: DateFilter[];
9445
- /**
9446
- * <p>The name of an IAM user.</p>
9447
- */
9448
- ResourceAwsIamUserUserName?: StringFilter[];
9449
- /**
9450
- * <p>The name of the container related to a finding.</p>
9451
- */
9452
- ResourceContainerName?: StringFilter[];
9453
- /**
9454
- * <p>The identifier of the image related to a finding.</p>
9455
- */
9456
- ResourceContainerImageId?: StringFilter[];
9457
- /**
9458
- * <p>The name of the image related to a finding.</p>
9459
- */
9460
- ResourceContainerImageName?: StringFilter[];
9461
- /**
9462
- * <p>A timestamp that identifies when the container was started.</p>
9463
- * <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>
9464
- */
9465
- ResourceContainerLaunchedAt?: DateFilter[];
9466
- /**
9467
- * <p>The details of a resource that doesn't have a specific subfield for the resource type
9468
- * defined.</p>
9469
- */
9470
- ResourceDetailsOther?: MapFilter[];
9471
- /**
9472
- * <p>Exclusive to findings that are generated as the result of a check run against a specific
9473
- * rule in a supported standard, such as CIS Amazon Web Services Foundations. Contains security
9474
- * standard-related finding details.</p>
9475
- */
9476
- ComplianceStatus?: StringFilter[];
9477
- /**
9478
- * <p>The veracity of a finding.</p>
9479
- */
9480
- VerificationState?: StringFilter[];
9481
- /**
9482
- * <p>The workflow state of a finding.</p>
9483
- * <p>Note that this field is deprecated. To search for a finding based on its workflow
9484
- * status, use <code>WorkflowStatus</code>.</p>
9485
- */
9486
- WorkflowState?: StringFilter[];
9487
- /**
9488
- * <p>The status of the investigation into a finding. Allowed values are the following.</p>
9489
- * <ul>
9490
- * <li>
9491
- * <p>
9492
- * <code>NEW</code> - The initial state of a finding, before it is reviewed.</p>
9493
- * <p>Security Hub also resets the workflow status from <code>NOTIFIED</code> or
9494
- * <code>RESOLVED</code> to <code>NEW</code> in the following cases:</p>
9495
- * <ul>
9496
- * <li>
9497
- * <p>
9498
- * <code>RecordState</code> changes from <code>ARCHIVED</code> to <code>ACTIVE</code>.</p>
9499
- * </li>
9500
- * <li>
9501
- * <p>
9502
- * <code>Compliance.Status</code> changes from <code>PASSED</code> to either <code>WARNING</code>,
9503
- * <code>FAILED</code>, or <code>NOT_AVAILABLE</code>.</p>
9504
- * </li>
9505
- * </ul>
9506
- * </li>
9507
- * <li>
9508
- * <p>
9509
- * <code>NOTIFIED</code> - Indicates that the resource owner has been notified about
9510
- * the security issue. Used when the initial reviewer is not the resource owner, and
9511
- * needs intervention from the resource owner.</p>
9512
- * <p>If one of the following occurs, the workflow status is changed automatically from
9513
- * <code>NOTIFIED</code> to <code>NEW</code>:</p>
9514
- * <ul>
9515
- * <li>
9516
- * <p>
9517
- * <code>RecordState</code> changes from <code>ARCHIVED</code> to
9518
- * <code>ACTIVE</code>.</p>
9519
- * </li>
9520
- * <li>
9521
- * <p>
9522
- * <code>Compliance.Status</code> changes from <code>PASSED</code> to <code>FAILED</code>,
9523
- * <code>WARNING</code>, or <code>NOT_AVAILABLE</code>.</p>
9524
- * </li>
9525
- * </ul>
9526
- * </li>
9527
- * <li>
9528
- * <p>
9529
- * <code>SUPPRESSED</code> - Indicates that you reviewed the finding and do not believe that any action is
9530
- * needed.</p>
9531
- * <p>The workflow status of a <code>SUPPRESSED</code> finding does not change if
9532
- * <code>RecordState</code> changes from <code>ARCHIVED</code> to
9533
- * <code>ACTIVE</code>.</p>
9534
- * </li>
9535
- * <li>
9536
- * <p>
9537
- * <code>RESOLVED</code> - The finding was reviewed and remediated and is now
9538
- * considered resolved. </p>
9539
- * <p>The finding remains <code>RESOLVED</code> unless one of the following occurs:</p>
9540
- * <ul>
9541
- * <li>
9542
- * <p>
9543
- * <code>RecordState</code> changes from <code>ARCHIVED</code> to
9544
- * <code>ACTIVE</code>.</p>
9545
- * </li>
9546
- * <li>
9547
- * <p>
9548
- * <code>Compliance.Status</code> changes from <code>PASSED</code> to <code>FAILED</code>,
9549
- * <code>WARNING</code>, or <code>NOT_AVAILABLE</code>.</p>
9550
- * </li>
9551
- * </ul>
9552
- * <p>In those cases, the workflow status is automatically reset to <code>NEW</code>.</p>
9553
- * <p>For findings from controls, if <code>Compliance.Status</code> is <code>PASSED</code>,
9554
- * then Security Hub automatically sets the workflow status to <code>RESOLVED</code>.</p>
9555
- * </li>
9556
- * </ul>
9557
- */
9558
- WorkflowStatus?: StringFilter[];
9559
- /**
9560
- * <p>The updated record state for the finding.</p>
9561
- */
9562
- RecordState?: StringFilter[];
9563
- /**
9564
- * <p>The ARN of the solution that generated a related finding.</p>
9565
- */
9566
- RelatedFindingsProductArn?: StringFilter[];
9567
- /**
9568
- * <p>The solution-generated identifier for a related finding.</p>
9569
- */
9570
- RelatedFindingsId?: StringFilter[];
9571
- /**
9572
- * <p>The text of a note.</p>
9573
- */
9574
- NoteText?: StringFilter[];
9575
- /**
9576
- * <p>The timestamp of when the note was updated.</p>
9577
- */
9578
- NoteUpdatedAt?: DateFilter[];
9579
- /**
9580
- * <p>The principal that created a note.</p>
9581
- */
9582
- NoteUpdatedBy?: StringFilter[];
9583
- /**
9584
- * @deprecated
9585
- *
9586
- * <p>A keyword for a finding.</p>
9587
- */
9588
- Keyword?: KeywordFilter[];
9589
- /**
9590
- * <p>The finding provider value for the finding confidence. Confidence is defined as the likelihood
9591
- * that a finding accurately identifies the behavior or issue that it was intended to
9592
- * identify.</p>
9593
- * <p>Confidence is scored on a 0-100 basis using a ratio scale, where 0 means zero percent
9594
- * confidence and 100 means 100 percent confidence.</p>
9595
- */
9596
- FindingProviderFieldsConfidence?: NumberFilter[];
9597
- /**
9598
- * <p>The finding provider value for the level of importance assigned to the resources associated with
9599
- * the findings.</p>
9600
- * <p>A score of 0 means that the underlying resources have no criticality, and a score of 100
9601
- * is reserved for the most critical resources. </p>
9602
- */
9603
- FindingProviderFieldsCriticality?: NumberFilter[];
9604
- /**
9605
- * <p>The finding identifier of a related finding that is identified by the finding provider.</p>
9606
- */
9607
- FindingProviderFieldsRelatedFindingsId?: StringFilter[];
9608
- /**
9609
- * <p>The ARN of the solution that generated a related finding that is identified by the finding provider.</p>
9610
- */
9611
- FindingProviderFieldsRelatedFindingsProductArn?: StringFilter[];
9612
- /**
9613
- * <p>The finding provider value for the severity label.</p>
9614
- */
9615
- FindingProviderFieldsSeverityLabel?: StringFilter[];
9616
- /**
9617
- * <p>The finding provider's original value for the severity.</p>
9618
- */
9619
- FindingProviderFieldsSeverityOriginal?: StringFilter[];
9620
- /**
9621
- * <p>One or more finding types that the finding provider assigned to the finding. Uses the format of <code>namespace/category/classifier</code>
9622
- * that classify a finding.</p>
9623
- * <p>Valid namespace values are: Software and Configuration Checks | TTPs | Effects | Unusual
9624
- * Behaviors | Sensitive Data Identifications</p>
9625
- */
9626
- FindingProviderFieldsTypes?: StringFilter[];
9627
- /**
9628
- * <p>Indicates whether or not sample findings are included in the filter results.</p>
9629
- */
9630
- Sample?: BooleanFilter[];
9631
- /**
9632
- * <p>
9633
- * The unique identifier of a control across standards. Values for this field typically consist of an
9634
- * Amazon Web Service and a number, such as APIGateway.5.
9635
- * </p>
9636
- */
9637
- ComplianceSecurityControlId?: StringFilter[];
9638
- /**
9639
- * <p>
9640
- * The unique identifier of a standard in which a control is enabled. This field consists of the resource portion of the
9641
- * Amazon Resource Name (ARN) returned for a standard in the <a href="https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeStandards.html">DescribeStandards</a> API response.
9642
- * </p>
9643
- */
9644
- ComplianceAssociatedStandardsId?: StringFilter[];
9645
- }