> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crewai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 역할 기반 접근 제어 (RBAC)

> 역할, 범위, 세분화된 권한으로 crews, 도구, 데이터 접근을 제어합니다.

## 개요

CrewAI AMP의 RBAC는 두 가지 계층을 통해 안전하고 확장 가능한 접근 관리를 제공합니다:

1. **기능 권한** — 플랫폼 전반에서 각 역할이 수행할 수 있는 작업을 제어합니다 (관리, 읽기 또는 접근 불가)
2. **엔티티 수준 권한** — 개별 자동화, 환경 변수, LLM 연결, Git 저장소에 대한 세분화된 접근 제어

<Frame>
  <img src="https://mintcdn.com/crewai/Tp3HEbbp9mp-dy3H/images/enterprise/users_and_roles.png?fit=max&auto=format&n=Tp3HEbbp9mp-dy3H&q=85&s=31b2661025e9813f32938f9d583228b5" alt="CrewAI AMP RBAC 개요" width="1365" height="1044" data-path="images/enterprise/users_and_roles.png" />
</Frame>

## 사용자와 역할

CrewAI 워크스페이스의 각 구성원에게는 역할이 할당되며, 이를 통해 다양한 기능에 대한 접근 범위가 결정됩니다.

가능한 작업:

* 사전 정의된 역할 사용 (Owner, Member)
* 특정 권한에 맞춘 커스텀 역할 생성
* 설정 패널에서 언제든지 역할 할당

설정 위치: Settings → Roles

<Steps>
  <Step title="Roles 설정 열기">
    CrewAI AMP에서 <b>Settings → Roles</b>로 이동합니다.
  </Step>

  <Step title="역할 유형 선택">
    사전 정의된 역할(<b>Owner</b>, <b>Member</b>)을 사용하거나{" "}
    <b>Create role</b>을 클릭하여 커스텀 역할을 만듭니다.
  </Step>

  <Step title="멤버에 할당">
    사용자를 선택하고 역할을 할당합니다. 언제든지 변경할 수 있습니다.
  </Step>
</Steps>

### 사전 정의된 역할

| 역할         | 설명                                                                                  |
| :--------- | :---------------------------------------------------------------------------------- |
| **Owner**  | 모든 기능 및 설정에 대한 전체 접근 권한. 제한할 수 없습니다.                                                |
| **Member** | 대부분의 기능에 대한 읽기 접근, 환경 변수, LLM 연결, Studio 프로젝트에 대한 관리 접근. 조직 설정이나 기본 설정은 수정할 수 없습니다. |

### 구성 요약

| 영역       | 설정 위치                              | 옵션                           |
| :------- | :--------------------------------- | :--------------------------- |
| 사용자 & 역할 | Settings → Roles                   | 사전 정의: Owner, Member; 커스텀 역할 |
| 자동화 가시성  | Automation → Settings → Visibility | Private; 사용자/역할 화이트리스트       |

***

## 기능 권한 매트릭스

각 역할에는 기능 영역별 권한 수준이 있습니다. 세 가지 수준은 다음과 같습니다:

* **Manage** — 전체 읽기/쓰기 접근 (생성, 편집, 삭제)
* **Read** — 읽기 전용 접근
* **No access** — 기능이 숨겨지거나 접근 불가

| 기능                      | Owner  | Member (기본값) | 사용 가능한 수준                 | 설명                       |
| :---------------------- | :----- | :----------- | :------------------------ | :----------------------- |
| `usage_dashboards`      | Manage | Read         | Manage / Read / No access | 사용 메트릭 및 분석 보기           |
| `crews_dashboards`      | Manage | Read         | Manage / Read / No access | 배포 대시보드 보기, 자동화 세부 정보 접근 |
| `invitations`           | Manage | Read         | Manage / Read / No access | 조직에 새 멤버 초대              |
| `training_ui`           | Manage | Read         | Manage / Read / No access | 훈련/파인튜닝 인터페이스 접근         |
| `tools`                 | Manage | Read         | Manage / Read / No access | 도구 생성 및 관리               |
| `agents`                | Manage | Read         | Manage / Read / No access | 에이전트 생성 및 관리             |
| `environment_variables` | Manage | Manage       | Manage / No access        | 환경 변수 생성 및 관리            |
| `llm_connections`       | Manage | Manage       | Manage / No access        | LLM 제공자 연결 구성            |
| `default_settings`      | Manage | No access    | Manage / No access        | 조직 전체 기본 설정 수정           |
| `organization_settings` | Manage | No access    | Manage / No access        | 결제, 플랜 및 조직 구성 관리        |
| `studio_projects`       | Manage | Manage       | Manage / No access        | Studio에서 프로젝트 생성 및 편집    |

