--- title: Runbook — AUTHZ_INSUFFICIENT_PERMISSION (권한 부족) category: AUTHZ error_codes: [AUTHZ_INSUFFICIENT_PERMISSION, FORBIDDEN] severity: P3 owner: oncall last_updated: 2026-06-15 status: 초안 --- # Runbook: AUTHZ_INSUFFICIENT_PERMISSION (`runbook://authz/insufficient-permission`) ## 증상 - HTTP 403, `error.code=AUTHZ_INSUFFICIENT_PERMISSION`. - 토큰은 유효하지만 필요한 역할이나 권한이 없다. ## 진단 - IdP에서 사용자에게 준 역할을 확인한다. - 엔드포인트가 요구하는 권한 애너테이션을 확인한다. ## 조치 - 사용자에게 맞는 역할·권한을 준다. - 엔드포인트의 권한 요구가 맞는지 확인한다. ## 에스컬레이션 - 여러 사용자가 한꺼번에 영향을 받으면 접근 관리 팀에 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.