Secrets with a scope.
Give each workload a precise capability, rather than a shared password.
Bind exact identities
Credential bindings include workspace, project, deployment and environment coordinates. Alias resolution refuses mismatched scope. Keep database administrator credentials outside application containers and use least-privileged application identities or the scoped database service.
Let the SDK find its Agent
Use the Vault SDK in server APIs and workers; browsers never receive workload credentials or connect to the Unix socket. The SDK prefers the local Agent socket, selected by FORGEZERO_SOCKET or its standard path. The Agent holds the deployment’s authenticated PQ connection to ForgeZero and resolves only the aliases granted to its exact deployment and environment. Optional Vault data access requires an additional declared binding. No Metal or provisioning authority is exposed through the application socket.
import { createVault } from '@forgezero/vault';
const vault = createVault({
deploymentKey: 'your-deployment',
environmentKey: 'production'
});
const value = await vault.get('DATABASE'); Connect without a local Agent
Outside managed compute, provide the SDK’s scoped FORGEZERO_API_KEY or an explicit external credential and the Vault API origin. The SDK signs requests and requires responses sealed to the request’s PQ recipient. A refused local read never switches to a different credential or silently falls back to bootstrap storage.
Initialize once
Bootstrap must enable database authentication and establish the initial administrator password before the application starts. A repeated install preserves the existing password and persistent data. Updates must not silently reset credentials or expose a temporary unauthenticated database on a public address.
Separate inspection from reveal
Operational status should expose only binding names and readiness. Credential values belong in an explicit privileged terminal reveal, not deployment receipts, command arguments, browser bundles or logs. The local Agent candidate provides privileged terminal-only reveal for individual bootstrap aliases. Account passkeys and workspace recovery factors are not server credentials that an operator can export.
sudo fz bootstrap platform credentials status
sudo fz bootstrap platform credentials show database-root