Bamboo 3.4 : Configuring a Plan's Permissions

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.

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

See the Plan Permissions Summary section below for a description of each Plan permission.

Granting Plan Permissions

To grant Plan permissions:

  1. Navigate to the configuration for the desired Plan, as described on Editing a Plan.
  2. Click the 'Permissions' tab to display the Plan's current Permissions settings.
  3. Grant who has permission to access this Plan as described:
    • To grant Plan permissions to a user:
      1. In the 'Grant permission to' list at the bottom of the screen, select 'User'.
      2. Type the username into the box, or click the icon to select from a list of users in the resulting Select User window.
        (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').
      3. Click the 'Add' button. The user will be added to the list of users on the 'Permissions' tab.
      4. Select the check boxes of each permission you wish to grant to this user.
    • To grant Plan permissions to a group:
      1. In the 'Grant permission to' list at the bottom of the screen, select 'Group'.
      2. 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').
      3. Click the 'Add' button. The group will be added to the list of groups on the 'Permissions' tab.
      4. Select the check boxes of each permission that you wish to grant to this group.
    • To grant Plan permissions to all Bamboo users:
      1. Locate 'Logged in users' (under 'Other') and select the check boxes of each permission that you wish to grant to all Bamboo users.
    • To grant Plan permissions to anonymous users:
      1. Locate 'Anonymous users' (under 'Other') and select the check boxes of each permission that you wish to grant to all anonymous users.
  4. Click the 'Save' button.

Revoking Plan Permissions

To revoke Plan permissions:

  1. Navigate to the configuration for the desired Plan, as described on Editing a Plan.
  2. Click the 'Permissions' tab (see screenshot below).
  3. Locate the relevant User / Group / Other (group of) users.
  4. Clear the check box of each permission that you wish to revoke from these (group of) users.
    (info) If you clear all permissions for a user or group, that user or group will be removed from the 'Permissions' page.
  5. Click the 'Save' button.

Screenshot above: Plan Permissions

Plan Permissions Summary

Please note, anyone with the 'Admin' global permission automatically has all plan permissions for every plan. 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¹
    (info) 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.

Notes

Related Topics

Editing a Plan
Granting Plan Permissions to Users or Groups

Attachments: