clean-architecture-backend-template/docs/runbooks/authz-insufficient-permission.md

title, category, error_codes, severity, owner, last_updated, status

title	category	error_codes	severity	owner	last_updated	status
Runbook — AUTHZ_INSUFFICIENT_PERMISSION (권한 부족)	AUTHZ	AUTHZ_INSUFFICIENT_PERMISSION	P3	oncall	2026-06-15	stub

Runbook: AUTHZ_INSUFFICIENT_PERMISSION (runbook://authz/insufficient-permission)

Symptoms

• HTTP 403 with error.code=AUTHZ_INSUFFICIENT_PERMISSION
• Valid token but missing required role or permission

Diagnosis

• Check user's assigned roles in IdP
• Review endpoint's required permission annotation

Action

• Grant correct role/permission to user
• Verify endpoint permission requirement is correct

Escalation

• Escalate to access-management team if bulk users affected

---

Stub: Phase D2 — author body after domain adoption. (feature-operational-runbook-contract D9)