> For the complete documentation index, see [llms.txt](https://docs.forestall.io/fsprotect/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/fsprotect/gcp-identities/roles.md).

# Roles

The `Roles` page provides a list of enumerated Roles in GCP.

## Roles Details

The Details page includes the `Details` tab, and a `Visualize` button for enhanced navigation and analysis.

{% hint style="info" %}
You can analyze objects in the `Graph module` by clicking the `Visualize` button on the upper left side.
{% endhint %}

<figure><img src="/files/3ikb6c5rdj5onLkrDMlp" alt=""><figcaption><p>Role Details</p></figcaption></figure>

## Information

The Details tab contains attributes about the GCP Role. The page also includes an **Included Permissions** tab listing all permissions granted by the role.

| Attribute          | Description                                                                                                   |
| ------------------ | ------------------------------------------------------------------------------------------------------------- |
| Title              | The human-readable title of the role (e.g., `Custom Org Role 1`).                                             |
| Name               | The full resource name of the role (e.g., `organizations/749862357432/roles/CustomOrgRole1`).                 |
| Stage              | The launch stage of the role indicating its maturity level (e.g., `Alpha`).                                   |
| Is Custom          | Indicates whether the role is a custom role created by the organization, as opposed to a predefined GCP role. |
| Is Deleted         | Indicates whether the role has been deleted.                                                                  |
| Description        | A text description of the role's purpose and creation details.                                                |
| Directory Customer | The customer domain associated with this role (e.g., `labs.forestall.io`).                                    |

### Included Permissions

Lists all permissions granted by this role.

### Assigned Users

Lists all users who have been assigned this role.

### Assigned Groups

Lists all groups that have been assigned this role.

### Assigned Service Accounts

Lists all service accounts that have been assigned this role.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.forestall.io/fsprotect/gcp-identities/roles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
