역할과 권한 부여
모든 사용자는 수행할 수 있는 작업을 정하는 역할 집합을 가집니다. 역할은 계층 없이 서로 독립적이지만, 한 가지 예외가 있습니다. 슈퍼 관리자는 모든 역할 기반 검사를 우회하며, 그 때문에 다른 모든 역할과 상호 배타적입니다. 사용자는 슈퍼 관리자이거나 나머지 다섯 역할의 조합을 가질 뿐, 둘을 함께 가질 수 없습니다. 소유권 계층의 검사 두 가지는 이 우회에서 의도적으로 제외되며, 두 가지 모두 아래 세션 액세스 매트릭스에서 확인할 수 있습니다. 역할이 전혀 없는 사용자도 유효합니다. 이 사용자는 자신의 계정(아바타와 언어)은 관리할 수 있지만 그 밖에는 아무것도 할 수 없습니다.
유효 역할
역할이 사용자에게 주어지는 경로는 두 가지이며, 모든 권한 검사는 이 둘의 합집합, 즉 사용자의 유효 역할을 사용합니다.
그룹을 통해서만 가진 역할도 직접 부여된 역할과 가치가 똑같습니다. 같은 게이트를 통과하고, 사용자를 승인자 자격 대상으로 만들며, 대리 로그인에서도 같은 방식으로 보호합니다. 캐시되는 것은 없습니다. 합집합은 요청마다 새로 확인되므로 누군가를 그룹에 추가하거나 제거하면 별도의 동기화 없이 즉시 적용됩니다.
그룹은 그 자체로 지정 대상이 될 수도 있습니다. 승인은 개인 대신 그룹에 보낼 수 있으며, 승인자 역할을 가진 구성원이면 누구나 처리할 수 있습니다.
그룹은 슈퍼 관리자 역할을 절대 부여할 수 없습니다. UI에 해당 옵션이 없고, API가 거부하며(HTTP 422), 데이터베이스 검사 제약 조건이 이를 뒷받침합니다. 슈퍼 관리자는 플랫폼 범위이고 그룹은 정확히 하나의 테넌트에 속하므로, 슈퍼 관리자는 그룹의 구성원이 될 수도 없습니다.
역할
| 역할 | 부여하는 권한 |
|---|---|
| 슈퍼 관리자 | 모든 권한(모든 역할 게이트를 우회합니다. 아래 매트릭스의 지정된 승인자 검사 두 가지는 우회하지 않습니다) |
| 관리자 | 사용자 CRUD, 시크릿 CRUD, 워크플로 실행 삭제, 그리고 자신의 테넌트에 있는 모든 워크플로 실행과 그 작업 및 채팅 기록, 모든 승인에 대한 읽기 전용 열람 권한(워크플로 실행과 워크플로 세션 참조. 삭제를 제외하면 관리자는 실행의 에이전트를 구동하거나, 실행에 속한 작업의 상태를 변경하거나, 승인을 처리할 수 없습니다) |
| 개발자 | 시크릿 CRUD, MCP 서버 CRUD, 도구 모의 CRUD, 에이전트 스킬 CRUD, 워크플로 생성/편집(AI가 생성한 생성된 프롬프트의 재생성 포함. 단, 이 필드를 직접 편집할 수 있는 것은 슈퍼 관리자뿐입니다), 작업 템플릿 CRUD, 디자인 세션 채팅 구동, 워크플로 실행(POST /workflows/{id}/execute. 게시 전 테스트를 위해 초안 워크플로와 수정됨 워크플로의 게시되지 않은 편집 내용도 포함). 게시와 비활성화는 포함되지 않습니다. 이는 검토자의 일입니다 |
| 검토자 | 워크플로 게시와 비활성화. 개발자가 더 이상 수행하지 않는 두 작업입니다. 워크플로에 대한 개발자의 전체 읽기 권한을 공유하므로, 초안 워크플로, 수정됨 워크플로의 게시되지 않은 편집 내용, 디자인 세션 채팅 기록을 개발자와 똑같이 읽을 수 있습니다. 워크플로나 그 작업 템플릿을 편집하거나 디자인 세션을 구동할 수는 없습니다 |
| 요청자 | 게시된(및 수정됨) 워크플로 실행(POST /workflows/{id}/execute). 항상 마지막으로 게시된 디자인을 기준으로 실행됩니다 |
| 승인자 | 워크플로 승인의 지정된 승인자가 될 자격(개인으로, 또는 승인이 전달된 그룹의 구성원으로)과 자신의 승인을 처리할 권한 |
초기 생성되는 root 사용자는 슈퍼 관리자 역할을 가지며 플랫폼 범위입니다(테넌트 없음). Default 테넌트 안에 초기 생성되는 admin 사용자는 관리자 역할을 가지며 해당 테넌트로 범위가 제한됩니다. 그 밖의 모든 사용자는 역할 없이 시작합니다.
역할이 제한하는 항목
읽기는 열려 있습니다. 역할로 제한되는 것은 쓰기, 워크플로 실행, 승인뿐이며, 인증된 사용자는 누구나 컬렉션을 GET할 수 있습니다(UI가 이름을 확인하고, 승인자를 고르고, 워크플로를 나열하는 데 필요합니다). 시크릿 값은 역할과 관계없이 API에서 절대 반환되지 않습니다.
실행에 전달되는 텍스트인 워크플로의 프롬프트와 생성된 프롬프트는 관리자, 개발자, 검토자, 슈퍼 관리자에게만 표시됩니다. 그 밖의 사용자에게는 워크플로와 그 실행을 읽을 때 이 필드들이 비어 있습니다. 워크플로의 버전 기록도 같은 역할로 제한되어 요청자나 승인자는 열 수 없습니다. 워크플로의 설명은 워크플로를 열 수 있는 모든 사람에게 계속 표시됩니다.
유일한 예외는 역할이 아닙니다. 액세스 제어 태그가 붙은 레코드는 그룹들을 합쳐 그 레코드의 해당 태그를 모두 가진 사용자와, 이를 우회하는 관리자 및 슈퍼 관리자에게만 표시됩니다. 그 밖의 사람에게는 레코드도, 그 존재를 알려 주는 흔적도 보이지 않습니다.
역할은 사용자 관리 페이지에서 할당하거나, 사용자 그룹 페이지에서 일괄 할당합니다. 슈퍼 관리자 역할은 슈퍼 관리자만 부여하거나 회수할 수 있습니다. 거부된 요청은 HTTP 403(FORBIDDEN)을 반환합니다.
UI에서 숨기는 항목
관리 UI는 사용자의 역할이 허용하지 않는 동작과 탐색 항목을 숨기므로, 거부될 요청은 대개 거부되기 전에 아예 도달할 수 없습니다.
| 화면 | 역할이 없을 때 |
|---|---|
| 목록 페이지 | 추가 버튼과 행별 작업 열이 숨겨집니다. 여기에는 삭제와, 만들기 양식으로 이어질 뿐인 MCP 서버의 "레지스트리 찾아보기"가 포함됩니다 |
| 상세 페이지 | 읽기 전용으로 표시됩니다. 모든 필드가 입력란 대신 들어간 형태의 값으로 표시되고, 저장과 삭제가 없으며, 취소는 뒤로로 바뀝니다 |
만들기 양식 (/<section>/new) | 액세스 거부 화면이 표시됩니다. 이곳으로 이어지는 추가 버튼은 이미 숨겨져 있으므로, 이 화면에 왔다면 딥 링크로 들어온 것입니다 |
읽기는 열려 있으므로 쓰기 권한이 없는 사람도 상세 페이지를 열 수 있습니다. 에이전트 스킬, MCP 서버, 도구 모의, 시크릿, 테넌트, 사용자, 워크플로, 작업 템플릿은 모두 위와 같이 읽기 전용으로 표시됩니다. 이때 시크릿의 항목은 키만 나열되며(값은 어차피 절대 반환되지 않습니다), 사용자의 비밀번호 필드는 완전히 생략됩니다. 테넌트의 name, 사용자의 username처럼 누구에게나 변경 불가능한 필드는 역할과 관계없이 같은 방식으로 표시됩니다. 만들기 양식에는 읽기 전용 표시 형태가 없으므로, 양식 대신 화면으로 응답합니다.
세션 액세스
A2Flow에는 두 종류의 채팅이 있으며, 서로 다른 방식으로 제한됩니다.
- 디자인 세션은 워크플로를 디자인하는 채팅입니다. 액세스는 역할로 결정됩니다. 디자인은 개발자의 일이므로 테넌트의 개발자들이 공유하고 구동할 수 있습니다. 검토자도 게시 전에 디자인을 검토하기 위해 읽을 수 있지만 구동할 수는 없습니다.
- 워크플로 세션은 하나의 실행이 진행되는 채팅입니다. 액세스는 참여 여부로 결정됩니다. 실행을 시작한 사람과 그 안에서 승인을 요청받은 사람들이 역할과 관계없이 공유합니다.
디자인 세션
워크플로의 디자인 채팅(GET /workflows/{id}/messages, POST /workflows/{id}/agent)은 레코드별 참여가 아니라 역할을 기준으로 공유되므로 팀이 함께 디자인을 다듬을 수 있습니다.
| 대상 | 기록 읽기 | 에이전트 구동 |
|---|---|---|
| 테넌트의 모든 개발자 | ✅ | ✅ |
| 테넌트의 모든 검토자 | ✅ | ❌ 403 |
워크플로의 작성자(createdBy). 개발자 역할을 잃은 후에도 포함 | ✅ | ✅ |
| 슈퍼 관리자 | ✅ | ✅ |
| 그 밖의 모든 사람 | ❌ 403 | ❌ 403 |
작성자를 명시적으로 허용하므로 자신이 시작한 채팅에서 차단되는 사람은 없습니다. 다른 테넌트의 워크플로 ID는 403이 아니라 항상 404입니다. 단, 슈퍼 관리자가 모든 테넌트를 선택한 상태에서 GET .../messages를 호출하면 워크플로가 테넌트와 관계없이 확인되며, 이때는 위와 동일한 역할/작성자/슈퍼 관리자 검사가 테넌트 경계를 대신합니다.
워크플로 실행과 워크플로 세션
역할 외에도, 워크플로 실행에 대한 각 작업을 수행하려면 호출자가 실행의 시작자(워크플로를 실행한 사용자)이거나 실행에 속한 승인의 지정된 승인자여야 합니다. 지정된 승인자는 이름이 지정된 사용자, 또는 승인이 전달된 그룹에서 승인자 역할을 가진 구성원입니다(사람의 승인 참조). 이를 통해 승인자가 시작자의 채팅에 참여하는 승인자 공유 설계를 유지하면서 제3자를 차단합니다. 읽기는 이보다 범위가 넓고, 동작을 수행하는 작업은 더 좁습니다.
| 작업 | 엔드포인트 | 시작자 | 지정된 승인자 | 관리자(같은 테넌트) | 슈퍼 관리자 |
|---|---|---|---|---|---|
| 실행 읽기 | GET /workflow-executions/{id} | ✅ | ✅ | ✅ | ✅ |
| 작업 나열 또는 열기 | GET .../workflow-tasks | ✅ | ✅ | ✅ | ✅ |
| 워크플로 세션 기록 읽기 | GET .../messages | ✅ | ✅ | ✅ | ✅ |
| 에이전트 구동 | POST .../agent | ✅ | ✅ | ❌ | ✅ |
| 작업 상태 변경(직접 또는 에이전트를 통해) | PATCH /workflow-tasks/{id} | ✅ | 자신에게 전달된 승인이 다루는 작업만 | ❌ | 어떤 승인도 다루지 않는 작업만 |
| 승인 처리 | PATCH /approvals/{id} | ❌ | 해당 승인의 승인자만 | ❌ | ❌ |
| 실행 삭제 | DELETE /workflow-executions/{id} | 관리자인 경우만 | 관리자인 경우만 | ✅ | ✅ |
이 열에 해당하지 않는 사람은 HTTP 403을 받습니다. 위의 읽기 행과 마찬가지로, 같은 GET /approvals 목록은 관리자에게 테넌트의 모든 승인을 보여 줍니다.
실행의 작업 목록은 워크플로를 실행할 때 고정됩니다. 작업은 워크플로의 게시된 템플릿에서 복사되며, 이후에는 status(와 실패 원인)만 바뀝니다. 누구도 API로 실행의 작업을 추가, 제거하거나 제목, 설명, 연결을 바꿀 수 없습니다. 단계를 바꾸려면 작업 템플릿을 편집하고 다시 실행하세요.
마지막 세 행은 두 번 읽어 볼 만합니다.
상태 행과 처리 행은 이 페이지 맨 앞에서 언급한 슈퍼 관리자 우회에 대한 소유권 계층 예외입니다. 승인은 지정된 승인자만 처리할 수 있고, 작업 상태는 시작자나 해당 작업을 다루는 승인이 전달된 승인자만 변경할 수 있습니다. 실행의 승인자라고 해서 누구나 되는 것은 아니며, (승인이 작업을 다루게 되면) 슈퍼 관리자나 관리자도 변경할 수 없습니다. 승인자는 요청받은 승인의 범위, 즉 승인이 지정한 작업과 다음 승인 전까지의 후속 단계 안에서만 작업을 진행할 수 있습니다. 덕분에 결정이 실행을 재개하면서도 승인자가 관련 없는 단계를 진행시키지는 못합니다. 그렇지 않으면 작업을 곧바로 완료됨으로 바꾸어 누구나 수신자를 대신할 수 있게 됩니다(사람의 승인 참조). 이 규칙은 변경을 직접 하든 워크플로 세션 채팅에서 실행 에이전트에게 요청하든 동일합니다. 에이전트는 구동자가 직접 할 수 없는 상태 변경을 거부합니다.
실행 삭제는 그 반대 형태입니다. 소유권 요소가 전혀 없는 순수한 역할 게이트이므로, 관리자는 테넌트의 어떤 실행이든 삭제할 수 있지만 관리자가 아닌 시작자는 자신의 실행도 삭제할 수 없습니다. 삭제하면 실행의 작업과 워크플로 세션도 함께 제거됩니다.
플랫폼 전체 섹션
테넌트와 시스템 설정은 슈퍼 관리자만 사용하는 두 관리 섹션입니다. 다른 곳과 달리 읽기도 제한됩니다. 두 섹션 모두 테넌트 데이터가 아니라 플랫폼 수준 구성을 담고 있으므로 사이드바 항목, 환영 카드, 그 뒤의 모든 엔드포인트가 다른 모든 역할에 닫혀 있습니다.
시간에 따른 승인자 자격
⚠️ 승인자 자격은 승인을 만들 때 검증합니다. list_users / list_user_groups는 실제로 승인할 수 있는 대상만 제시하고, request_approval은 그 밖의 대상(자격 있는 구성원이 없는 그룹 포함)을 거부합니다. 그 이후에 일어나는 일은 대상에 따라 다르며, 이 차이는 의도된 것입니다.
- 사용자 대상: 나중에 승인자 역할을 회수해도 해당 사용자에게 이미 전달된 승인은 무효가 되지 않습니다. 그 사용자는 계속 처리할 수 있으므로 진행 중인 워크플로가 멈추지 않습니다.
- 그룹 대상: "그룹"은 고정된 사람이 아니라 계속 바뀌는 집합이므로 구성원 자격과 역할을 결정 시점에 다시 확인합니다. 덕분에 새로 추가된 구성원이 대기 중인 요청을 맡을 수 있지만, 반대 결과도 생깁니다. 그룹의 승인자 역할 부여를 제거하거나 자격 있는 구성원을 모두 없애면 대기 중인 요청은 아무도 처리할 수 없는 상태가 되고 실행은 무기한 대기합니다. 역할을 다시 부여하거나 구성원을 다시 추가하면 즉시 해제됩니다.