oto/agent-ui/definition/components/authorization-state/index.md
toki 4ad5a7340d feat(agent-ui): UI 정의서 및 템플릿 업데이트
- agent-ui 정의서 전체 구조 생성 (view/component/frame/wireframe)
- UI 관련 스킬 템플릿 및 규칙 문서 개선
- components: action-feedback, agent-chat-panel, artifact-list 등 20개 이상의 컴포넌트 정의서 추가
- views: agent, artifacts, executions, overview, pipelines, runners, settings 정의서 추가
2026-06-24 23:07:00 +09:00

2.3 KiB

ui_doc_type component_id status source_evidence
component authorization-state planned
type path notes
docs agent-roadmap/phase/control-plane-product-surface/milestones/control-plane-security-audit-surface.md auth-scope Task가 operator/admin 단일 역할과 허용/거부, disabled/error 상태 구현을 요구
type path notes
docs agent-roadmap/sdd/control-plane-product-surface/control-plane-security-audit-surface/SDD.md D01과 S03이 최소 인증 모델, role, unauthorized/forbidden UX 기준을 정의
type path notes
user null agent-ui 재검토 중 SDD 기반 planned component로 보강

Authorization State

Component ID: authorization-state

Status: planned

Source Evidence

Type Path Notes
docs agent-roadmap/phase/control-plane-product-surface/milestones/control-plane-security-audit-surface.md auth-scope Task가 operator/admin 단일 역할과 허용/거부, disabled/error 상태 구현을 요구
docs agent-roadmap/sdd/control-plane-product-surface/control-plane-security-audit-surface/SDD.md D01과 S03이 최소 인증 모델, role, unauthorized/forbidden UX 기준을 정의
user 없음 agent-ui 재검토 중 SDD 기반 planned component로 보강

Purpose

write action 표면에서 operator/admin 권한 허용, 거부, disabled, error 상태를 일관되게 표현한다.

Used By

  • runners: self-update action 권한 상태 후보
  • pipelines: create job action 권한 상태 후보
  • executions: cancel/report/log/artifact action 권한 상태 후보

Anatomy

  • allowed/disabled affordance
  • unauthorized/forbidden message
  • optional token reference context
  • action guard reason

Variants

  • allowed: action submit 가능
  • disabled: 권한 또는 입력 조건 때문에 submit 불가
  • unauthorized: 인증 reference 부재 또는 무효
  • forbidden: operator/admin 기준 미충족

States

  • allowed
  • disabled
  • unauthorized
  • forbidden
  • error

Rules

  • production identity provider를 전제하지 않는다.
  • token 원문을 표시하지 않고 auth-token-reference의 display-safe reference만 연결한다.
  • 권한 실패 message는 민감 payload를 그대로 노출하지 않는다.

Decision History

  • 2026-06-24: 활성 보안/감사 SDD를 반영해 planned component로 추가했다.