0.0.1
APR 26, 2026
feature Initial release
First public version. Eight verification endpoints, structured findings, JWKS rotation analysis, CI OIDC support, and a public health endpoint for monitoring.
Verification
POST /v1/inspect/tokendecodes any JWT and reports structural-risk warnings (ALG_NONE,JKU_PRESENT,KID_MISSING,EXP_MISSING) without making trust claims.POST /v1/validate/jwtruns full verification — signature, issuer, audience, algorithm, time, required claims — against either an inlineVerifyPolicyor a registered issuer profile. Always returns 200 with structuredfindings[]on failure.POST /v1/test/auth-regressionbatches multiple validation checks and aggregates a suite-level pass/fail, withexpected_failure_codesfor negative fixtures.
OIDC + CI
POST /v1/providers/discoverperforms OpenID Connect Discovery 1.0 with normalized output and JWKS reachability classification.POST /v1/lint/oidc-configstatic-analyses an OIDC config for weak algorithms, insecure URIs, JWKS reachability, and discovered/configuredjwks_urimismatch.POST /v1/validate/ci-oidcvalidates GitHub Actions and GitLab CI OIDC tokens with provider-specific claim assertions (expected_repository,expected_ref,expected_project_path,expected_ref_protected).
Operations
POST /v1/validate/jwks-rotationclassifies rotation between two JWKS snapshots asno_change,safe_overlap,overlap, ordisjoint, with optional sample-token verification.GET /v1/presets/{provider}returns starterVerifyPolicytemplates forauth0,okta,cognito,github_actions, andgitlab.GET /v1/healthreports overall status plus component-level state (api, profile_registry, jwks_cache, http_client) for external monitoring and the public status page.
Platform
- Algorithm support: HS256/HS384/HS512, RS256/RS384/RS512, ES256/ES384, EdDSA.
- JWKS resolver with single-flight per-profile refresh, Cache-Control
max-agehonored up to a configured upper bound, and per-profile cold-cache hydration. - Per-plan rate limiting and monthly verify quotas.
- Audit middleware tags every request with a
request_id, duration, status, and (on validation failures) the first failing dimension asfailure_category. - Structured
Findingtaxonomy: every error code listed in the Errors reference with severity, evidence, and remediation hints.
Available now
- HTTP API exposed under
/v1/. - OpenAPI 3.1 spec for client generation, downloadable from the docs index.
- Public status page polling
/v1/healthevery 30s with component-level pips. - Examples in curl, Node, Python, GitHub Actions, and GitLab CI on the Examples page.