Move a secret into NodeVault
A secret saved before your organization set up NodeVault, or one you skipped on the Migrate step of setup, is still sealed the ordinary way. Move it into NodeVault and only your organization's nodes can open it. Jaah never sees its values again: you type them in your browser, which seals them with the NodeVault key before they are sent.
Who can do this: anyone who may change the secret: its owner for a personal secret, an Org Owner or Org Admin for an organization or system one. Your organization must have set up NodeVault, on a plan that includes it.
Have each of the secret's values to hand, such as its token or password. Jaah can't fill them in for you.
- In the sidebar, select Directory, then the Secrets tab.
- Select the secret's name. It opens on the Details tab beside the list.
- Tick NodeVault, under Type. Hover the label to see the key it will be sealed with, such as Only your nodes can open its secrets. Key 1a2b3c4d5e6f.
- Each secret field now says Re-enter to turn NodeVault on. Type each value again. Fields that aren't secret, such as an address or a user name, keep what they hold.
- Select Save. If you left a secret field empty, it says Re-enter and the field's name to turn NodeVault on. Fill it in and select Save again.
- Check the list: the secret now shows ◈ beside its name. Hover the mark to read NodeVault · key and the key's short hash.
Tasks keep using the secret under the same name and the same projects; from now on their node opens it.
If there is no NodeVault box
The box appears only where the secret can use NodeVault. It is missing when:
- your organization hasn't set up NodeVault yet, or your plan doesn't include it;
- the secret's type can't use NodeVault, such as a service you sign in to with Connect;
- something in Jaah itself needs to open this secret, so it must stay readable to Jaah.
Ask an Org Owner or Org Admin to check Settings, then Features, then NodeVault.
Take a secret out of NodeVault
- Open the secret as in steps 1 and 2 above.
- Clear NodeVault. The secret fields empty at once.
- Type each value again. Each field says Re-enter to turn NodeVault off.
- Select Save. The ◈ mark goes from the row.
You can always take a secret out, even after your plan stops including NodeVault.
Related
- How NodeVault works: where the key lives and how a task opens a sealed secret.
- Set up NodeVault: move many secrets at once on its Migrate step.
- Rotate the NodeVault key: re-seal every secret under a new key.
- Replace or delete a secret: put in a new value without moving it.
- Every field on a secret's page: Secrets.