Permission reference

This table lists the permissions on the server that you can assign to roles.

The following table lists the product areas with their available permissions. Because of the large number of edit sub-permissions, they are provided in a separate column.

Table 1. Permissions
Product area	Available permissions	Subpermissions
Agent	Execute on agents: run processes on the agent Install Remote Agents enable you to install remote agents. View Agents: access agents in the UI but cannot modify them Edit: modify and delete agents	Edit Add to Agent Pool: assign agents to agent pools Create Resources: create agent-type resources Delete: delete agents Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Impersonation: set up user impersonation for agents Manage Licenses: set agent license type Manage Properties: create and modify agent properties Manage Teams: assign agents to teams Manage Version Imports: import component versions with the agent Upgrade Agents: upgrade agents
Agent Configuration Template	Create Agent Configuration Templates: create agent configuration templates View Agent Configuration Templates: access agent configuration template in the UI but cannot modify them Edit: modify and delete agent configuration templates	Edit Delete: delete agent configuration templates Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Teams: assign agent configuration templates to teams
Agent pool	Create Agent Pools: create agent pools View Agent Pools: access agent pools in the UI but cannot modify them Edit: modify and delete agent pools	Edit Create Resources: create agent pool resources Delete: delete agent pools Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Pool Members: change the agents that are in a pool Manage Teams: assign agent pools to teams
Agent relay	View Agent Relays: see the agent relays that are listed on the Resources tab	Edit Delete: delete agent relays Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Teams: assign agent relays to teams
Application	View Applications: access applications in the UI but cannot modify them Create: create applications Edit: modify and delete applications	Create Create Applications: create applications without using a template Create Applications From Template: create applications by using templates to define their attributes Edit Delete: delete applications Delete Snapshot: delete snapshot Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Blueprints: create and modify blueprints Manage Components: add and remove components Manage Environments: create and modify environments Manage Processes: create application processes Manage Properties: create and modify application properties Manage Snapshots: create and modify snapshots Manage Teams: assign teams to applications Run Component Processes: run processes that are defined for components that are attached to the application
Application template	Create Application Templates View Application Templates Edit	Edit Delete: delete applications Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Blueprints: create and modify blueprints Manage Component Tags: add and remove component tags Manage Environment Templages: create and modify environment templates Manage Processes: create application processes Manage Properties: create and modify application properties Manage Teams: assign teams to applications
Cloud connection	Create Cloud Connections: create connections View Cloud Connections: access connections in the UI but cannot modify them Edit: modify and delete connections	Edit Delete: delete cloud connections Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Teams: assign teams to cloud connections
Component	View Components: access components in the UI but cannot modify them Create: create components Edit: modify and delete components	Create Create Components: create components without using a template Create Components From Template: create components by using templates to define their attributes Edit Approve Promotion: approve component version promotion Delete: delete components Edit Basic Settings: edit configuration settings on the Basic Settings panel Edit Components: create and modify components Manage Configuration Templates: create configuration templates Manage Process Lock: create process lock Manage Processes: create component processes Manage Properties: create component properties Manage Teams: assign teams to components Manage Version Status: create component version status Manage Versions: import component versions
Component template	Create Component Templates: create component templates View Component Templates: access component templates in the UI but cannot modify them Edit: modify and delete component templates	Edit Approve Promotion: approve component template promotion Delete: delete component templates Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Process Lock: create component template process lock Manage Processes: create and modify component template processes Manage Properties: create and modify component template properties Manage Teams: assign teams to component templates
Environment	Execute on Environments: run parent applications View Environments: access environments in the UI but not modify them Create: create environments Edit: modify and delete environments	Create Create Environments: create environments without using a template Create Enviornments From Template: create environments by using templates to define their attributes Edit Delete: delete environments Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Approval Processes: create and modify approvals and notifications Manage Base Resources: add base resources to environments Manage Deployment Triggers: create and modify deployment triggers. Manage Properties: create and modify environment properties Manage Teams: assign teams to environments
Environment template	Create Environment Templates View Environment Templates Edit	Edit Delete: delete applications Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Approval Processes: create modify approvals and notifications Manage Properties: create and modify environment properties Manage Teams: assign teams to environments
External Approval	Create External Approvals: create external approvals View External Approvals: access external approval definitions in the UI but cannot modify them Edit: modify and delete external approvals	Edit Delete: delete external approvals Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Properties: create and modify external approval properties Manage Teams: assign teams to external approvals
Post Processing Script	Create Post Processing Script: create post processing scripts View Post Processing Script: access post processing script definitions in the UI but cannot modify them Edit: modify and delete post processing script	Edit Delete: delete post processing script Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Teams: assign teams to post processing script
Process	Create Processes: create processes Execute Processes: run processes View Processes: access process definitions in the UI but cannot modify them Edit: modify and delete processes	Edit Delete: delete generic processes Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Properties: create and modify generic process properties Manage Teams: assign teams to generic processes
Resource	Create Resources: create resources Execute on Resources: Run processes on agent resources View Resources: access resources in the UI but cannot modify them Edit: modify and delete resources	Edit Delete: delete resources Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Children: create, modify, and delete resource hierarchies Manage Impersonation: set up user impersonation for agent and agent pool resources Manage Properties: create and modify resource properties Manage Teams: assign teams to resources Map to Environments: assign resources to application environments
Resource template	Create Resource Templates: create resource templates View Resource Templates: access resource templates in the UI but cannot modify them Edit: modify and delete resource templates	Edit Delete: delete resource templates Edit Basic Settings: edit configuration settings on the Basic Settings panel Manage Resources: create, modify, and delete resource hierarchies Manage Teams: assign teams to resource templates

