Search docs

Docs search

Authorization

Review implemented validation rules for missing, inconsistent, or misplaced authorization enforcement.

Why it matters

Authorization findings highlight places where protected Cloud workflows need clear server-side access-control evidence.

Overview

Review implemented validation rules for missing, inconsistent, or misplaced authorization enforcement.

Authorization findings highlight places where protected Cloud workflows need clear server-side access-control evidence.

Why it matters

Cloud uses this guidance to help teams interpret local validation findings in organization context without turning the docs into implementation notes.

When this domain drifts, findings become harder to triage, ownership becomes less clear, and architecture review depends too much on individual memory.

Good architectural practices

  • Protected operations with visible authorization checks.
  • Consistent enforcement across related resource operations.
  • Authorization logic placed at reusable request or service boundaries.

Common anti-patterns

  • Missing authorization enforcement
  • Inconsistent authorization within resource
  • Authorization logic placed in wrong layer

Relationship to other architecture areas

This domain usually overlaps with neighboring validation categories. Use the related pages below to understand the adjacent architecture concerns before changing policy, suppressing a finding, or accepting risk.

Implemented rules

These are the currently implemented rules in this category. Use this table for category-level orientation, then open the Rule Catalog when you need rule-specific examples and remediation guidance.

Rule IDRule titleCategorySeverityShort explanationExample violationRemediation guidanceRule detail
AP-AUTH-001Missing authorization enforcementAuthorizationwarningFlags protected operations without clear authorization enforcement evidence.PATCH /organizations/:id/policy-config updates policy after only checking that a user is signed in.Add the expected role, permission, or organization access check. Use the local authorization helper used by adjacent endpoints. Add tests for allowed and forbidden callers.View rule page
AP-AUTH-002Inconsistent authorization within resourceAuthorizationwarningFlags resource endpoints that enforce authorization inconsistently across operations.Deleting a token requires admin access, but creating a token only requires membership.Compare authorization across all operations for the resource. Standardize on the intended helper or guard. Document intentional differences and cover them with tests.View rule page
AP-AUTH-003Authorization logic placed in wrong layerAuthorizationwarningFlags authorization logic placed in a layer that makes enforcement hard to reuse or audit.A repository checks whether the current user is an admin before returning rows.Move authorization to the request guard, policy service, or application service boundary. Keep persistence methods free of caller-role decisions. Retain UI gating only as presentation feedback, not enforcement.View rule page
Authorization | ArchPilot Docs