AWS SecurityHub

2022/06/16 - AWS SecurityHub - 2 updated api methods

Changes  Added Threats field for security findings. Added new resource details for ECS Container, ECS Task, RDS SecurityGroup, Kinesis Stream, EC2 TransitGateway, EFS AccessPoint, CloudFormation Stack, CloudWatch Alarm, VPC Peering Connection and WAF Rules

BatchImportFindings (updated) Link ¶
Changes (request)
{'Findings': {'Resources': {'Details': {'AwsCloudFormationStack': {'Capabilities': ['string'],
                                                                   'CreationTime': 'string',
                                                                   'Description': 'string',
                                                                   'DisableRollback': 'boolean',
                                                                   'DriftInformation': {'StackDriftStatus': 'string'},
                                                                   'EnableTerminationProtection': 'boolean',
                                                                   'LastUpdatedTime': 'string',
                                                                   'NotificationArns': ['string'],
                                                                   'Outputs': [{'Description': 'string',
                                                                                'OutputKey': 'string',
                                                                                'OutputValue': 'string'}],
                                                                   'RoleArn': 'string',
                                                                   'StackId': 'string',
                                                                   'StackName': 'string',
                                                                   'StackStatus': 'string',
                                                                   'StackStatusReason': 'string',
                                                                   'TimeoutInMinutes': 'integer'},
                                        'AwsCloudFrontDistribution': {'Origins': {'Items': {'CustomOriginConfig': {'HttpPort': 'integer',
                                                                                                                   'HttpsPort': 'integer',
                                                                                                                   'OriginKeepaliveTimeout': 'integer',
                                                                                                                   'OriginProtocolPolicy': 'string',
                                                                                                                   'OriginReadTimeout': 'integer',
                                                                                                                   'OriginSslProtocols': {'Items': ['string'],
                                                                                                                                          'Quantity': 'integer'}}}}},
                                        'AwsCloudWatchAlarm': {'ActionsEnabled': 'boolean',
                                                               'AlarmActions': ['string'],
                                                               'AlarmArn': 'string',
                                                               'AlarmConfigurationUpdatedTimestamp': 'string',
                                                               'AlarmDescription': 'string',
                                                               'AlarmName': 'string',
                                                               'ComparisonOperator': 'string',
                                                               'DatapointsToAlarm': 'integer',
                                                               'Dimensions': [{'Name': 'string',
                                                                               'Value': 'string'}],
                                                               'EvaluateLowSampleCountPercentile': 'string',
                                                               'EvaluationPeriods': 'integer',
                                                               'ExtendedStatistic': 'string',
                                                               'InsufficientDataActions': ['string'],
                                                               'MetricName': 'string',
                                                               'Namespace': 'string',
                                                               'OkActions': ['string'],
                                                               'Period': 'integer',
                                                               'Statistic': 'string',
                                                               'Threshold': 'double',
                                                               'ThresholdMetricId': 'string',
                                                               'TreatMissingData': 'string',
                                                               'Unit': 'string'},
                                        'AwsEc2Instance': {'MetadataOptions': {'HttpEndpoint': 'string',
                                                                               'HttpProtocolIpv6': 'string',
                                                                               'HttpPutResponseHopLimit': 'integer',
                                                                               'HttpTokens': 'string',
                                                                               'InstanceMetadataTags': 'string'},
                                                           'VirtualizationType': 'string'},
                                        'AwsEc2TransitGateway': {'AmazonSideAsn': 'integer',
                                                                 'AssociationDefaultRouteTableId': 'string',
                                                                 'AutoAcceptSharedAttachments': 'string',
                                                                 'DefaultRouteTableAssociation': 'string',
                                                                 'DefaultRouteTablePropagation': 'string',
                                                                 'Description': 'string',
                                                                 'DnsSupport': 'string',
                                                                 'Id': 'string',
                                                                 'MulticastSupport': 'string',
                                                                 'PropagationDefaultRouteTableId': 'string',
                                                                 'TransitGatewayCidrBlocks': ['string'],
                                                                 'VpnEcmpSupport': 'string'},
                                        'AwsEc2Volume': {'DeviceName': 'string',
                                                         'VolumeId': 'string',
                                                         'VolumeScanStatus': 'string',
                                                         'VolumeType': 'string'},
                                        'AwsEc2VpcPeeringConnection': {'AccepterVpcInfo': {'CidrBlock': 'string',
                                                                                           'CidrBlockSet': [{'CidrBlock': 'string'}],
                                                                                           'Ipv6CidrBlockSet': [{'Ipv6CidrBlock': 'string'}],
                                                                                           'OwnerId': 'string',
                                                                                           'PeeringOptions': {'AllowDnsResolutionFromRemoteVpc': 'boolean',
                                                                                                              'AllowEgressFromLocalClassicLinkToRemoteVpc': 'boolean',
                                                                                                              'AllowEgressFromLocalVpcToRemoteClassicLink': 'boolean'},
                                                                                           'Region': 'string',
                                                                                           'VpcId': 'string'},
                                                                       'ExpirationTime': 'string',
                                                                       'RequesterVpcInfo': {'CidrBlock': 'string',
                                                                                            'CidrBlockSet': [{'CidrBlock': 'string'}],
                                                                                            'Ipv6CidrBlockSet': [{'Ipv6CidrBlock': 'string'}],
                                                                                            'OwnerId': 'string',
                                                                                            'PeeringOptions': {'AllowDnsResolutionFromRemoteVpc': 'boolean',
                                                                                                               'AllowEgressFromLocalClassicLinkToRemoteVpc': 'boolean',
                                                                                                               'AllowEgressFromLocalVpcToRemoteClassicLink': 'boolean'},
                                                                                            'Region': 'string',
                                                                                            'VpcId': 'string'},
                                                                       'Status': {'Code': 'string',
                                                                                  'Message': 'string'},
                                                                       'VpcPeeringConnectionId': 'string'},
                                        'AwsEcsCluster': {'ActiveServicesCount': 'integer',
                                                          'ClusterArn': 'string',
                                                          'ClusterName': 'string',
                                                          'RegisteredContainerInstancesCount': 'integer',
                                                          'RunningTasksCount': 'integer',
                                                          'Status': 'string'},
                                        'AwsEcsContainer': {'Image': 'string',
                                                            'MountPoints': [{'ContainerPath': 'string',
                                                                             'SourceVolume': 'string'}],
                                                            'Name': 'string',
                                                            'Privileged': 'boolean'},
                                        'AwsEcsTask': {'ClusterArn': 'string',
                                                       'Containers': [{'Image': 'string',
                                                                       'MountPoints': [{'ContainerPath': 'string',
                                                                                        'SourceVolume': 'string'}],
                                                                       'Name': 'string',
                                                                       'Privileged': 'boolean'}],
                                                       'CreatedAt': 'string',
                                                       'Group': 'string',
                                                       'StartedAt': 'string',
                                                       'StartedBy': 'string',
                                                       'TaskDefinitionArn': 'string',
                                                       'Version': 'string',
                                                       'Volumes': [{'Host': {'SourcePath': 'string'},
                                                                    'Name': 'string'}]},
                                        'AwsEfsAccessPoint': {'AccessPointId': 'string',
                                                              'Arn': 'string',
                                                              'ClientToken': 'string',
                                                              'FileSystemId': 'string',
                                                              'PosixUser': {'Gid': 'string',
                                                                            'SecondaryGids': ['string'],
                                                                            'Uid': 'string'},
                                                              'RootDirectory': {'CreationInfo': {'OwnerGid': 'string',
                                                                                                 'OwnerUid': 'string',
                                                                                                 'Permissions': 'string'},
                                                                                'Path': 'string'}},
                                        'AwsKinesisStream': {'Arn': 'string',
                                                             'Name': 'string',
                                                             'RetentionPeriodHours': 'integer',
                                                             'ShardCount': 'integer',
                                                             'StreamEncryption': {'EncryptionType': 'string',
                                                                                  'KeyId': 'string'}},
                                        'AwsOpenSearchServiceDomain': {'AdvancedSecurityOptions': {'Enabled': 'boolean',
                                                                                                   'InternalUserDatabaseEnabled': 'boolean',
                                                                                                   'MasterUserOptions': {'MasterUserArn': 'string',
                                                                                                                         'MasterUserName': 'string',
                                                                                                                         'MasterUserPassword': 'string'}}},
                                        'AwsSnsTopic': {'ApplicationSuccessFeedbackRoleArn': 'string',
                                                        'FirehoseFailureFeedbackRoleArn': 'string',
                                                        'FirehoseSuccessFeedbackRoleArn': 'string',
                                                        'HttpFailureFeedbackRoleArn': 'string',
                                                        'HttpSuccessFeedbackRoleArn': 'string',
                                                        'SqsFailureFeedbackRoleArn': 'string',
                                                        'SqsSuccessFeedbackRoleArn': 'string'},
                                        'AwsWafRegionalRule': {'MetricName': 'string',
                                                               'Name': 'string',
                                                               'PredicateList': [{'DataId': 'string',
                                                                                  'Negated': 'boolean',
                                                                                  'Type': 'string'}],
                                                               'RuleId': 'string'},
                                        'AwsWafRegionalRuleGroup': {'MetricName': 'string',
                                                                    'Name': 'string',
                                                                    'RuleGroupId': 'string',
                                                                    'Rules': [{'Action': {'Type': 'string'},
                                                                               'Priority': 'integer',
                                                                               'RuleId': 'string',
                                                                               'Type': 'string'}]},
                                        'AwsWafRegionalWebAcl': {'DefaultAction': 'string',
                                                                 'MetricName': 'string',
                                                                 'Name': 'string',
                                                                 'RulesList': [{'Action': {'Type': 'string'},
                                                                                'OverrideAction': {'Type': 'string'},
                                                                                'Priority': 'integer',
                                                                                'RuleId': 'string',
                                                                                'Type': 'string'}],
                                                                 'WebAclId': 'string'},
                                        'AwsWafRule': {'MetricName': 'string',
                                                       'Name': 'string',
                                                       'PredicateList': [{'DataId': 'string',
                                                                          'Negated': 'boolean',
                                                                          'Type': 'string'}],
                                                       'RuleId': 'string'},
                                        'AwsWafRuleGroup': {'MetricName': 'string',
                                                            'Name': 'string',
                                                            'RuleGroupId': 'string',
                                                            'Rules': [{'Action': {'Type': 'string'},
                                                                       'Priority': 'integer',
                                                                       'RuleId': 'string',
                                                                       'Type': 'string'}]},
                                        'Container': {'ContainerRuntime': 'string',
                                                      'Privileged': 'boolean',
                                                      'VolumeMounts': [{'MountPath': 'string',
                                                                        'Name': 'string'}]}}},
              'Threats': [{'FilePaths': [{'FileName': 'string',
                                          'FilePath': 'string',
                                          'Hash': 'string',
                                          'ResourceId': 'string'}],
                           'ItemCount': 'integer',
                           'Name': 'string',
                           'Severity': 'string'}]}}

Imports security findings generated by a finding provider into Security Hub. This action is requested by the finding provider to import its findings into Security Hub.

BatchImportFindings must be called by one of the following:

  • The Amazon Web Services account that is associated with a finding if you are using the default product ARN or are a partner sending findings from within a customer's Amazon Web Services account. In these cases, the identifier of the account that you are calling BatchImportFindings from needs to be the same as the AwsAccountId attribute for the finding.

  • An Amazon Web Services account that Security Hub has allow-listed for an official partner integration. In this case, you can call BatchImportFindings from the allow-listed account and send findings from different customer accounts in the same batch.

The maximum allowed size for a finding is 240 Kb. An error is returned for any finding larger than 240 Kb.

After a finding is created, BatchImportFindings cannot be used to update the following finding fields and objects, which Security Hub customers use to manage their investigation workflow.

  • Note

  • UserDefinedFields

  • VerificationState

  • Workflow

Finding providers also should not use BatchImportFindings to update the following attributes.

  • Confidence

  • Criticality

  • RelatedFindings

  • Severity

  • Types

Instead, finding providers use FindingProviderFields to provide values for these attributes.

See also: AWS API Documentation

Request Syntax

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Parameters

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

rtype:

dict

returns:

Response Syntax

{
    'FailedCount': 123,
    'SuccessCount': 123,
    'FailedFindings': [
        {
            'Id': 'string',
            'ErrorCode': 'string',
            'ErrorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • FailedCount (integer) --

      The number of findings that failed to import.

    • SuccessCount (integer) --

      The number of findings that were successfully imported.

    • FailedFindings (list) --

      The list of findings that failed to import.

      • (dict) --

        The list of the findings that cannot be imported. For each finding, the list provides the error.

        • Id (string) --

          The identifier of the finding that could not be updated.

        • ErrorCode (string) --

          The code of the error returned by the BatchImportFindings operation.

        • ErrorMessage (string) --

          The message of the error returned by the BatchImportFindings operation.

GetFindings (updated) Link ¶
Changes (response)
{'Findings': {'Resources': {'Details': {'AwsCloudFormationStack': {'Capabilities': ['string'],
                                                                   'CreationTime': 'string',
                                                                   'Description': 'string',
                                                                   'DisableRollback': 'boolean',
                                                                   'DriftInformation': {'StackDriftStatus': 'string'},
                                                                   'EnableTerminationProtection': 'boolean',
                                                                   'LastUpdatedTime': 'string',
                                                                   'NotificationArns': ['string'],
                                                                   'Outputs': [{'Description': 'string',
                                                                                'OutputKey': 'string',
                                                                                'OutputValue': 'string'}],
                                                                   'RoleArn': 'string',
                                                                   'StackId': 'string',
                                                                   'StackName': 'string',
                                                                   'StackStatus': 'string',
                                                                   'StackStatusReason': 'string',
                                                                   'TimeoutInMinutes': 'integer'},
                                        'AwsCloudFrontDistribution': {'Origins': {'Items': {'CustomOriginConfig': {'HttpPort': 'integer',
                                                                                                                   'HttpsPort': 'integer',
                                                                                                                   'OriginKeepaliveTimeout': 'integer',
                                                                                                                   'OriginProtocolPolicy': 'string',
                                                                                                                   'OriginReadTimeout': 'integer',
                                                                                                                   'OriginSslProtocols': {'Items': ['string'],
                                                                                                                                          'Quantity': 'integer'}}}}},
                                        'AwsCloudWatchAlarm': {'ActionsEnabled': 'boolean',
                                                               'AlarmActions': ['string'],
                                                               'AlarmArn': 'string',
                                                               'AlarmConfigurationUpdatedTimestamp': 'string',
                                                               'AlarmDescription': 'string',
                                                               'AlarmName': 'string',
                                                               'ComparisonOperator': 'string',
                                                               'DatapointsToAlarm': 'integer',
                                                               'Dimensions': [{'Name': 'string',
                                                                               'Value': 'string'}],
                                                               'EvaluateLowSampleCountPercentile': 'string',
                                                               'EvaluationPeriods': 'integer',
                                                               'ExtendedStatistic': 'string',
                                                               'InsufficientDataActions': ['string'],
                                                               'MetricName': 'string',
                                                               'Namespace': 'string',
                                                               'OkActions': ['string'],
                                                               'Period': 'integer',
                                                               'Statistic': 'string',
                                                               'Threshold': 'double',
                                                               'ThresholdMetricId': 'string',
                                                               'TreatMissingData': 'string',
                                                               'Unit': 'string'},
                                        'AwsEc2Instance': {'MetadataOptions': {'HttpEndpoint': 'string',
                                                                               'HttpProtocolIpv6': 'string',
                                                                               'HttpPutResponseHopLimit': 'integer',
                                                                               'HttpTokens': 'string',
                                                                               'InstanceMetadataTags': 'string'},
                                                           'VirtualizationType': 'string'},
                                        'AwsEc2TransitGateway': {'AmazonSideAsn': 'integer',
                                                                 'AssociationDefaultRouteTableId': 'string',
                                                                 'AutoAcceptSharedAttachments': 'string',
                                                                 'DefaultRouteTableAssociation': 'string',
                                                                 'DefaultRouteTablePropagation': 'string',
                                                                 'Description': 'string',
                                                                 'DnsSupport': 'string',
                                                                 'Id': 'string',
                                                                 'MulticastSupport': 'string',
                                                                 'PropagationDefaultRouteTableId': 'string',
                                                                 'TransitGatewayCidrBlocks': ['string'],
                                                                 'VpnEcmpSupport': 'string'},
                                        'AwsEc2Volume': {'DeviceName': 'string',
                                                         'VolumeId': 'string',
                                                         'VolumeScanStatus': 'string',
                                                         'VolumeType': 'string'},
                                        'AwsEc2VpcPeeringConnection': {'AccepterVpcInfo': {'CidrBlock': 'string',
                                                                                           'CidrBlockSet': [{'CidrBlock': 'string'}],
                                                                                           'Ipv6CidrBlockSet': [{'Ipv6CidrBlock': 'string'}],
                                                                                           'OwnerId': 'string',
                                                                                           'PeeringOptions': {'AllowDnsResolutionFromRemoteVpc': 'boolean',
                                                                                                              'AllowEgressFromLocalClassicLinkToRemoteVpc': 'boolean',
                                                                                                              'AllowEgressFromLocalVpcToRemoteClassicLink': 'boolean'},
                                                                                           'Region': 'string',
                                                                                           'VpcId': 'string'},
                                                                       'ExpirationTime': 'string',
                                                                       'RequesterVpcInfo': {'CidrBlock': 'string',
                                                                                            'CidrBlockSet': [{'CidrBlock': 'string'}],
                                                                                            'Ipv6CidrBlockSet': [{'Ipv6CidrBlock': 'string'}],
                                                                                            'OwnerId': 'string',
                                                                                            'PeeringOptions': {'AllowDnsResolutionFromRemoteVpc': 'boolean',
                                                                                                               'AllowEgressFromLocalClassicLinkToRemoteVpc': 'boolean',
                                                                                                               'AllowEgressFromLocalVpcToRemoteClassicLink': 'boolean'},
                                                                                            'Region': 'string',
                                                                                            'VpcId': 'string'},
                                                                       'Status': {'Code': 'string',
                                                                                  'Message': 'string'},
                                                                       'VpcPeeringConnectionId': 'string'},
                                        'AwsEcsCluster': {'ActiveServicesCount': 'integer',
                                                          'ClusterArn': 'string',
                                                          'ClusterName': 'string',
                                                          'RegisteredContainerInstancesCount': 'integer',
                                                          'RunningTasksCount': 'integer',
                                                          'Status': 'string'},
                                        'AwsEcsContainer': {'Image': 'string',
                                                            'MountPoints': [{'ContainerPath': 'string',
                                                                             'SourceVolume': 'string'}],
                                                            'Name': 'string',
                                                            'Privileged': 'boolean'},
                                        'AwsEcsTask': {'ClusterArn': 'string',
                                                       'Containers': [{'Image': 'string',
                                                                       'MountPoints': [{'ContainerPath': 'string',
                                                                                        'SourceVolume': 'string'}],
                                                                       'Name': 'string',
                                                                       'Privileged': 'boolean'}],
                                                       'CreatedAt': 'string',
                                                       'Group': 'string',
                                                       'StartedAt': 'string',
                                                       'StartedBy': 'string',
                                                       'TaskDefinitionArn': 'string',
                                                       'Version': 'string',
                                                       'Volumes': [{'Host': {'SourcePath': 'string'},
                                                                    'Name': 'string'}]},
                                        'AwsEfsAccessPoint': {'AccessPointId': 'string',
                                                              'Arn': 'string',
                                                              'ClientToken': 'string',
                                                              'FileSystemId': 'string',
                                                              'PosixUser': {'Gid': 'string',
                                                                            'SecondaryGids': ['string'],
                                                                            'Uid': 'string'},
                                                              'RootDirectory': {'CreationInfo': {'OwnerGid': 'string',
                                                                                                 'OwnerUid': 'string',
                                                                                                 'Permissions': 'string'},
                                                                                'Path': 'string'}},
                                        'AwsKinesisStream': {'Arn': 'string',
                                                             'Name': 'string',
                                                             'RetentionPeriodHours': 'integer',
                                                             'ShardCount': 'integer',
                                                             'StreamEncryption': {'EncryptionType': 'string',
                                                                                  'KeyId': 'string'}},
                                        'AwsOpenSearchServiceDomain': {'AdvancedSecurityOptions': {'Enabled': 'boolean',
                                                                                                   'InternalUserDatabaseEnabled': 'boolean',
                                                                                                   'MasterUserOptions': {'MasterUserArn': 'string',
                                                                                                                         'MasterUserName': 'string',
                                                                                                                         'MasterUserPassword': 'string'}}},
                                        'AwsSnsTopic': {'ApplicationSuccessFeedbackRoleArn': 'string',
                                                        'FirehoseFailureFeedbackRoleArn': 'string',
                                                        'FirehoseSuccessFeedbackRoleArn': 'string',
                                                        'HttpFailureFeedbackRoleArn': 'string',
                                                        'HttpSuccessFeedbackRoleArn': 'string',
                                                        'SqsFailureFeedbackRoleArn': 'string',
                                                        'SqsSuccessFeedbackRoleArn': 'string'},
                                        'AwsWafRegionalRule': {'MetricName': 'string',
                                                               'Name': 'string',
                                                               'PredicateList': [{'DataId': 'string',
                                                                                  'Negated': 'boolean',
                                                                                  'Type': 'string'}],
                                                               'RuleId': 'string'},
                                        'AwsWafRegionalRuleGroup': {'MetricName': 'string',
                                                                    'Name': 'string',
                                                                    'RuleGroupId': 'string',
                                                                    'Rules': [{'Action': {'Type': 'string'},
                                                                               'Priority': 'integer',
                                                                               'RuleId': 'string',
                                                                               'Type': 'string'}]},
                                        'AwsWafRegionalWebAcl': {'DefaultAction': 'string',
                                                                 'MetricName': 'string',
                                                                 'Name': 'string',
                                                                 'RulesList': [{'Action': {'Type': 'string'},
                                                                                'OverrideAction': {'Type': 'string'},
                                                                                'Priority': 'integer',
                                                                                'RuleId': 'string',
                                                                                'Type': 'string'}],
                                                                 'WebAclId': 'string'},
                                        'AwsWafRule': {'MetricName': 'string',
                                                       'Name': 'string',
                                                       'PredicateList': [{'DataId': 'string',
                                                                          'Negated': 'boolean',
                                                                          'Type': 'string'}],
                                                       'RuleId': 'string'},
                                        'AwsWafRuleGroup': {'MetricName': 'string',
                                                            'Name': 'string',
                                                            'RuleGroupId': 'string',
                                                            'Rules': [{'Action': {'Type': 'string'},
                                                                       'Priority': 'integer',
                                                                       'RuleId': 'string',
                                                                       'Type': 'string'}]},
                                        'Container': {'ContainerRuntime': 'string',
                                                      'Privileged': 'boolean',
                                                      'VolumeMounts': [{'MountPath': 'string',
                                                                        'Name': 'string'}]}}},
              'Threats': [{'FilePaths': [{'FileName': 'string',
                                          'FilePath': 'string',
                                          'Hash': 'string',
                                          'ResourceId': 'string'}],
                           'ItemCount': 'integer',
                           'Name': 'string',
                           'Severity': 'string'}]}}

Returns a list of findings that match the specified criteria.

If finding aggregation is enabled, then when you call GetFindings from the aggregation Region, the results include all of the matching findings from both the aggregation Region and the linked Regions.

See also: AWS API Documentation

Request Syntax

client.get_findings(
    Filters={
        'ProductArn': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'AwsAccountId': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'Id': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'GeneratorId': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'Region': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'Type': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'FirstObservedAt': [
            {
                'Start': 'string',
                'End': 'string',
                'DateRange': {
                    'Value': 123,
                    'Unit': 'DAYS'
                }
            },
        ],
        'LastObservedAt': [
            {
                'Start': 'string',
                'End': 'string',
                'DateRange': {
                    'Value': 123,
                    'Unit': 'DAYS'
                }
            },
        ],
        'CreatedAt': [
            {
                'Start': 'string',
                'End': 'string',
                'DateRange': {
                    'Value': 123,
                    'Unit': 'DAYS'
                }
            },
        ],
        'UpdatedAt': [
            {
                'Start': 'string',
                'End': 'string',
                'DateRange': {
                    'Value': 123,
                    'Unit': 'DAYS'
                }
            },
        ],
        'SeverityProduct': [
            {
                'Gte': 123.0,
                'Lte': 123.0,
                'Eq': 123.0
            },
        ],
        'SeverityNormalized': [
            {
                'Gte': 123.0,
                'Lte': 123.0,
                'Eq': 123.0
            },
        ],
        'SeverityLabel': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'Confidence': [
            {
                'Gte': 123.0,
                'Lte': 123.0,
                'Eq': 123.0
            },
        ],
        'Criticality': [
            {
                'Gte': 123.0,
                'Lte': 123.0,
                'Eq': 123.0
            },
        ],
        'Title': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'Description': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'RecommendationText': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'SourceUrl': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ProductFields': [
            {
                'Key': 'string',
                'Value': 'string',
                'Comparison': 'EQUALS'|'NOT_EQUALS'
            },
        ],
        'ProductName': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'CompanyName': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'UserDefinedFields': [
            {
                'Key': 'string',
                'Value': 'string',
                'Comparison': 'EQUALS'|'NOT_EQUALS'
            },
        ],
        'MalwareName': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'MalwareType': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'MalwarePath': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'MalwareState': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'NetworkDirection': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'NetworkProtocol': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'NetworkSourceIpV4': [
            {
                'Cidr': 'string'
            },
        ],
        'NetworkSourceIpV6': [
            {
                'Cidr': 'string'
            },
        ],
        'NetworkSourcePort': [
            {
                'Gte': 123.0,
                'Lte': 123.0,
                'Eq': 123.0
            },
        ],
        'NetworkSourceDomain': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'NetworkSourceMac': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'NetworkDestinationIpV4': [
            {
                'Cidr': 'string'
            },
        ],
        'NetworkDestinationIpV6': [
            {
                'Cidr': 'string'
            },
        ],
        'NetworkDestinationPort': [
            {
                'Gte': 123.0,
                'Lte': 123.0,
                'Eq': 123.0
            },
        ],
        'NetworkDestinationDomain': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ProcessName': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ProcessPath': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ProcessPid': [
            {
                'Gte': 123.0,
                'Lte': 123.0,
                'Eq': 123.0
            },
        ],
        'ProcessParentPid': [
            {
                'Gte': 123.0,
                'Lte': 123.0,
                'Eq': 123.0
            },
        ],
        'ProcessLaunchedAt': [
            {
                'Start': 'string',
                'End': 'string',
                'DateRange': {
                    'Value': 123,
                    'Unit': 'DAYS'
                }
            },
        ],
        'ProcessTerminatedAt': [
            {
                'Start': 'string',
                'End': 'string',
                'DateRange': {
                    'Value': 123,
                    'Unit': 'DAYS'
                }
            },
        ],
        'ThreatIntelIndicatorType': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ThreatIntelIndicatorValue': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ThreatIntelIndicatorCategory': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ThreatIntelIndicatorLastObservedAt': [
            {
                'Start': 'string',
                'End': 'string',
                'DateRange': {
                    'Value': 123,
                    'Unit': 'DAYS'
                }
            },
        ],
        'ThreatIntelIndicatorSource': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ThreatIntelIndicatorSourceUrl': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceType': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceId': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourcePartition': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceRegion': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceTags': [
            {
                'Key': 'string',
                'Value': 'string',
                'Comparison': 'EQUALS'|'NOT_EQUALS'
            },
        ],
        'ResourceAwsEc2InstanceType': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceAwsEc2InstanceImageId': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceAwsEc2InstanceIpV4Addresses': [
            {
                'Cidr': 'string'
            },
        ],
        'ResourceAwsEc2InstanceIpV6Addresses': [
            {
                'Cidr': 'string'
            },
        ],
        'ResourceAwsEc2InstanceKeyName': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceAwsEc2InstanceIamInstanceProfileArn': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceAwsEc2InstanceVpcId': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceAwsEc2InstanceSubnetId': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceAwsEc2InstanceLaunchedAt': [
            {
                'Start': 'string',
                'End': 'string',
                'DateRange': {
                    'Value': 123,
                    'Unit': 'DAYS'
                }
            },
        ],
        'ResourceAwsS3BucketOwnerId': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceAwsS3BucketOwnerName': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceAwsIamAccessKeyUserName': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceAwsIamAccessKeyPrincipalName': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceAwsIamAccessKeyStatus': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceAwsIamAccessKeyCreatedAt': [
            {
                'Start': 'string',
                'End': 'string',
                'DateRange': {
                    'Value': 123,
                    'Unit': 'DAYS'
                }
            },
        ],
        'ResourceAwsIamUserUserName': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceContainerName': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceContainerImageId': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceContainerImageName': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'ResourceContainerLaunchedAt': [
            {
                'Start': 'string',
                'End': 'string',
                'DateRange': {
                    'Value': 123,
                    'Unit': 'DAYS'
                }
            },
        ],
        'ResourceDetailsOther': [
            {
                'Key': 'string',
                'Value': 'string',
                'Comparison': 'EQUALS'|'NOT_EQUALS'
            },
        ],
        'ComplianceStatus': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'VerificationState': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'WorkflowState': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'WorkflowStatus': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'RecordState': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'RelatedFindingsProductArn': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'RelatedFindingsId': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'NoteText': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'NoteUpdatedAt': [
            {
                'Start': 'string',
                'End': 'string',
                'DateRange': {
                    'Value': 123,
                    'Unit': 'DAYS'
                }
            },
        ],
        'NoteUpdatedBy': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'Keyword': [
            {
                'Value': 'string'
            },
        ],
        'FindingProviderFieldsConfidence': [
            {
                'Gte': 123.0,
                'Lte': 123.0,
                'Eq': 123.0
            },
        ],
        'FindingProviderFieldsCriticality': [
            {
                'Gte': 123.0,
                'Lte': 123.0,
                'Eq': 123.0
            },
        ],
        'FindingProviderFieldsRelatedFindingsId': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'FindingProviderFieldsRelatedFindingsProductArn': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'FindingProviderFieldsSeverityLabel': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'FindingProviderFieldsSeverityOriginal': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'FindingProviderFieldsTypes': [
            {
                'Value': 'string',
                'Comparison': 'EQUALS'|'PREFIX'|'NOT_EQUALS'|'PREFIX_NOT_EQUALS'
            },
        ],
        'Sample': [
            {
                'Value': True|False
            },
        ]
    },
    SortCriteria=[
        {
            'Field': 'string',
            'SortOrder': 'asc'|'desc'
        },
    ],
    NextToken='string',
    MaxResults=123
)


  **Parameters**
  ::

      # This section is too large to render.
      # Please see the AWS API Documentation linked below.

  `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/GetFindings>`_
rtype:

dict

returns:

Response Syntax

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation

Response Structure

# This section is too large to render.
# Please see the AWS API Documentation linked below.

AWS API Documentation