turbot/alicloud
steampipe plugin install alicloud

Table: alicloud_ram_role - Query Alicloud RAM Roles using SQL

Alicloud RAM (Resource Access Management) is a service that helps you manage user identities and access permissions. You can create and manage multiple identities under your Alibaba Cloud account, and control the resources that each identity can access. RAM allows you to grant precise access permissions to different users, user groups, and roles.

Table Usage Guide

The alicloud_ram_role table provides insights into RAM roles within Alicloud Resource Access Management. As a security analyst, explore role-specific details through this table, including permissions, trust policies, and associated metadata. Utilize it to uncover information about roles, such as those with wildcard permissions, the trust relationships between roles, and the verification of trust policies.

Examples

List the policies attached to the roles

This query is used to gain insights into the various policies attached to different roles within your Alicloud RAM. It allows you to assess the elements within each role's policy, such as the policy's name, type, default version, and attachment date, providing a comprehensive overview of your role-based access controls.

select
name,
policies ->> 'PolicyName' as policy_name,
policies ->> 'PolicyType' as policy_type,
policies ->> 'DefaultVersion' as policy_default_version,
policies ->> 'AttachDate' as policy_attachment_date
from
alicloud_ram_role,
jsonb_array_elements(attached_policy) as policies
order by
name;
select
name,
json_extract(policies.value, '$.PolicyName') as policy_name,
json_extract(policies.value, '$.PolicyType') as policy_type,
json_extract(policies.value, '$.DefaultVersion') as policy_default_version,
json_extract(policies.value, '$.AttachDate') as policy_attachment_date
from
alicloud_ram_role,
json_each(attached_policy) as policies
order by
name;

Find all roles having Administrator access

Discover the segments that have Administrator access within a system. This is particularly useful for auditing purposes, ensuring only the correct roles have such high-level permissions.

select
name,
policies ->> 'PolicyName' as policy_name
from
alicloud_ram_role,
jsonb_array_elements(attached_policy) as policies
where
policies ->> 'PolicyName' = 'AdministratorAccess';
select
name,
json_extract(policies.value, '$.PolicyName') as policy_name
from
alicloud_ram_role,
json_each(attached_policy) as policies
where
json_extract(policies.value, '$.PolicyName') = 'AdministratorAccess';

Find all roles grant cross-account access in the Trust Policy

This query allows you to identify roles that have been granted access to other accounts within the Trust Policy, providing a way to review and manage cross-account permissions. This can be useful in maintaining security and control over data access across multiple accounts.

select
name,
principal,
split_part(principal, ':', 4) as foreign_account
from
alicloud_ram_role,
jsonb_array_elements(assume_role_policy_document -> 'Statement') as stmt,
jsonb_array_elements_text(stmt -> 'Principal' -> 'RAM') as principal
where
split_part(principal, ':', 4) <> account_id;
Error: SQLite does not support split
or string_to_array functions.

Schema for alicloud_ram_role

NameTypeOperatorsDescription
_ctxjsonbSteampipe context in JSON form, e.g. connection_name.
account_idtextThe Alicloud Account ID in which the resource is located.
akasjsonbArray of globally unique identifier strings (also known as) for the resource.
arntextThe Alibaba Cloud Resource Name (ARN) of the RAM role.
assume_role_policy_documentjsonbThe content of the policy that specifies one or more entities entrusted to assume the RAM role.
assume_role_policy_document_stdjsonbThe standard content of the policy that specifies one or more entities entrusted to assume the RAM role.
attached_policyjsonbA list of policies attached to a RAM role.
create_datetimestamp with time zoneThe time when the RAM role was created.
descriptiontextThe description of the RAM role.
max_session_durationbigintThe maximum session duration of the RAM role.
nametext=The name of the RAM role.
regiontextThe Alicloud region in which the resource is located.
role_idtextThe ID of the RAM role.
titletextTitle of the resource.
update_datetimestamp with time zoneThe time when the RAM role was modified.

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)" -- alicloud

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

steampipe_export_alicloud --config '<your_config>' alicloud_ram_role