Skip to main content
Mappings (/platform/environments/mappings) holds the fan-out mappings from vault secrets to runtime deployment targets. The page header reads Environments. It is the Mappings tab of the Secrets tab group, after Vaults, Connections, and Instances; Secrets opens from the Secrets tab of Settings under Platform. Open it to send a secret to a deployment as an environment variable, or to see whether the last deploy succeeded.
Secret mappings (dark)Secret mappings (light)

Secret mappings — Forge Console at /platform/environments/mappings

What you can do

  • Filter by Vault (default All Vaults). Mappings appear only once a vault is selected; the choice is kept in the URL as ?vault=.
  • + Add Mapping opens the mapping form: a vault secret, an instance, and the destination key it deploys as.
  • Deploy All (shown once a vault is selected) deploys every mapping in that vault.
  • Deploy on a row deploys that one mapping.
  • The row menu offers Edit and Delete. Delete asks for confirmation; the secret no longer deploys to that instance.

Columns

Deploy status

A row’s deploy status is idle, pending, success, or failed, shown as an icon next to Deploy. A failed deploy shows its error, or “Deploy failed.”.

Who can act

  • Viewing requires vaults:read; + Add Mapping appears only with vaults:manage.
  • Deploy also requires membership in the target instance. Without it, the button stays disabled with “Membership required. Go to Instances → ⋮ → Manage members to grant deploy access.”
Without vaults:read the page says “You need the secret_mappings:read permission to view Mappings.” The permission it checks is vaults:read.

Key state to watch

  • failed on a row: the secret did not reach the instance. Read the error, fix the instance connection or the key, then Deploy again.
  • “Mapping references a deleted resource — remove this mapping to clean up.”: the secret or instance is gone; delete the mapping.
  • A disabled Deploy with “Membership required”: add yourself on Instances through Manage Members.
  • A Last Deployed date older than the secret’s latest rotation: deploy the mapping so the target receives the current version.