auth/CHANGELOG.md

Changelog

v1.1.2 — 2026-08-08

Patch — documentation fix plus coordinated framework version alignment.

Fixed

• README wiring example: rbac.NewClaimsPermissionProvider("perms", authmw.GetClaims) (was missing the getClaims argument); install line updated to v1.1.2.

Changed

• Bumped contracts, core, web to v1.1.2.

v1.1.1 — 2026-08-07

Patch — coordinated framework version alignment. Bumped contracts, core, web to v1.1.1. No code or API changes.

v1.1.0 — 2026-08-07

Coordinated framework version alignment — released in lockstep at v1.1.0.

Changed

• Bumped einherjar dependencies (contracts, core, web) to v1.1.0 via go get + go mod tidy. No code or API changes.

v1.0.0

Initial release.

authmw

• BagEnricher type — func(bag security.SecurityBag, r *http.Request) security.SecurityBag; enriches the request-scoped SecurityBag after the base Identity is built. Register via WithBagEnricher. Multiple enrichers run in registration order, each receiving the bag returned by the previous one.
• SetTokenData — integration contract for provider packages (auth-jwt, auth-firebase). Stores uid and raw claims in context via typed keys; consumed by EnrichmentMiddleware.
• GetClaims — exported accessor for raw token claims stored by SetTokenData. Available to custom IdentityEnricher implementations and ClaimsPermissionProvider.
• EnrichmentMiddleware — builds a security.SecurityBag from uid+claims. Calls the application IdentityEnricher, wraps the Identity in a SecurityBag, runs all registered BagEnricher functions in order, then stores the bag via security.SetBagInContext. Accepts logging.Logger; routes errors through httputil.Error (401 on missing token, 500 on enricher failure).
• AuthzMiddleware — per-route permission gate. Returns 401 on missing identity, 403 on provider error or insufficient permissions (fail-closed).
• IdentityEnricher interface — implemented by the application to load user data from uid+claims.
• EnrichOpt type — func(*enrichConfig).
• WithTenantHeader(header string) EnrichOpt — reads Identity.TenantID from a named request header. Implemented as a BagEnricher internally.
• WithBagEnricher(fn BagEnricher) EnrichOpt — registers a custom enricher. Use for any attribute beyond TenantID: hardware IDs, grant codes, etc.

rbac

• NewClaimsPermissionProvider — reads pre-computed bitmasks from JWT claims in context. Flat format: claims[claimsKey][resource] = mask. Wildcard "*" fallback. Handles int64, float64, json.Number.
• NewCachedPermissionProvider — wraps any security.PermissionProvider with TTL caching. Default cache key: "rbac:{uid}:{resource}" (single-tenant) or "rbac:{tenantID}:{uid}:{resource}" (multi-tenant). TenantID sourced from the SecurityBag in context automatically. Accepts ...CachedOpt for customization.
• CachedOpt type — func(*cachedConfig).
• WithCacheKey(fn func(security.SecurityBag, string, string) string) CachedOpt — overrides the default cache key function. Use when additional bag attributes (hardware IDs, grant codes) must be part of the key.
• NewChainPermissionProvider — tries providers in order; returns first non-zero mask. Errors short-circuit.
• Cache interface — pluggable cache backend. Satisfied by einherjar/cache-valkey via duck typing.