github fabriziosalmi/certmate v1.11.0
v1.11.0 — Scoped API Key Management

latest releases: v2.0.0, v1.12.0, v1.11.1...
10 hours ago

What's New

Scoped API Keys

Create and manage multiple API keys, each scoped to a role from the RBAC hierarchy (viewer/operator/admin). Replaces the single shared token model for teams and CI/CD pipelines.

Key features:

  • Create/List/Revoke lifecycle via API and UI
  • Role scoping — viewer keys can only read, operator keys can create/renew certs, admin keys have full access
  • Token formatcm_ prefix + 40 hex chars, stored as SHA-256 hash (plaintext shown once at creation)
  • Optional expiration — set an expiry date per key
  • Usage trackinglast_used_at updated on each authentication
  • Soft revocation — revoked keys retained for audit trail

API endpoints:

  • GET /api/keys — list all keys (admin only)
  • POST /api/keys — create a new scoped key (admin only)
  • DELETE /api/keys/<id> — revoke a key (admin only)

UI: New "API Keys" tab in Settings with create form, one-time token display with copy button, and keys table with role badges and revoke action.

Backward compatible: The legacy api_bearer_token in the General tab continues to work with full admin access. No migration needed.

Tests

  • 25 unit tests covering key CRUD, auth flow, revocation, expiration, and edge cases
  • Bandit clean

Full Changelog: v1.10.7...v1.11.0

Don't miss a new certmate release

NewReleases is sending notifications on new releases.