> For the complete documentation index, see [llms.txt](https://docs.forestall.io/forestall/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.forestall.io/forestall/unified-identities/aws-identities/roles.md).

# Roles

The Roles page provides a list of enumerated IAM roles in the entire AWS environment. The list contains the Privileged, Tier 0, Service Linked, Inactive, Risk Score, Exposure Point and Issue Counts.

<figure><img src="https://3408039743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FObpV44hoVkNmo5bFuVVL%2Fuploads%2Fgit-blob-5ad62a198ac753c4d4050fdf796aa95b3e480a17%2Faws-roles-list-view.png?alt=media" alt=""><figcaption><p>Roles</p></figcaption></figure>

## Role Details

Details page contains the Risk Score of the role, Exposure Point, Information and Issues panes.

You can analyze objects in the Graph module by clicking the Visualize button on the upper left side of the Information Pane.

<figure><img src="https://3408039743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FObpV44hoVkNmo5bFuVVL%2Fuploads%2Fgit-blob-8d3c7ff690aa1bda40a092192752acfbe0640157%2Faws-identities-roles-image-1.png?alt=media" alt=""><figcaption><p>Role Details</p></figcaption></figure>

## Information

Information Pane can contain different badges to highlight important attributes.

| Badge          | Description                                                                           |
| -------------- | ------------------------------------------------------------------------------------- |
| Privileged     | Indicates that the object is Privileged.                                              |
| Tier           | Indicates that the object tier according to risk score and importance.                |
| Inactive       | Indicates that the role has not been used for a defined period.                       |
| Service Linked | Indicates that the role is an AWS service-linked role managed by an AWS service.      |
| Shadow Admin   | Indicates that the object can compromise admin objects with at least one attack path. |

Information Pane contains Details and Policies tabs.

## Details

Details tab contains attributes below about the IAM role object.

| Attribute            | Description                                                                            |
| -------------------- | -------------------------------------------------------------------------------------- |
| Role Name            | The name of the IAM role, used for identification within AWS.                          |
| Role ID              | The unique identifier assigned to the IAM role by AWS.                                 |
| ARN                  | The Amazon Resource Name that uniquely identifies the IAM role across AWS.             |
| Account ID           | The AWS account ID that the IAM role belongs to.                                       |
| Description          | A user-defined text field describing the role's purpose or intended use.               |
| Path                 | The path associated with the IAM role, used for organizational grouping.               |
| Created              | The date and time when the IAM role was created.                                       |
| Last Used            | The most recent date and time the role was assumed; blank if never used.               |
| Max Session Duration | The maximum duration in seconds for a session when assuming the role.                  |
| Permissions Boundary | The managed policy used to set the maximum permissions for the role; blank if not set. |
| Source Tenant        | The name of the tenant or configuration source from which the role was scanned.        |
| Object ID            | The unique identifier of the role object, equivalent to the IAM Role ID.               |

## Attached Policies

Attached Policies tab contains a list of IAM policies attached to the role, including both managed and inline policies. This list also contains columns such as AWS Managed and Grants Admin Privileges to identify the scope and risk level of each policy.

<figure><img src="https://3408039743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FObpV44hoVkNmo5bFuVVL%2Fuploads%2Fgit-blob-793d46453f4a43c7468e559dc5994749b4e84b17%2Faws-identities-roles-image-2.png?alt=media" alt=""><figcaption><p>Policies</p></figcaption></figure>

## Via Permission Sets

Via Permission Sets tab lists the IAM Identity Center permission sets that provision this role. A role created by Identity Center is not managed directly in IAM: its permissions come from the permission set, so the permission set is where a change has to be made.

## Trust Policy

Trust Policy tab shows the role's trust policy document, the policy that decides who is allowed to assume the role. It is shown as the raw JSON returned by AWS, so the principals, actions and conditions can be read exactly as they are evaluated.

The trust policy is what turns a role's permissions into a reachable path: a role with administrative permissions matters only as much as the set of principals its trust policy will accept. Look at the `Principal` block for accounts, federated providers or wildcards that are wider than intended, and at the `Condition` block for the constraints that narrow them.

## Issues

Issues pane contains identified security issues on the IAM role object.

<figure><img src="https://3408039743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FObpV44hoVkNmo5bFuVVL%2Fuploads%2Fgit-blob-01bb9ea3c37eff138c738956309370d987cf12e8%2Faws-identities-roles-image-3.png?alt=media" alt=""><figcaption><p>Issues</p></figcaption></figure>