<Tip>
  커스텀 역할을 만들 때 대부분의 기능은 **Manage**, **Read** 또는 **No access**로 설정할 수 있습니다. 그러나 `environment_variables`, `llm_connections`, `default_settings`, `organization_settings`, `studio_projects`는 **Manage** 또는 **No access**만 지원합니다 — 이 기능들에는 읽기 전용 옵션이 없습니다.
</Tip>

***

## GitHub 또는 Zip에서 배포

가장 흔한 RBAC 질문 중 하나: *"팀원이 배포하려면 어떤 권한이 필요한가요?"*

### GitHub에서 배포

GitHub 저장소에서 자동화를 배포하려면 사용자에게 다음이 필요합니다:

1. **`crews_dashboards`**: 최소 `Read` — 배포가 생성되는 자동화 대시보드에 접근하는 데 필요
2. **Git 저장소 접근** (Git 저장소에 대한 엔티티 수준 RBAC가 활성화된 경우): 사용자의 역할에 엔티티 수준 권한을 통해 특정 Git 저장소에 대한 접근이 부여되어야 함
3. **`studio_projects`: `Manage`** — 배포 전에 Studio에서 crew를 빌드하는 경우

### Zip에서 배포

Zip 파일 업로드로 자동화를 배포하려면 사용자에게 다음이 필요합니다:

1. **`crews_dashboards`**: 최소 `Read` — 자동화 대시보드에 접근하는 데 필요
2. **Zip 배포 활성화**: 조직이 조직 설정에서 Zip 배포를 비활성화하지 않아야 함

### 빠른 참조: 배포에 필요한 최소 권한

| 작업          | 필요한 기능 권한                       | 추가 요구사항                         |
| :---------- | :------------------------------ | :------------------------------ |
| GitHub에서 배포 | `crews_dashboards: Read`        | Git 저장소 엔티티 접근 (Git RBAC 활성화 시) |
| Zip에서 배포    | `crews_dashboards: Read`        | 조직 수준에서 Zip 배포가 활성화되어야 함        |
| Studio에서 빌드 | `studio_projects: Manage`       | —                               |
| LLM 키 구성    | `llm_connections: Manage`       | —                               |
| 환경 변수 설정    | `environment_variables: Manage` | 엔티티 수준 접근 (엔티티 RBAC 활성화 시)      |

***

## 자동화 수준 접근 제어 (엔티티 권한)

조직 전체 역할 외에도, CrewAI는 개별 리소스에 대한 접근을 제한하는 세분화된 엔티티 수준 권한을 지원합니다.

### 자동화 가시성

자동화는 사용자 또는 역할별로 접근을 제한하는 가시성 설정을 지원합니다. 다음과 같은 경우에 유용합니다:

* 민감하거나 실험적인 자동화를 비공개로 유지
* 대규모 팀이나 외부 협업자의 가시성 관리
* 격리된 컨텍스트에서 자동화 테스트

배포를 비공개로 구성할 수 있으며, 이 경우 화이트리스트에 포함된 사용자와 역할만 상호작용할 수 있습니다.

설정 위치: Automation → Settings → Visibility 탭

<Steps>
  <Step title="Visibility 탭 열기">
    <b>Automation → Settings → Visibility</b>로 이동합니다.
  </Step>

  <Step title="가시성 설정">
    접근을 제한하려면 <b>Private</b>를 선택합니다. 조직 Owner는 항상
    접근 권한을 유지합니다.
  </Step>

  <Step title="접근 허용 대상 추가">
    보기, 실행, 로그/메트릭/설정 접근이 허용된 특정 사용자와 역할을
    추가합니다.
  </Step>

  <Step title="저장 및 확인">
    변경 사항을 저장한 후, 화이트리스트에 없는 사용자가 자동화를 보거나 실행할 수
    없는지 확인합니다.
  </Step>
</Steps>

### Private 가시성: 접근 결과

| 동작           | Owner | 화이트리스트 사용자/역할 | 비포함 |
| :----------- | :---- | :------------ | :-- |
| 자동화 보기       | ✓     | ✓             | ✗   |
| 자동화/API 실행   | ✓     | ✓             | ✗   |
| 로그/메트릭/설정 접근 | ✓     | ✓             | ✗   |

