Skip to content

Document short-lived catalog token exchange - #125

Open
mitch030504 wants to merge 1 commit into
DeliciousMeatPop:mainfrom
mitch030504:pr/catalog-token-rfc
Open

mitch030504 wants to merge 1 commit into
DeliciousMeatPop:mainfrom
mitch030504:pr/catalog-token-rfc

Conversation

@mitch030504

Copy link
Copy Markdown

Summary

Adds a design proposal for replacing the shared, long-lived catalog credential with short-lived, scoped catalog tokens.

The document records:

  • the current shared-key model and why obfuscation alone cannot make a shipped credential secret;
  • a token mint endpoint and the server-side contract (TLS, scope, expiry, rate limits, per-build attribution, revocation);
  • client behavior on expiry, 401, and repeated failures;
  • the security properties this does and does not provide.

Scope

Docs only. No runtime or server behavior changes are included.

This is a companion to #124, which hardens the current embedded credential envelope. This proposal covers the longer-term replacement for that credential.

docs/security/catalog-credentials.md

Add a proposal for replacing long-lived embedded catalog credentials with
short-lived, scoped tokens minted per installation. It records the threat
model, the server contract, the client behavior on expiry and revocation, and
why obfuscation alone cannot make a shipped credential secret.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant