AWS::SecurityHub::AutomationRule AutomationRulesFindingFilters - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::SecurityHub::AutomationRule AutomationRulesFindingFilters

The criteria that determine which findings a rule applies to.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

Properties

AwsAccountId

The Amazon Web Services account ID in which a finding was generated.

Array Members: Minimum number of 1 item. Maximum number of 100 items.

Required: No

Type: Array of StringFilter

Maximum: 100

Update requires: No interruption

CompanyName

The name of the company for the product that generated the finding. For control-based findings, the company is Amazon.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

ComplianceAssociatedStandardsId

The unique identifier of a standard in which a control is enabled. This field consists of the resource portion of the Amazon Resource Name (ARN) returned for a standard in the DescribeStandards API response.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

ComplianceSecurityControlId

The security control ID for which a finding was generated. Security control IDs are the same across standards.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

ComplianceStatus

The result of a security check. This field is only used for findings generated from controls.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

Confidence

The likelihood that a finding accurately identifies the behavior or issue that it was intended to identify. Confidence is scored on a 0–100 basis using a ratio scale. A value of 0 means 0 percent confidence, and a value of 100 means 100 percent confidence. For example, a data exfiltration detection based on a statistical deviation of network traffic has low confidence because an actual exfiltration hasn't been verified. For more information, see Confidence in the Amazon Security Hub User Guide.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of NumberFilter

Maximum: 20

Update requires: No interruption

CreatedAt

A timestamp that indicates when this finding record was created.

Uses the date-time format specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example, 2020-03-22T13:22:13.933Z.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of DateFilter

Maximum: 20

Update requires: No interruption

Criticality

The level of importance that is assigned to the resources that are associated with a finding. Criticality is scored on a 0–100 basis, using a ratio scale that supports only full integers. A score of 0 means that the underlying resources have no criticality, and a score of 100 is reserved for the most critical resources. For more information, see Criticality in the Amazon Security Hub User Guide.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of NumberFilter

Maximum: 20

Update requires: No interruption

Description

A finding's description.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

FirstObservedAt

A timestamp that indicates when the potential security issue captured by a finding was first observed by the security findings product.

Uses the date-time format specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example, 2020-03-22T13:22:13.933Z.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of DateFilter

Maximum: 20

Update requires: No interruption

GeneratorId

The identifier for the solution-specific component that generated a finding.

Array Members: Minimum number of 1 item. Maximum number of 100 items.

Required: No

Type: Array of StringFilter

Maximum: 100

Update requires: No interruption

Id

The product-specific identifier for a finding.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

LastObservedAt

A timestamp that indicates when the potential security issue captured by a finding was most recently observed by the security findings product.

Uses the date-time format specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example, 2020-03-22T13:22:13.933Z.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of DateFilter

Maximum: 20

Update requires: No interruption

NoteText

The text of a user-defined note that's added to a finding.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

NoteUpdatedAt

The timestamp of when the note was updated. Uses the date-time format specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example, 2020-03-22T13:22:13.933Z.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of DateFilter

Maximum: 20

Update requires: No interruption

NoteUpdatedBy

The principal that created a note.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

ProductArn

The Amazon Resource Name (ARN) for a third-party product that generated a finding in Security Hub.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

ProductName

Provides the name of the product that generated the finding. For control-based findings, the product name is Security Hub.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

RecordState

Provides the current state of a finding.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

RelatedFindingsId

The product-generated identifier for a related finding.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

RelatedFindingsProductArn

The ARN for the product that generated a related finding.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

ResourceDetailsOther

Custom fields and values about the resource that a finding pertains to.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of MapFilter

Maximum: 20

Update requires: No interruption

ResourceId

The identifier for the given resource type. For Amazon resources that are identified by Amazon Resource Names (ARNs), this is the ARN. For Amazon resources that lack ARNs, this is the identifier as defined by the Amazon Web Service that created the resource. For non-Amazon resources, this is a unique identifier that is associated with the resource.

Array Members: Minimum number of 1 item. Maximum number of 100 items.

Required: No

Type: Array of StringFilter

Maximum: 100

Update requires: No interruption

ResourcePartition

The partition in which the resource that the finding pertains to is located. A partition is a group of Amazon Web Services Regions. Each Amazon Web Services account is scoped to one partition.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

ResourceRegion

The Amazon Web Services Region where the resource that a finding pertains to is located.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

ResourceTags

A list of Amazon tags associated with a resource at the time the finding was processed.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of MapFilter

Maximum: 20

Update requires: No interruption

ResourceType

A finding's title.

Array Members: Minimum number of 1 item. Maximum number of 100 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

SeverityLabel

The severity value of the finding.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

SourceUrl

Provides a URL that links to a page about the current finding in the finding product.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

Title

A finding's title.

Array Members: Minimum number of 1 item. Maximum number of 100 items.

Required: No

Type: Array of StringFilter

Maximum: 100

Update requires: No interruption

Type

One or more finding types in the format of namespace/category/classifier that classify a finding. For a list of namespaces, classifiers, and categories, see Types taxonomy for ASFF in the Amazon Security Hub User Guide.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

UpdatedAt

A timestamp that indicates when the finding record was most recently updated.

Uses the date-time format specified in RFC 3339 section 5.6, Internet Date/Time Format. The value cannot contain spaces. For example, 2020-03-22T13:22:13.933Z.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of DateFilter

Maximum: 20

Update requires: No interruption

UserDefinedFields

A list of user-defined name and value string pairs added to a finding.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of MapFilter

Maximum: 20

Update requires: No interruption

VerificationState

Provides the veracity of a finding.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption

WorkflowStatus

Provides information about the status of the investigation into a finding.

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Required: No

Type: Array of StringFilter

Maximum: 20

Update requires: No interruption