The page of permissions also includes Server Configuration and Web UI sections. These permissions affect how users can modify security settings on the server and which pages in the server user interface they can see.

Table 2. Server configuration permissions
Permission	Description
Add Team Members	Add users to roles that have the same or fewer permissions than those of the granting user.
Edit Basic System Settings	Enables users to edit the options on the System Settings page. See, Server settings. This activity is written to the audit log.
Edit Network Settings	Grants users the permission to access the Network page and manage servers in a server cluster.
Manage Audit Log	Grants users the permission to manually cleanup the audit log, and configure automatic cleanup settings. If you have this permission but not the edit basic settings permission, you can edit the audit cleanup settings from the Audit Log page. This activity is written to the audit log.
Manage Auth Token Restrictions	Create, modify and delete token restrictions. See, Restricting authentication tokens
Manage Blueprint Designer Integrations	Grants users the permission to view and create Blueprint Designer integrations. These activities are written to the audit log.
Manage Diagnostics	Enable users to access the diagnostics information including the Rest Call Log, Java Thread dumps, and Metadata indexing. This activity is written to the audit log.
Manage Java Packages	Allows users to add and delete Java packages.
Manage Logging Settings	Grants users the permission to view the Logging page and edit the log4j configuration. This activity is written to the audit log.
Manage Maintenance Mode	Allows users to enable maintenance mode.
Manage Notifications Schemes	Enable users to manage notification schemes used for notification emails. See, Creating Notifications in a Notification Scheme. This activity is written to the audit log.
Manage Plug-ins	Grants users the permission to install new plug-ins; see Installing plug-ins. Install and delete activities are written to the audit log.
Manage Resource Roles	Grants users the permission to create and delete resource roles, which are created by some plug-ins. In most cases, you do not need to add or change resource roles because they are used internally.
Manage Security	Grants users the permission to manage security configuration, including roles, authentication realms, authorization realms, and tokens. Users without this permission cannot access or change the security functions. This activity is written to the audit log.
Manage Statuses	Grants users the permission to create and edit version, inventory, and snapshot statuses.
Manage System Properties	Grants users the permission to create and edit system properties. This activity is written to the audit log.
Manage Tags	Grants users the permission to create and edit tags. Users can apply tags only if they have the Edit Basic System Settings permission enabled.
Read Artifact Set List	Enables agent relays to use component version replication by status. Assign a user with this permission to an authentication token intended for an agent relay.
Release Locks	Enables users to manually release any locks currently held. See, Managing locks. This action is written to the audit log.
Run Deployment Triggers	Grants users permission to run the deployment from deployment triggers. The user will need to have the required permissions and roles as if they were executing the deployment manually.
View Audit Log	Grants users the permission to view the Audit Log page and download log files. This activity is written to the audit log.
View Basic System Settings	Enables users to view the options on the System Settings page. See, Server settings.
View Locks	Enables users to view any locks currently held. See, Managing locks. This action is written to the audit log.
View Network Settings	Grants users the permission to access the Network page.
View Output Log	Grants users the permission to view the Output Log page and download log files. This activity is written to the audit log.

Table 3. Web UI permissions
Permission	Description
Applications Tab	Access to the Applications tab; see Applications
Components Tab	Access to the Components tab; see Components
Configuration Tab	Access to the Configuration tab; see Creating, setting, and editing properties
Dashboard Tab	Access to the Dashboard tab.
Deployment Calendar Tab	Access to the Calendar tab; see Scheduling deployments
Processes Tab	Access to the Processes tab; see Generic processes
Reports Tab	Access to the Reports tab; see Reporting
Resources Tab	Access to the Resources tab; see Resources
Settings Tab	Access to the Settings tab; see Server settings and configuration
Work Items Tab	Access to the Work Items tab; see Responding to approval requests