mirror of
https://github.com/shankar0123/certctl.git
synced 2026-06-07 14:11:31 +00:00
feat(auth/rbac): scope_type+scope_id+expires_at on role grants (HIGH-10)
Audit 2026-05-10 — close HIGH-10 from the HANDOFF.md backend batch
(item 1). Per-actor scoped + time-bound role grants are now
expressible via the API.
Migration 000043: adds scope_type TEXT NOT NULL DEFAULT 'global' +
scope_id TEXT to actor_roles. Constraints:
- actor_roles_scope_type_enum: scope_type ∈ {global, profile, issuer}
- actor_roles_scope_id_required_when_not_global: scope_id is NULL
iff scope_type='global'
- Uniqueness extended: (actor_id, actor_type, role_id, scope_type,
scope_id, tenant_id) — so an operator can grant the same role to
the same actor scoped to multiple profiles/issuers (e.g.
r-operator on p-finance AND on p-engineering).
Index idx_actor_roles_scope for non-global lookup hot paths.
Domain: ActorRole.ScopeType (ScopeType enum) + ScopeID (*string).
Authorizer.CheckPermission already understands the tuple via the
parallel role_permissions columns; this addition gives operators a
per-actor knob without forking roles.
Postgres repo: Grant writes scope_type+scope_id with ON CONFLICT keyed
on the new uniqueness tuple. Defaults to (global, NULL) when caller
omits.
Handler: assignRoleRequest extended with scope_type / scope_id /
expires_at. Validation:
- role_id required (unchanged)
- scope_type defaults to 'global'; allowed values global/profile/
issuer; anything else → 400
- scope_id required when scope_type ∈ {profile, issuer}; rejected
(must be empty) when scope_type='global'
- expires_at must be in the future when present; nil = standing
Regression matrix in internal/api/handler/auth_test.go (6 cases):
- TestAssignRoleToKey_HIGH10_ProfileScopeBoundGrantPersists
- TestAssignRoleToKey_HIGH10_TimeBoundGrantPersists
- TestAssignRoleToKey_HIGH10_RejectsScopeIDWithGlobalScope
- TestAssignRoleToKey_HIGH10_RejectsMissingScopeIDOnProfile
- TestAssignRoleToKey_HIGH10_RejectsPastExpiry
- TestAssignRoleToKey_HIGH10_RejectsInvalidScopeType
HIGH-10 marked CLOSED in audit-doc — the v3 deferral from the prior
session is reversed; everything lands in v2.
Refs: cowork/auth-bundles-fixes-2026-05-10/HANDOFF.md item 1
cowork/auth-bundles-audit-2026-05-10.md HIGH-10
This commit is contained in:
@@ -0,0 +1,16 @@
|
||||
-- Rollback for 000043_actor_role_scope.up.sql
|
||||
-- Note: TRUNCATE is destructive of any rows added with non-global scope.
|
||||
-- That's acceptable for a rollback (forward-only design).
|
||||
ALTER TABLE actor_roles
|
||||
DROP CONSTRAINT IF EXISTS actor_roles_actor_role_scope_unique;
|
||||
ALTER TABLE actor_roles
|
||||
DROP CONSTRAINT IF EXISTS actor_roles_scope_id_required_when_not_global;
|
||||
ALTER TABLE actor_roles
|
||||
DROP CONSTRAINT IF EXISTS actor_roles_scope_type_enum;
|
||||
DROP INDEX IF EXISTS idx_actor_roles_scope;
|
||||
ALTER TABLE actor_roles
|
||||
DROP COLUMN IF EXISTS scope_type,
|
||||
DROP COLUMN IF EXISTS scope_id;
|
||||
ALTER TABLE actor_roles
|
||||
ADD CONSTRAINT actor_roles_actor_id_actor_type_role_id_tenant_id_key
|
||||
UNIQUE (actor_id, actor_type, role_id, tenant_id);
|
||||
@@ -0,0 +1,46 @@
|
||||
-- =============================================================================
|
||||
-- 2026-05-10 Audit / HIGH-10 closure
|
||||
-- =============================================================================
|
||||
--
|
||||
-- Per-actor scope override on role grants. Pre-fix, actor_roles had
|
||||
-- expires_at (already shipped) but no scope_type/scope_id columns, so
|
||||
-- "give Alice operator over profile X only" wasn't expressible at the
|
||||
-- grant layer — the only path was creating a scoped role and granting
|
||||
-- that. This migration adds the per-grant scope tuple so an operator
|
||||
-- can attach Alice to the standing r-operator role but scope the
|
||||
-- grant to profile X.
|
||||
--
|
||||
-- scope_type defaults to 'global' to preserve existing rows; scope_id
|
||||
-- stays NULL when scope_type='global'. Authorizer.CheckPermission
|
||||
-- already understands the tuple shape (role_permissions carries the
|
||||
-- same columns); the actor-role addition gives operators a second
|
||||
-- knob without forcing them to fork roles.
|
||||
-- =============================================================================
|
||||
|
||||
ALTER TABLE actor_roles
|
||||
ADD COLUMN IF NOT EXISTS scope_type TEXT NOT NULL DEFAULT 'global',
|
||||
ADD COLUMN IF NOT EXISTS scope_id TEXT;
|
||||
|
||||
ALTER TABLE actor_roles
|
||||
ADD CONSTRAINT actor_roles_scope_type_enum
|
||||
CHECK (scope_type IN ('global', 'profile', 'issuer'));
|
||||
|
||||
ALTER TABLE actor_roles
|
||||
ADD CONSTRAINT actor_roles_scope_id_required_when_not_global
|
||||
CHECK (
|
||||
(scope_type = 'global' AND scope_id IS NULL) OR
|
||||
(scope_type IN ('profile', 'issuer') AND scope_id IS NOT NULL)
|
||||
);
|
||||
|
||||
-- The (actor_id, actor_type, role_id, tenant_id) uniqueness must
|
||||
-- relax: an operator can grant the same role to the same actor at
|
||||
-- different scopes (e.g. r-operator on profile-A AND on profile-B).
|
||||
ALTER TABLE actor_roles
|
||||
DROP CONSTRAINT IF EXISTS actor_roles_actor_id_actor_type_role_id_tenant_id_key;
|
||||
|
||||
ALTER TABLE actor_roles
|
||||
ADD CONSTRAINT actor_roles_actor_role_scope_unique
|
||||
UNIQUE (actor_id, actor_type, role_id, scope_type, scope_id, tenant_id);
|
||||
|
||||
CREATE INDEX IF NOT EXISTS idx_actor_roles_scope
|
||||
ON actor_roles(scope_type, scope_id) WHERE scope_id IS NOT NULL;
|
||||
Reference in New Issue
Block a user