<Tip>
  조직 Owner는 항상 접근 권한이 있습니다. Private 모드에서는 화이트리스트에 포함된
  사용자/역할만 보기, 실행, 로그/메트릭/설정에 접근할 수 있습니다.
</Tip>

<Frame>
  <img src="https://mintcdn.com/crewai/Tp3HEbbp9mp-dy3H/images/enterprise/visibility.png?fit=max&auto=format&n=Tp3HEbbp9mp-dy3H&q=85&s=48e3dd12b9d55da6f7adc82ea80be56d" alt="CrewAI AMP 자동화 가시성 설정" width="2028" height="1498" data-path="images/enterprise/visibility.png" />
</Frame>

### 배포 권한 유형

특정 자동화에 엔티티 수준 접근을 부여할 때 다음 권한 유형을 할당할 수 있습니다:

| 권한                  | 허용 범위                          |
| :------------------ | :----------------------------- |
| `run`               | 자동화 실행 및 API 사용                |
| `traces`            | 실행 트레이스 및 로그 보기                |
| `manage_settings`   | 자동화 편집, 재배포, 롤백 또는 삭제          |
| `human_in_the_loop` | HITL(human-in-the-loop) 요청에 응답 |
| `full_access`       | 위의 모든 권한                       |

### 기타 리소스에 대한 엔티티 수준 RBAC

엔티티 수준 RBAC가 활성화되면 다음 리소스에 대한 접근도 사용자 또는 역할별로 제어할 수 있습니다:

| 리소스     | 제어 방식              | 설명                               |
| :------ | :----------------- | :------------------------------- |
| 환경 변수   | 엔티티 RBAC 기능 플래그    | 특정 환경 변수를 보거나 관리할 수 있는 역할/사용자 제한 |
| LLM 연결  | 엔티티 RBAC 기능 플래그    | 특정 LLM 제공자 구성에 대한 접근 제한          |
| Git 저장소 | Git 저장소 RBAC 조직 설정 | 특정 연결된 저장소에 접근할 수 있는 역할/사용자 제한   |

***

## 일반적인 역할 패턴

CrewAI는 Owner와 Member 역할을 기본 제공하지만, 대부분의 팀은 커스텀 역할을 만들어 활용합니다. 일반적인 패턴은 다음과 같습니다:

### Developer 역할

자동화를 빌드하고 배포하지만 조직 설정을 관리하지 않는 팀원을 위한 역할입니다.

| 기능                      | 권한        |
| :---------------------- | :-------- |
| `usage_dashboards`      | Read      |
| `crews_dashboards`      | Manage    |
| `invitations`           | Read      |
| `training_ui`           | Read      |
| `tools`                 | Manage    |
| `agents`                | Manage    |
| `environment_variables` | Manage    |
| `llm_connections`       | Manage    |
| `default_settings`      | No access |
| `organization_settings` | No access |
| `studio_projects`       | Manage    |

### Viewer / Stakeholder 역할

자동화를 모니터링하고 결과를 확인해야 하는 비기술 이해관계자를 위한 역할입니다.

| 기능                      | 권한        |
| :---------------------- | :-------- |
| `usage_dashboards`      | Read      |
| `crews_dashboards`      | Read      |
| `invitations`           | No access |
| `training_ui`           | Read      |
| `tools`                 | Read      |
| `agents`                | Read      |
| `environment_variables` | No access |
| `llm_connections`       | No access |
| `default_settings`      | No access |
| `organization_settings` | No access |
| `studio_projects`       | No access |

### Ops / Platform Admin 역할

인프라 설정을 관리하지만 에이전트를 빌드하지 않을 수 있는 플랫폼 운영자를 위한 역할입니다.

| 기능                      | 권한        |
| :---------------------- | :-------- |
| `usage_dashboards`      | Manage    |
| `crews_dashboards`      | Manage    |
| `invitations`           | Manage    |
| `training_ui`           | Read      |
| `tools`                 | Read      |
| `agents`                | Read      |
| `environment_variables` | Manage    |
| `llm_connections`       | Manage    |
| `default_settings`      | Manage    |
| `organization_settings` | Read      |
| `studio_projects`       | No access |

***

<Card title="도움이 필요하신가요?" icon="headset" href="mailto:support@crewai.com">
  RBAC 관련 질문은 지원팀에 문의해 주세요.
</Card>