# SSH temporary access

[Temporary access overview](/docs/concepts/temporary-access) covers target setup, connection methods, and credential handling.

seekrit issues **short-lived SSH certificates** for a keypair generated on the
requesting machine. The private key stays on that machine.

seekrit acts as an SSH **certificate authority**. When you register an SSH
target, a CA keypair is generated **in your browser/CLI**; only the CA *private*
key is wrapped to the broker (stored as ciphertext), and the CA *public* key is
printed for you to install on your hosts once:

```
# /etc/ssh/sshd_config
TrustedUserCAKeys /etc/ssh/seekrit_ca.pub
```

Minting a certificate then works like this:

1. The machine that will connect generates an **ephemeral SSH keypair locally**.
2. It sends seekrit **only the public key**, plus the login principals and a TTL.
3. The broker signs a certificate over that public key (`valid principals`,
   `valid before = now + TTL`) using the CA key, decrypted transiently in the DO.
4. seekrit returns the **certificate** — a public artifact — and you connect:

```
ssh -i id_ed25519 -o CertificateFile=id_ed25519-cert.pub deploy@host
```

The private key never leaves the requesting machine, and a certificate cannot
authenticate without it — so, like the Postgres verifier, what seekrit handles is
never sufficient to log in. This is tier 1 (verifier injection): the public key
is the "verifier". Certificates use Ed25519, and the CA-signing (`in_do`)
executor is the only mode for now.

> **Note:** **Revocation is by expiry.** A certificate is a self-contained bearer artifact,
>   so seekrit v1 relies on **short TTLs** rather than a revocation list — keep
>   lifetimes tight (minutes to a few hours). Revoking a lease records the event in
>   the ledger and audit trail, but an already-issued certificate stays valid until
>   it expires. A published KRL (`RevokedKeys`) for early revocation is planned.

See the [CLI reference](/docs/reference/cli) and [API reference](/docs/reference/api) for commands and endpoints.
