Find secrets that need attention
A task that needs an expired token fails partway through. Check your secrets now and then, so you replace a token before it runs out and remove the ones nobody uses. The Health filter on the Secrets list finds each kind of problem in one step.
Who can do this: everyone, for the secrets they can see. Replacing a secret needs permission to edit it, and removing one needs permission to delete it.
Find them
- In the sidebar, select Directory, then the Secrets tab.
- Open Health above the list and pick what to look for:
- Expired — the secret's expiry date has passed. Tasks that use it fail.
- Expiring (7 days) — it expires within a week.
- Never used — no task has fetched it yet.
- Select Only mine too, if you only want to see the secrets you created.
- Read the rows. An expired secret shows Expired after its name in red, and one about to expire shows Expires in 3d in amber. Used says when a task last fetched it.
- Select a secret's name to open it, then act on it:
- To put in a new token or key, type it into the field on Details and select Save. See Replace or delete a secret.
- To check who else relies on it before you change it, open Access: the projects it is attached to.
- To remove one nobody needs, select ⋯ on its row, then Delete.
- Set Health back to Any, or select Clear filters when nothing matches, to see every secret again.
The list remembers your filters the next time you open it in the same browser, so check Health before you read the list another day.
Remove many unused secrets at once
- Pick Never used in Health.
- Tick the rows to remove, or tick the header's checkbox for every row shown.
- Select Delete in the bar above the list.
- In the dialog, such as Delete 4 secrets, type the count when more than one is ticked, then select Delete with the count, such as Delete 4. This can't be undone.
Related
- How secrets work — who owns a secret and how tasks receive it.
- Attach a secret to a project — what changes for a project when you remove one.
- Secrets — every filter and column of the list.