How should per-workload API keys/accounts be provisioned, rotated, and documented? #12

Closed
opened 2026-08-25 04:39:55 +00:00 by haylan · 1 comment
Owner

Part of #9

Question

Given the tool chosen in #10, what's the actual workflow for issuing a per-workload API key/account: who/what creates it (CLI, admin UI, API call), where the credential is handed to each downstream workload, how it's stored, and how revocation/rotation works? Should mirror the local-usage-docs pattern from map #1 (#6) — a doc a future session can follow to onboard a new workload (e.g. the code-reviewer tool or Paperless-OCR) without re-deriving the process.

Part of #9 ## Question Given the tool chosen in #10, what's the actual workflow for issuing a per-workload API key/account: who/what creates it (CLI, admin UI, API call), where the credential is handed to each downstream workload, how it's stored, and how revocation/rotation works? Should mirror the local-usage-docs pattern from map #1 (#6) — a doc a future session can follow to onboard a new workload (e.g. the code-reviewer tool or Paperless-OCR) without re-deriving the process.
haylan added the wayfinder:grilling label 2026-08-25 04:39:55 +00:00
haylan added a new dependency 2026-08-25 04:40:14 +00:00
haylan self-assigned this 2026-08-25 04:51:44 +00:00
Author
Owner

Resolved via grilling.

Keys created by hand in LiteLLM's Admin UI, named as a workload-purpose slug (e.g. paperless-ocr, gitea-code-review) — the name is the ledger, no separate tracking doc, since LiteLLM's dashboard already lists spend per key. No budget/rate limit set by default (this is a for-fun shadow estimate, not real accounting or resource protection — set one later only if a specific workload needs a tripwire). Key is dropped into that workload's own .env, never committed to this repo. Revocation is manual via the Admin UI, triggered only by retirement or suspected compromise — no scheduled rotation.

Documented in docs/proxy-key-onboarding.md, committed on main.

Resolved via grilling. Keys created by hand in LiteLLM's Admin UI, named as a workload-purpose slug (e.g. `paperless-ocr`, `gitea-code-review`) — the name is the ledger, no separate tracking doc, since LiteLLM's dashboard already lists spend per key. No budget/rate limit set by default (this is a for-fun shadow estimate, not real accounting or resource protection — set one later only if a specific workload needs a tripwire). Key is dropped into that workload's own .env, never committed to this repo. Revocation is manual via the Admin UI, triggered only by retirement or suspected compromise — no scheduled rotation. Documented in docs/proxy-key-onboarding.md, committed on main.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Reference: haylan/LLM-Server#12