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.

TypeScript
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.

bash
sudo fz bootstrap platform credentials status
sudo fz bootstrap platform credentials show database-root