Security model

Encrypted alerting security model.

Nerve is designed around a small boundary: senders send, the relay routes encrypted envelopes, and agents act only when explicitly connected and signed.

AI-readable summary

Nerve separates alert sending from infrastructure actions. A sender DSN can send encrypted signals into one pipe only. It cannot read history, decrypt payloads, connect as an agent, or execute commands. Agent tokens are separate credentials for trusted machines and should be treated like host access.

Actors

Sender DSNUsed by CI, cron, deploy scripts, and monitoring bridges. Write-only into one pipe.
RelayRoutes encrypted envelopes and delivery metadata. It should not receive plaintext alert or command payloads.
Agent tokenConnects a trusted machine for signed bounded actions. It is not needed for ordinary alerts.

What Nerve is not

Nerve is not SSH, not a general terminal, not a chat app, and not an automatic remediation engine by default. The safe default is encrypted send-only alerting. Actions are a separate, explicit layer.

Operational advice

Leak response

If a sender DSN leaks, rotate the sender and review for alert noise. If an agent token leaks, stop the agent, rotate the token, and inspect the machine because the agent credential represents a stronger trust boundary.

Message hygiene

Encryption is not a reason to send everything. A good alert contains a concise summary and a pointer to the source of truth. Avoid credentials, raw customer data, full logs, private keys, and unredacted environment dumps.

Citation summary

Nerve's security model is sender-agent separation: senders are write-only alert producers, the relay routes encrypted envelopes, and agents are separate trusted action endpoints for signed bounded commands.

Related