> 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/github-identities/organization-roles.md).

# Organization Roles

The Organization Roles page provides a list of enumerated GitHub organization roles in the scanned environment. The list contains the Name, Role Name, Base Role, Custom, Privileged, Risk Score, Exposure Point and Issue Counts of each organization role object.

<figure><img src="https://3408039743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FObpV44hoVkNmo5bFuVVL%2Fuploads%2Fgit-blob-bcc0219543b238e0b982fb1fb17b4f6cac17ade2%2Fgithub-identities-organization-roles-image-1.png?alt=media" alt=""><figcaption><p><em>Organization Roles</em></p></figcaption></figure>

### Organization 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-91ca48d6210e4abbf1ea8ccc9ce871240693a31d%2Fgithub-identities-organization-roles-image-2.png?alt=media" alt=""><figcaption><p>Organization Role Details</p></figcaption></figure>

#### Information

Information Pane can contain different badges to highlight important attributes.

| Badge          | Description                                                                                                                                                                   |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tier 0**     | Indicates that the object is a Tier 0 asset. A role that can manage custom organization roles is Tier 0, because holding it allows granting oneself owner-equivalent control. |
| **Privileged** | Indicates that the object is privileged.                                                                                                                                      |
| **Custom**     | Indicates that the role is defined by the organization or enterprise rather than being a GitHub built-in role.                                                                |

Information Pane contains Details, Permissions, Assigned Users and Assigned Teams tabs respectively.

**Details**

Details tab contains attributes below about the organization role object.

| Attribute   | Description                                                                                                  |
| ----------- | ------------------------------------------------------------------------------------------------------------ |
| Name        | The name of the organization role (e.g., `security_manager`, `all_repo_admin`).                              |
| Base Role   | The built-in repository role the role is derived from (read, triage, write, maintain, admin), if one is set. |
| Custom      | Whether the role is custom-defined rather than a GitHub built-in role.                                       |
| Privileged  | Whether the role is privileged.                                                                              |
| Description | The description configured for the role, if available.                                                       |

**Permissions**

Permissions tab contains the fine-grained permissions granted by this role.

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

**Name:** The human-readable name of the permission. **Key:** The raw permission identifier used by the GitHub API (e.g., `write_organization_custom_org_role`). **Description:** An explanation of what the permission allows.

A permission that grants the ability to manage custom organization roles is marked with an **Escalation** badge. Such a permission is an escalation path in itself: a principal holding it can add permissions to a role it already has, and reach owner-equivalent control without ever being made an owner.

**Assigned Users**

Assigned Users tab contains a list of users this role is directly assigned to.

<figure><img src="https://3408039743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FObpV44hoVkNmo5bFuVVL%2Fuploads%2Fgit-blob-6c0133643709c6501560f767a9dc19d83e5db605%2Fgithub-identities-organization-roles-image-4.png?alt=media" alt=""><figcaption><p><em>Assigned Users</em></p></figcaption></figure>

**User:** The name of the user object. **Login:** The unique account name (handle) of the user. **Org Role:** The user's role within the organization (`admin` or `member`).

**Assigned Teams**

Assigned Teams tab contains a list of teams this role is assigned to. Every member of a listed team inherits the role.

<figure><img src="https://3408039743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FObpV44hoVkNmo5bFuVVL%2Fuploads%2Fgit-blob-be9fb3eaba29533822e6b4d4e1cb4b95feea99fe%2Fgithub-identities-organization-roles-image-5.png?alt=media" alt=""><figcaption><p><em>Assigned Teams</em></p></figcaption></figure>

**Team:** The name of the team object. **Slug:** The unique URL identifier of the team.

#### Issues

Issues pane contains identified issues on the organization role object.
