역할 및 권한
역할 기반 액세스 제어(RBAC)를 사용하면 맞춤 역할을 정의하고 팀원에게 세분화된 권한을 할당할 수 있습니다. Enterprise 플랜에서 사용할 수 있습니다.
RBAC가 켜져 있으면 각 멤버의 권한은 할당된 역할에서 결정됩니다. 역할이 없는 멤버도 조직에는 남아 있지만, 역할이 지정되기 전까지는 역할을 통해 어떤 항목에도 접근할 수 없습니다. RBAC가 꺼져 있으면 조직에 참여한 모든 사용자가 전체 권한을 가진 Owner가 되며, Settings → Roles에는 "역할이 적용되지 않고 있습니다"라고 표시됩니다(Team 참고).
RBAC를 전환하면 역할이 초기화됩니다
조직에서 RBAC를 켜거나 끄면 모든 멤버와 대기 중인 모든 초대가 Owner 역할로 설정됩니다. 따라서 더 제한적인 역할을 할당하기 전까지는 청구 관리와 조직 삭제를 포함한 전체 권한을 모두가 갖게 됩니다.
권한#
각 역할은 세 그룹으로 나뉜 21개의 권한으로 구성됩니다. 설정 → 역할에서 각 권한은 다음과 같은 이름으로 표시됩니다:
| 권한 | 그룹 | 허용 작업 |
|---|---|---|
팀 관리 (org:manage_team) | 조직 | 멤버를 초대하거나 제거하고, 역할을 할당하고, 사용자 지정 역할을 관리합니다 |
청구 관리 (org:manage_billing) | 조직 | 청구 설정, 결제 수단, 인보이스를 조회하고 변경합니다 |
설정 관리 (org:manage_settings) | 조직 | 조직 이름, 시간대, 통합, 기능 플래그를 변경합니다 |
API 키 관리 (org:manage_api_keys) | 조직 | 조직의 서비스 API 키를 생성하고, 범위를 설정하고, 삭제합니다 |
통합 관리 (org:manage_integrations) | 조직 | 외부 통합을 연결하고, 설정하고, 연결 해제합니다 |
조직 삭제 (org:delete) | 조직 | 조직 전체를 영구적으로 삭제합니다 |
감사 로그 보기 (org:view_audit_logs) | 조직 | 조직의 감사 기록을 확인합니다. Audit Logs 권한이 필요합니다 |
검토 관리 (org:manage_reviews) | 조직 | 내부 번역 검토의 기록과 통계를 확인합니다 |
의사결정 풀 관리 (org:manage_decision_pools) | 조직 | 의사결정 풀을 생성하고, 이름을 변경하거나 보관하고, 구성원을 선택 |
엔진 보기 (engine:read) | 엔진 | 로컬라이제이션 엔진과 해당 설정을 확인합니다 |
번역 실행 (engine:translate) | 엔진 | 조직의 엔진을 대상으로 로컬라이제이션 작업을 실행합니다 |
엔진 생성 (engine:create) | 엔진 | 조직에 새 엔진을 생성합니다 |
엔진 편집 (engine:edit) | 엔진 | 엔진 및 모델 설정을 편집합니다 |
엔진 삭제 (engine:delete) | 엔진 | 엔진을 영구적으로 삭제합니다 |
번역 검토 (engine:review_translations) | 엔진 | 내부 검토 큐에서 AI 번역을 검토합니다 |
용어집 보기 (org:glossary:read) | 콘텐츠 | 조직의 용어집과 그 안의 용어를 확인합니다 |
용어집 편집 (org:glossary:edit) | 콘텐츠 | 용어집과 용어를 생성, 변경, 삭제하고 엔진에 적용합니다 |
브랜드 보이스 보기 (org:brandvoice:read) | 콘텐츠 | 조직의 브랜드 보이스를 확인합니다 |
브랜드 보이스 편집 (org:brandvoice:edit) | 콘텐츠 | 브랜드 보이스를 생성, 변경, 삭제하고 엔진에 적용합니다 |
규칙 보기 (org:ruleset:read) | 콘텐츠 | 조직의 규칙 세트와 그 안의 규칙을 확인합니다 |
규칙 편집 (org:ruleset:edit) | 콘텐츠 | 규칙 세트와 규칙을 생성, 변경, 삭제하고 엔진에 적용합니다 |
어떤 권한도 Owner 전용으로 따로 예약되어 있지는 않습니다. 권한 상승이 막히는 이유는 자신이 가진 권한만 다른 사람에게 부여할 수 있기 때문입니다. 역할을 생성하거나 편집할 때, 멤버에게 역할을 할당할 때, 또는 초대에 역할을 지정할 때 그 역할에 내 역할에는 없는 권한이 포함되어 있으면 거부됩니다.
역할#
역할은 두 종류가 있습니다:
- Owner — 플랫폼의 유일한 기본 역할로, Settings → Roles에서 Platform default로 표시됩니다. 모든 권한을 가지며 변경하거나 삭제할 수 없습니다. 조직을 만든 사람이 첫 번째 Owner가 되며, 한 조직에는 여러 명의 Owner가 있을 수 있고 항상 최소 한 명은 유지되어야 합니다.
- 사용자 지정 역할 — Settings → Roles의 New role에서 만드는 모든 역할입니다. 이름, 선택 사항인 설명, 그리고 세 그룹에서 선택한 권한 조합으로 구성됩니다. 역할을 생성, 편집, 삭제하려면 RBAC와 팀 관리 권한이 필요합니다.
일부 오래된 조직에는 Full Access 역할도 있습니다. 이 역할은 일반적인 사용자 지정 역할이므로 다른 역할과 마찬가지로 편집하거나 삭제할 수 있습니다.
역할은 권한 묶음입니다
멤버는 조직 수준에서 정확히 하나의 역할만 가집니다. 일부 권한만 부여하려면 필요한 권한만 포함한 역할을 만들어 할당하세요. 역할 외에 별도로 부여할 수 있는 권한은 아래에 설명된 엔진별 접근 권한과 콘텐츠별 접근 권한뿐입니다.
역할을 삭제하면 그 역할을 가지고 있던 모든 사용자는 역할이 없는 상태로 조직에 남고, 그 역할에 연결되어 있던 대기 중 초대는 역할 없이 도착합니다. 조직 API 키에 아직 연결된 역할은 삭제할 수 없습니다. 먼저 그 키에 다른 역할을 지정하거나 키를 폐기하세요.
역할 할당#
Settings → Team을 열고 Members 탭에서 멤버의 역할을 선택하세요. No role을 선택하면 권한이 없는 멤버로 남게 됩니다. 로그인은 할 수 있지만, 역할이 없으면 엔진, 설정, 청구에 접근할 수 없습니다. 누군가가 조직에 참여하기 전에 역할을 주려면 Invitations 탭에서 초대할 때 Role on arrival을 설정하세요. 역할을 할당하려면 RBAC와 팀 관리 권한이 필요하며, 초대를 보내려면 팀 관리 권한이 필요합니다.
누군가에게 Owner 역할을 부여하거나 회수할 수 있는 사람은 Owner뿐이며, 마지막으로 남은 Owner는 강등하거나 제거할 수 없습니다. 초대에는 Owner 역할을 지정할 수 없습니다.
엔진 액세스#
역할의 엔진 권한인 엔진 보기, 번역 실행, 엔진 편집, 엔진 삭제는 조직의 모든 로컬라이제이션 엔진에 적용됩니다. 엔진 생성 권한만 조직 전체 범위로 적용됩니다.
접근 범위를 더 좁히려면 특정 사용자에게 특정 엔진만 부여하세요. 엔진별 부여를 하면 해당 멤버는 그 엔진 하나에 대해서만 보기, 번역, 편집, 삭제 권한을 갖게 됩니다. 부여는 누적됩니다. 즉, 역할에 이미 엔진 권한이 포함되어 있으면 그 권한은 특정 엔진과 관계없이 모든 엔진에 적용됩니다. 사용자를 하나의 엔진으로만 제한하려면 엔진 권한이 없는 역할을 부여한 뒤, 그 엔진만 따로 부여하세요.
대시보드에서는 엔진별 부여를 설정할 수 없으므로 API 또는 MCP server를 통해 설정해야 합니다:
| 호출 | MCP 도구 | 필요 권한 |
|---|---|---|
PUT /organizations/:id/users/:userId/engine-access | permissions_setUserEngineAccess | 팀 관리. 멤버의 엔진 목록을 대체합니다 |
POST /engines/:id/members | permissions_addEngineMember | 해당 엔진에 대한 엔진 편집 |
DELETE /engines/:id/members/:userId | permissions_removeEngineMember | 해당 엔진에 대한 엔진 편집 |
이 부여는 사용자가 조직의 멤버인 동안에만 적용되며, RBAC가 켜져 있을 때만 동작합니다.
콘텐츠 접근 권한#
용어집, 브랜드 보이스, 규칙 세트도 같은 방식으로 동작합니다. 항목별 부여를 하면 멤버는 특정 용어집, 브랜드 보이스 또는 규칙 세트 하나에 대해 역할과 별도로 보기 및 편집 권한을 받습니다. 또한 엔진을 볼 수 있는 사람은 누구나 그 엔진에 적용된 콘텐츠를 읽을 수 있으므로 출력 결과를 이해할 수 있습니다.
항목별 부여는 PUT /organizations/:id/users/:userId/content-access(MCP: permissions_setUserContentAccess)로 설정하며, 팀 관리 권한이 필요하고 멤버의 전체 콘텐츠 목록을 대체합니다.
조직 API 키#
Settings → API keys에는 두 개의 탭이 있습니다. Personal 키는 모든 요금제에서 사용할 수 있으며, 키를 만든 사용자의 권한과 정확히 동일하게 동작합니다. Organization 키는 조직에 속하며, 사용자가 떠난 뒤에도 계속 작동하고, RBAC가 필요합니다. RBAC가 꺼져 있으면 탭에 "Organization 키에는 역할 기반 접근이 필요합니다"라고 표시됩니다.
- Organization 키를 만들고 역할이나 범위를 변경하려면 API 키 관리 권한이 필요합니다(
org:manage_api_keys). - Role은 선택 사항입니다. 키에는 엔진 보기와 번역 실행으로만 제한된 역할만 지정할 수 있습니다. 번역 실행 권한이 있는 역할은 모든 엔진에 접근할 수 있습니다.
- No role을 선택하면 키에 "아래에서 선택한 엔진에만 접근합니다"라고 표시됩니다. 이 경우 접근 권한은 키에 지정된 엔진에서만 전적으로 결정됩니다. 직접 번역 실행 권한이 있는 엔진만 지정할 수 있습니다.
- 키를 만든 뒤에는 편집을 통해 사용할 수 있는 용어집, 브랜드 보이스, 규칙 세트를 지정하세요. 키는 거기에 지정된 콘텐츠에만 접근할 수 있으며, 직접 편집할 수 있는 콘텐츠만 지정할 수 있습니다.
- Enterprise 요금제가 종료되면 모든 Organization 키는 해당 권한 항목이 명시된 403 응답과 함께 비활성화됩니다. 운영자는 존재하지 않는 엔진 범위 버그를 추적하는 대신 요금제를 복구하거나 Personal 키로 교체해야 한다는 점을 바로 알 수 있습니다.
키 생성과 폐기에 대한 자세한 내용은 API Keys를 참고하세요.
소유권#
소유권 이전을 위한 별도의 단계는 없습니다. Owner는 Settings → Team에서 해당 사용자에게 Owner를 선택해 소유권을 넘기며, 조직에는 항상 최소 한 명의 Owner가 있어야 합니다. 초대에는 Owner 역할을 지정할 수 없으므로 먼저 다른 역할로 초대한 뒤, 초대를 수락하면 Owner로 변경하세요. 물러나려면 다른 멤버를 Owner로 승격한 다음 자신의 역할을 낮추거나(RBAC가 켜져 있을 때) 자신을 제거하세요.