This documentation relates to an earlier version of Bamboo.
View

Unknown macro: {spacejump}

or visit the current documentation home.

A plan permission is the ability to perform a particular operation in relation to a build plan. For each plan, different permissions can be granted to particular groups and/or users.

The following plan permissions are available:

Plan permission

Description

Can be granted to

'View'

Permission to:

  • view this plan's build results
  • add comments or labels to this plan's build results¹

    People who don't have the 'View' permission will not know that the plan exists.

- a particular user
- a particular group
- all logged-in users
- anonymous users²

'Edit'

Permission to view and edit this plan's configuration, except for the plan's permissions.

- a particular user
- a particular group
- all logged-in users
- anonymous users²

'Build'

Permission to:

  • manually start/stop a build for this plan.
  • enable/disable this plan from submitting builds to the queue.

- a particular user
- a particular group
- all logged-in users
- anonymous users²

'Clone'

Permission to copy this plan when creating a new plan.
(Note: only users with the 'Create Plan' global permission can create new plans.)

- a particular user
- a particular group

'Admin'

Permission to:

  • edit this plan's permissions.
  • delete this plan's build results and working files.

- a particular user
- a particular group 

¹ Only logged-in users (not anonymous users) can label or comment on a build result.
² Anonymous users cannot access Bamboo at all unless they have been granted the 'Access' global permission. See Allowing Anonymous Users to access Bamboo.

Anyone with the 'Admin' global permission automatically has all plan permissions for every plan.

The processes for granting and revoking plan permissions are described below. Note that, for ongoing ease of management, it is recommended that you grant permissions to groups rather than to individual users.

To grant plan permissions to a user,

(info) If you are creating a new plan, start at step 5.

  1. Click 'Home' to go to the Dashboard.
  2. Click the 'All Plans' tab.
  3. Locate the plan in the list and click this icon:
  4. The 'Configuration' tab will be displayed. Click the 'Permissions' tab (see screenshot below).
  5. In the 'Grant permission to' list at the bottom of the screen, select 'User'.
  6. Type the username into the box, or click the following icon to select from a list of users:
    (info) Note that the assignment of permissions to LDAP users and groups in Bamboo is case sensitive. For instance, if the username of the LDAP user is 'Bob', you will need to type in 'Bob' (not 'bob' or 'BOB').
  7. Click the 'Add' button.
  8. The user will be added to the list of users on the 'Permissions' tab. Select the check-box for each permission that you wish to grant to this user.
  9. Click the 'Save' button (check/uncheck the 'Enable Plan' checkbox to create your plan as enabled/disabled as desired).

To grant plan permissions to a group,

(info) If you are creating a new plan, start at step 5.

  1. Click 'Home' to go to the Dashboard.
  2. Click the 'All Plans' tab.
  3. Locate the plan in the list and click this icon:
  4. The 'Configuration' tab will be displayed. Click the 'Permissions' tab (see screenshot below).
  5. In the 'Grant permission to' list at the bottom of the screen, select 'Group'.
  6. Type the group name into the box.
    (info) Note that the assignment of permissions to LDAP users and groups in Bamboo is case sensitive. For instance, if the name of the LDAP group is 'Dev', you will need to type in 'Dev' (not 'dev' or 'DEV').
  7. Click the 'Add' button.
  8. The group will be added to the list of groups on the 'Permissions' tab. Select the check-box for each permission that you wish to grant to this group.
  9. Click the 'Save' button (check/uncheck the 'Enable Plan' checkbox to create your plan as enabled/disabled as desired) .

To grant plan permissions to all Bamboo users,

(info) If you are creating a new plan, start at step 5.

  1. Click 'Home' to go to the Dashboard.
  2. Click the 'All Plans' tab.
  3. Locate the plan in the list and click this icon:
  4. The 'Configuration' tab will be displayed. Click the 'Permissions' tab (see screenshot below).
  5. Locate 'Logged in users' (under 'Other').
  6. Select the check-box for each permission that you wish to grant to all Bamboo users.
  7. Click the 'Save' button (check/uncheck the 'Enable Plan' checkbox to create your plan as enabled/disabled as desired).

To grant plan permissions to anonymous users,

(info) If you are creating a new plan, start at step 5.# Click 'Home' to go to the Dashboard.

  1. Click the 'All Plans' tab.
  2. Locate the plan in the list and click this icon:
  3. The 'Configuration' tab will be displayed. Click the 'Permissions' tab (see screenshot below).
  4. Locate 'Anonymous users' (under 'Other').
  5. Select the check-box for each permission that you wish to grant to all anonymous users.
  6. Click the 'Save' button (check/uncheck the 'Enable Plan' checkbox to create your plan as enabled/disabled as desired).

To revoke plan permissions,

(info) If you are creating a new plan, start at step 5.# Click 'Home' to go to the Dashboard.

  1. Click the 'All Plans' tab.
  2. Locate the plan in the list and click this icon:
  3. The 'Configuration' tab will be displayed. Click the 'Permissions' tab (see screenshot below).
  4. Locate the relevant user/group/all logged-in users/anonymous users.
  5. Deselect the check-box for each permission that you wish to revoke from the user/group/all users/anonymous users.
    (info) If you deselect all permissions for a user or group, that user or group will disappear from the 'Permissions' tab for this plan.
  6. Click the 'Save' button (check/uncheck the 'Enable Plan' checkbox to create your plan as enabled/disabled as desired).

Screenshot: Plan Permissions



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.