Open Tokens (/tokens) as admin.
- Name the token (display only).
- Pick a role:
admin,operator, orreadonly. - Create. Copy the secret immediately.
Stored as SHA-256. token_prefix is what you see later in the list. You cannot recover the full secret.
operator without a group is helpdesk across the tenant: reservations, assignments, and force-release. DHCP option writes are 403. Operators cannot list tenants, DNS servers, webhooks, or tokens. readonly cannot mutate. A readonly token that joins a group stays read-only.
Attach a group on create (group_ids) to limit writes to a prefix, a subnet, or a pool. An admin token cannot join a group. A group with no grants still scopes the token: it can read the tenant and cannot write. The Addresses tree still shows every subnet. A write outside the grant is 403. Another tenant is 404. Who can change a subnet.
Token-create is rate-limited (10 / min / IP). Do not put the token in query strings or logs. Do not enable Access-Control-Allow-Origin: *. XSS on the Lattice origin can still read sessionStorage — treat the console host like a secret. The secret lives in this tab (memory + sessionStorage), not localStorage.
lattice-install already minted the first admin. Prefer /etc/lattice/bootstrap.token. Minting from curl only works on the server (loopback) while the table is empty:
curl -s -X POST http://127.0.0.1:8080/api/v1/tokens \
-H 'content-type: application/json' \
-d '{"name":"admin","role":"admin"}'