Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/grafana/v8.2/enterprise/access-control/fine-grained-access-control-references.md, or by sending Accept: text/markdown to https://grafana.com/docs/grafana/v8.2/enterprise/access-control/fine-grained-access-control-references/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
Fine-grained access control references
The reference information that follows complements conceptual information about Roles.
Fine-grained access fixed roles
| Fixed roles | Permissions | Descriptions |
|---|---|---|
fixed:permissions:admin:read | roles:readroles:listroles.builtin:list | Allows to list and get available roles and built-in role assignments. |
fixed:permissions:admin:edit | All permissions from fixed:permissions:admin:read androles:writeroles:deleteroles.builtin:addroles.builtin:remove | Allows every read action and in addition allows to create, change and delete custom roles and create or remove built-in role assignments. |
fixed:provisioning:admin | provisioning:reload | Allow provisioning configurations to be reloaded. |
fixed:reporting:admin:read | reports:readreports:sendreports.settings:read | Allows to read reports and report settings. |
fixed:reporting:admin:edit | All permissions from fixed:reporting:admin:read andreports.admin:writereports:deletereports.settings:write | Allows every read action for reports and in addition allows to administer reports. |
fixed:users:admin:read | users.authtoken:listusers.quotas:listusers:readusers.teams:read | Allows to list and get users and related information. |
fixed:users:admin:edit | All permissions from fixed:users:admin:read andusers.password:updateusers:writeusers:createusers:deleteusers:enableusers:disableusers.permissions:updateusers:logoutusers.authtoken:updateusers.quotas:update | Allows every read action for users and in addition allows to administer users. |
fixed:users:org:read | org.users:read | Allows to get user organizations. |
fixed:users:org:edit | All permissions from fixed:users:org:read andorg.users:addorg.users:removeorg.users.role:update | Allows every read action for user organizations and in addition allows to administer user organizations. |
fixed:ldap:admin:read | ldap.user:readldap.status:read | Allows to read LDAP information and status. |
fixed:ldap:admin:edit | All permissions from fixed:ldap:admin:read andldap.user:syncldap.config:reload | Allows every read action for LDAP and in addition allows to administer LDAP. |
fixed:server:admin:read | server.stats:read | Read server stats |
fixed:settings:admin:read | settings:read | Read settings |
fixed:settings:admin:edit | All permissions from fixed:settings:admin:read andsettings:write | Update settings |
fixed:datasources:editor:read | datasources:explore | Allows to access the Explore tab |
fixed:datasources:admin | datasources:readdatasources:createdatasources:writedatasources:delete | Allows to create, read, update, delete data sources. |
fixed:datasources:id:viewer | datasources.id:read | Allows to read data source IDs. |
fixed:datasources:permissions:admin | datasources.permissions:createdatasources.permissions:readdatasources.permissions:deletedatasources.permissions:toggle | Allows to create, read, delete, enable, or disable data source permissions |
Default built-in role assignments
| Built-in role | Associated role | Description |
|---|---|---|
| Grafana Admin | fixed:permissions:admin:editfixed:permissions:admin:readfixed:provisioning:adminfixed:reporting:admin:editfixed:reporting:admin:readfixed:users:admin:editfixed:users:admin:readfixed:users:org:editfixed:users:org:readfixed:ldap:admin:editfixed:ldap:admin:readfixed:server:admin:readfixed:settings:admin:readfixed:settings:admin:edit | Default Grafana server administrator assignments. |
| Admin | fixed:users:org:editfixed:users:org:readfixed:reporting:admin:editfixed:reporting:admin:readfixed:datasources:adminfixed:datasources:permissions:admin | Default Grafana organization administrator assignments. |
| Editor | fixed:datasources:editor:read | Default Editor assignments. |
| Viewer | fixed:datasources:id:viewer | Default Viewer assignments. |