| name | authorization-review |
| description | Review authorization for complete server-side enforcement of roles, permissions, ownership, tenant boundaries, object access, privileged actions, and policy changes. |
Authorization Review
Use when reviewing access-control policy, protected operations, multi-tenant behavior, administrative functions, resource ownership, or changes that affect who may do what.
Procedure
- Build an actor-action-resource matrix from actual product behavior. Include ordinary users, privileged roles, service identities, background workers, support/admin paths, anonymous callers, and disabled or partially provisioned identities where relevant.
- Identify the authoritative policy source and every enforcement point. Authorization must be enforced at trusted server or service boundaries, not inferred from hidden UI, route visibility, client state, or caller-supplied role fields.
- Review object-level access. For every identifier, nested resource, batch operation, export, search, file, attachment, and indirect reference, verify the caller is allowed to access that specific object rather than merely the endpoint type.
- Review tenant and organizational boundaries end to end. Query filters, caches, background jobs, event consumers, bulk operations, analytics/export paths, and administrative tools must preserve the same isolation guarantees as direct reads and writes.
- Review role and permission composition. Look for unintended privilege inheritance, wildcard permissions, inconsistent policy precedence, stale privileges after role changes, default-allow behavior, and paths that skip the central policy layer.
- Review privileged and sensitive operations for stronger requirements where appropriate: reauthentication, dual control, step-up authentication, explicit scope, audit logging, or narrower service credentials.
- Check confused-deputy and service-to-service cases. A trusted service acting on behalf of a user must not silently convert the user's limited authority into the service's broader authority.
- Review creation and mutation paths for ownership assignment, mass assignment, parent-child relationship changes, invitation/transfer flows, and privilege-bearing fields that a caller should not be able to set directly.