Skip to main content

Attach a secret to a project

A secret attached to a project is given to every task on that project. Attach one when a project's tasks all need the same service, for example the team's Jira or a deployment account.

Who can do this: you need to be able to edit the project — as its Project Maintainer, or as an Org Owner or Admin. Then a personal secret can be attached only by its owner; an organization secret by its owner or an Org Owner or Admin. A System secret can't be attached to a project. When you aren't allowed, the tab says why after you select Attach.

Attach it​

The Access tab: Owner, the projects it is attached to, and the Project picker with Attach

  1. In the sidebar, select Directory, then the Secrets tab.
  2. Select the secret's name. It opens in a pane beside the list.
  3. Select the Access tab. It shows the secret's Owner and the Projects it's attached to.
  4. Pick the Project.
  5. Select Attach.

The project now appears under Projects. Tasks that start on it from now on receive the secret.

Detach it​

  1. Open the secret's Access tab, as above.
  2. Find the project under Projects.
  3. Select Detach on its row.
  4. Confirm.
  5. Check that the project is gone from the list.

Tasks on that project stop receiving the secret.