Skip to content
AWS for Query.Farm

aws.accessanalyzer.list_findings

Example SQL Queries

SELECT * FROM
aws.accessanalyzer.list_findings
WHERE
"analyzer_arn" = 'VALUE';

Description

Retrieves a list of findings generated by the specified analyzer. ListFindings and ListFindingsV2 both use access-analyzer:ListFindings in the Action element of an IAM policy statement. You must have permission to perform the access-analyzer:ListFindings action.

To learn about filter keys that you can use to retrieve a list of findings, see IAM Access Analyzer filter keys in the IAM User Guide.

Table Definition

Column NameColumn Data Type
analyzer_arn Required Input Column

The ARN of the analyzer to retrieve findings from.

VARCHAR
filter Input Column

A filter to match for the findings to return.

MAP(VARCHAR, STRUCT(
        "eq" VARCHAR[],
        "neq" VARCHAR[],
        "contains" VARCHAR[],
        "exists" BOOLEAN
    ))
sort Input Column

The sort order for the findings returned.

STRUCT(
    "attribute_name" VARCHAR,
    "order_by" VARCHAR
)
Show child fields
sort.attribute_name

The name of the attribute to sort on.

sort.order_by

The sort order, ascending or descending.

_aws_profile Input Column

The AWS profile defines the AWS identity used. It can be defined via credentials or by assuming a IAM role.

STRUCT(
    "type" VARCHAR,
    "name" VARCHAR,
    "account_id" VARCHAR,
    "via_profile_name" VARCHAR,
    "assumed_role_arn" VARCHAR,
    "organization" STRUCT(
        "account_name" VARCHAR,
        "id" VARCHAR,
        "tags" STRUCT(
            "key" VARCHAR,
            "value" VARCHAR
        )[],
        "master_account" STRUCT(
            "id" VARCHAR,
            "email" VARCHAR
        ),
        "parents" STRUCT(
            "type" VARCHAR,
            "id" VARCHAR,
            "name" VARCHAR,
            "tags" STRUCT(
                "key" VARCHAR,
                "value" VARCHAR
            )[]
        )[]
    )
)
Show child fields
_aws_profile.account_id

The AWS account id

_aws_profile.assumed_role_arn

The ARN of the assumed role

_aws_profile.name

The unique name of the profile.

_aws_profile.organization

Information about this profile's membership in the AWS organization.

Show child fields
_aws_profile.organization.account_name

The name of account speciifed by the organization

_aws_profile.organization.id

The organization id

_aws_profile.organization.master_account
Show child fields
_aws_profile.organization.master_account.email

The organization master account email address

_aws_profile.organization.master_account.id

The organization master account id

_aws_profile.organization.parents[]
Show child fields
_aws_profile.organization.parents[].id

The id of the parent

_aws_profile.organization.parents[].name

The name of the parent

_aws_profile.organization.parents[].tags[]
Show child fields
_aws_profile.organization.parents[].tags[].key
_aws_profile.organization.parents[].tags[].value
_aws_profile.organization.parents[].type

The type of parent can be an organization unit or a root

_aws_profile.organization.tags[]
Show child fields
_aws_profile.organization.tags[].key
_aws_profile.organization.tags[].value
_aws_profile.type

The type of profile, either 'credentials' or 'assumed_role'

_aws_profile.via_profile_name

This IAM role for this profile is assumed by first utilizing another profile with this name to obtain credentials.

action

The action in the analyzed policy statement that an external principal has permission to use.

VARCHAR[]
Show child fields
action[]
analyzed_at

The time at which the resource-based policy that generated the finding was analyzed.

TIMESTAMP_S
condition

The condition in the analyzed policy statement that resulted in a finding.

MAP(VARCHAR, VARCHAR)
created_at

The time at which the finding was created.

TIMESTAMP_S
error

The error that resulted in an Error finding.

VARCHAR
id

The ID of the finding.

VARCHAR
is_public

Indicates whether the finding reports a resource that has a policy that allows public access.

BOOLEAN
principal

The external principal that has access to a resource within the zone of trust.

MAP(VARCHAR, VARCHAR)
resource

The resource that the external principal has access to.

VARCHAR
resource_owner_account

The Amazon Web Services account ID that owns the resource.

VARCHAR
resource_type

The type of the resource that the external principal has access to.

VARCHAR
sources

The sources of the finding. This indicates how the access that generated the finding is granted. It is populated for Amazon S3 bucket findings.

STRUCT(
    "type" VARCHAR,
    "detail" STRUCT(
        "access_point_arn" VARCHAR,
        "access_point_account" VARCHAR
    )
)[]
Show child fields
sources[]
Show child fields
sources[].detail

Includes details about how the access that generated the finding is granted. This is populated for Amazon S3 bucket findings.

Show child fields
sources[].detail.access_point_account

The account of the cross-account access point that generated the finding.

sources[].detail.access_point_arn

The ARN of the access point that generated the finding. The ARN format depends on whether the ARN represents an access point or a multi-region access point.

sources[].type

Indicates the type of access that generated the finding.

status

The status of the finding.

VARCHAR
updated_at

The time at which the finding was most recently updated.

TIMESTAMP_S