steampipe plugin install aws

Table: aws_iam_policy_simulator - Query AWS IAM Policy Simulator using SQL

The AWS IAM Policy Simulator is a tool that enables you to understand, test, and validate the effects of access control policies. It allows you to simulate how IAM policies and resource-based policies work together to grant or deny access to AWS resources. This helps you to ensure that your policies provide the appropriate permissions before you commit them into production.

Table Usage Guide

The aws_iam_policy_simulator table in Steampipe provides you with information about IAM Policy Simulator within AWS Identity and Access Management (IAM). This table enables you to query evaluation results, matching resources, and involved actions as a DevOps engineer. You can use it to understand the effects of IAM access control policies. You can utilize this table to gather insights on policy simulation, such as the resources involved in the policy, the actions that can be performed, and the evaluation results. The schema outlines the various attributes of the IAM Policy Simulator for you, including the policy source, policy action, policy resource, and evaluation result.

Important Notes

  • You must specify a single action, resource_arn, and principal_arn in a where or join clause in order to use this table.

Examples

Check if user has s3:DeleteBucket on any resource

Determine if a specific user has the ability to delete any bucket in the S3 service. This is useful for auditing user permissions and ensuring that sensitive operations are restricted to authorized individuals.

select
decision
from
aws_iam_policy_simulator
where
action = 's3:DeleteBucket'
and resource_arn = '*'
and principal_arn = 'arn:aws:iam::012345678901:user/bob';
select
decision
from
aws_iam_policy_simulator
where
action = 's3:DeleteBucket'
and resource_arn = '*'
and principal_arn = 'arn:aws:iam::012345678901:user/bob';

Check if user has 'ec2:terminateinstances' on any resource including details of any policy granting or denying access

Determine if a specific user has the ability to terminate any instances on your AWS EC2 service. This query is useful for identifying potential security risks and ensuring appropriate permissions are in place.

select
decision,
jsonb_pretty(matched_statements)
from
aws_iam_policy_simulator
where
action = 'ec2:terminateinstances'
and resource_arn = '*'
and principal_arn = 'arn:aws:iam::012345678901:user/bob';
select
decision,
json_pretty(matched_statements)
from
aws_iam_policy_simulator
where
action = 'ec2:terminateinstances'
and resource_arn = '*'
and principal_arn = 'arn:aws:iam::012345678901:user/bob';

For all users in the account, check whether they have sts:AssumeRole on all roles.

Determine the areas in which users have the ability to assume all roles within an account. This is useful for identifying potential security risks and ensuring appropriate access controls are in place.

select
u.name,
decision
from
aws_iam_policy_simulator p,
aws_iam_user u
where
action = 'sts:AssumeRole'
and resource_arn = '*'
and p.principal_arn = u.arn;
select
u.name,
decision
from
aws_iam_policy_simulator p,
aws_iam_user u
where
action = 'sts:AssumeRole'
and resource_arn = '*'
and p.principal_arn = u.arn;

Schema for aws_iam_policy_simulator

NameTypeOperatorsDescription
_ctxjsonbSteampipe context in JSON form, e.g. connection_name.
actiontext=The action for this policy simulation.
decisiontextThe decision for this policy simulation.
decision_detailsjsonbThe decision details for this policy simulation.
matched_statementsjsonbThe matched statements for this policy simulation.
missing_context_valuesjsonbThe missing content values for this policy simulation.
organizations_decision_detailjsonbThe organizations decision detail for this policy simulation.
permissions_boundary_decision_detailjsonbThe permissions boundary decision detail for this policy simulation.
principal_arntext=The principal Amazon Resource Name (ARN) for this policy simulation.
resource_arntext=The resource for this policy simulation.
resource_specific_resultsjsonbThe resource specific results for this policy simulation.

Export

This table is available as a standalone Exporter CLI. Steampipe exporters are stand-alone binaries that allow you to extract data using Steampipe plugins without a database.

You can download the tarball for your platform from the Releases page, but it is simplest to install them with the steampipe_export_installer.sh script:

/bin/sh -c "$(curl -fsSL https://steampipe.io/install/export.sh)" -- aws

You can pass the configuration to the command with the --config argument:

steampipe_export_aws --config '<your_config>' aws_iam_policy_simulator