# 대시보드 팀 관리

대시보드 팀은 KeenAuth 계정에서 작업하는 사람들입니다. 환경을 설정하고, 최종 사용자를 관리하며, 청구를 담당합니다. 팀 구성원은 최종 사용자 및 고객 조직의 관리자와 별개입니다. 대시보드에서 **Team**을 열면 구성원, 열려 있는 초대, 그리고 Enterprise의 경우 사용자 지정 역할을 확인할 수 있습니다.

한 사람이 동일한 로그인으로 여러 KeenAuth 계정에 속할 수 있습니다. 상단 바의 계정 선택기로 계정을 전환합니다. 전환하려는 계정에 다른 로그인이 필요하면 대시보드가 해당 계정을 위해 다시 로그인하도록 요청합니다.

## 기본 제공 역할

모든 구성원은 하나 이상의 역할 할당을 가집니다. 계정 전체에 대해 할당된 역할은 계정의 모든 프로젝트와 환경에 적용됩니다.

| 역할 | 수행할 수 있는 작업 |
|---|---|
| `owner` | 계정 해지, 소유권 이전, `production` 환경 생성, 환경 삭제, 발급자 모드 변경, 요금제 및 청구 변경을 포함한 모든 작업. |
| `admin` | owner가 할 수 있는 작업 중 owner 전용 작업과 청구를 제외한 모든 작업. 팀과 사용자 지정 역할을 관리할 수 있지만 owner를 초대, 할당, 해지 또는 제거할 수 없습니다. |
| `developer` | 환경 설정(애플리케이션, 연결, 브랜딩, 훅 등)을 읽고 씁니다. 관리 API 키와 관리 클라이언트는 `development` 및 `staging` 환경에서만 생성합니다. 최종 사용자의 개인 데이터는 마스킹되어 보이며 최종 사용자에게 작업할 수 없습니다. |
| `support` | 설정, 로그 및 감사 이벤트를 읽고, 최종 사용자에 대해 차단, 세션 종료, 자격 증명 재설정, 사용자 삭제 작업을 수행합니다. 최종 사용자의 개인 데이터를 전체로 볼 수 있습니다. 설정은 변경할 수 없습니다. |
| `billing` | 사용량, 요금제 및 청구서를 보고 요금제를 변경합니다. 환경 설정이나 최종 사용자에는 접근할 수 없습니다. |
| `viewer` | 설정, 로그, 감사 이벤트 및 사용량을 읽습니다. 최종 사용자의 개인 데이터는 마스킹되어 보입니다. |

모든 역할은 팀 목록을 볼 수 있습니다. 보안 설정, 서명 키, 사용자 지정 도메인, 대량 내보내기 및 가져오기, 플랫폼 지원 접근 권한 부여는 `owner`와 `admin`으로 제한됩니다.

### 최근 로그인이 필요한 작업

일부 작업은 최근 5분 이내에 로그인한 경우에만 허용됩니다. 그렇지 않으면 대시보드가 다시 로그인하도록 요청한 뒤 작업을 계속합니다.

- 구성원 초대, 역할 할당 및 해지, 구성원 제거
- 사용자 지정 역할 생성, 편집 및 삭제
- 소유권 이전 및 계정 해지
- `production` 환경 생성, 환경 삭제 및 발급자 모드 변경
- 요금제 및 청구 변경
- 플랫폼 지원 접근 권한 부여 및 대시보드 보안 설정 변경

## 구성원 초대

`owner` 또는 `admin`만 초대할 수 있습니다. `admin`은 누군가를 `owner`로 초대할 수 없습니다.

1. **Team**을 열고 **Invite a member**를 선택합니다.
2. 이메일 주소, 역할, 범위를 입력합니다. `owner` 역할은 계정 전체에 대해서만 부여할 수 있습니다. 프로젝트 및 환경 범위에는 Enterprise 요금제가 필요합니다. 아래의 "사용자 지정 역할 및 범위 할당"을 참조하십시오.
3. **Create invitation**을 선택합니다.

대시보드는 초대 링크를 한 번만 표시합니다. 그 순간 링크를 복사하십시오. 다시 표시할 수 없습니다. 대시보드는 초대 이메일이 초대받은 사람에게 발송되었는지도 알려 줍니다. 이메일은 대시보드 언어 또는 영어로 작성됩니다. 이메일이 발송되지 않았다면 신뢰할 수 있는 채널을 통해 초대받은 사람에게 링크를 전달하십시오.

제한 사항:

- 초대는 생성 후 7일이 지나면 만료됩니다.
- 계정은 24시간 동안 최대 50개의 초대를 생성할 수 있으며, 열려 있는 초대는 최대 100개까지 가질 수 있습니다.
- 하나의 주소는 계정 내에서 한 번에 하나의 열린 초대만 가질 수 있습니다.

초대를 철회하려면 **Invitations**를 열고 **Revoke invitation**을 선택합니다. 링크는 즉시 작동을 멈춥니다.

### 초대 수락

초대받은 사람은 링크를 열고 대시보드에 로그인합니다. 초대는 검증된 기본 이메일 주소가 초대된 주소와 같은 대시보드 사용자만 수락할 수 있습니다. 다른 주소로 로그인하면 작동하지 않습니다. 수락 후 구성원은 초대된 역할로 활성화됩니다.

초대는 이를 보낸 구성원의 권한을 가집니다. 링크를 사용할 때 해당 구성원이 더 이상 활성 구성원이 아니거나 초대된 역할을 더 이상 부여할 수 없다면 초대는 작동하지 않습니다. 만료, 사용, 철회되었거나 알 수 없는 링크, 그리고 잘못된 주소로 연 링크는 모두 같은 메시지를 표시합니다. 초대한 사람에게 새 링크를 요청하십시오.

## 역할 변경 및 구성원 제거

**Members**의 구성원 메뉴에서 다음을 수행합니다.

- **Assign role**은 할당을 추가합니다. 구성원은 여러 할당을 가질 수 있으며, 같은 역할과 같은 범위는 두 번 할당할 수 없습니다.
- **Revoke**는 할당 하나를 제거합니다.
- **Remove member**는 구성원의 모든 할당을 제거하고 구성원 자격을 종료합니다. 구성원은 즉시 계정에 대한 접근 권한을 잃습니다.

`admin`은 owner의 `owner` 역할을 해지하거나 owner를 제거할 수 없습니다. 계정의 마지막 활성 `owner`는 제거되거나 `owner` 역할을 잃을 수 없으므로 계정에는 항상 owner가 있습니다.

역할이 해지되거나 구성원이 제거되면 해당 사람의 대시보드 세션과 계정 접근 권한도 함께 해지됩니다. [대시보드 접근 보안](/docs/security/dashboard-access)을 참조하십시오.

## 소유권 이전

`owner`만 소유권을 이전할 수 있습니다. 새 owner는 아직 owner가 아닌 다른 활성 구성원이어야 하며, 다중 인증으로 대시보드에 한 번 이상 로그인한 적이 있어야 합니다.

구성원 메뉴에서 **Transfer ownership**을 선택하고 구성원 ID를 입력해 확인합니다. 한 단계에서 해당 구성원은 `owner`가 되고, 본인의 `owner` 역할은 `admin`으로 바뀝니다. 다시 owner로 만들 수 있는 사람은 owner뿐입니다.

## 사용자 지정 역할 및 범위 할당

사용자 지정 역할과 프로젝트 또는 환경 범위의 할당은 Enterprise 요금제에서 사용할 수 있습니다. 다른 요금제에서는 대시보드에 요금제 안내와 함께 **Custom roles** 탭이 표시되며, 사용자 지정 역할이나 범위 역할을 할당하면 거부됩니다.

### 사용자 지정 역할 생성

`owner`와 `admin` 구성원은 **Team** > **Custom roles**에서 사용자 지정 역할을 관리합니다.

- **Role key**: 영문 소문자, 숫자, 밑줄로 된 3~40자이며 문자로 시작해야 합니다. 기본 제공 역할 이름은 사용할 수 없고, 나중에 변경할 수 없습니다.
- **Name**: 1~100자.
- **Permissions**: 역할이 할당된 환경에서 적용되는 관리 API 권한이며, 최대 200개입니다.
- **Dashboard actions**: 대시보드에서의 계정, 프로젝트, 환경 및 청구 작업.

역할에는 권한이나 대시보드 작업이 최소 하나 있어야 합니다. 다음 제한이 적용됩니다.

- owner 전용 작업(계정 해지, 소유권 이전, `production` 환경 생성, 환경 삭제, 발급자 모드 변경)은 사용자 지정 역할에 포함할 수 없습니다.
- `production` 환경에서 본인의 역할이 가진 권한과 작업만 부여할 수 있습니다. 대시보드는 그것만 제공합니다.
- 역할을 편집하려면 현재 내용과 새 내용 모두에 해당하는 권한을 가지고 있어야 합니다. 역할이 본인의 역할보다 많은 권한을 부여하고 있다면 계정 owner에게 변경을 요청하십시오.
- 아직 할당되어 있거나 열려 있는 초대에서 참조하는 역할은 삭제할 수 없습니다. 먼저 해당 할당을 해지하십시오. 계정이 Enterprise 요금제를 벗어난 뒤에도 삭제는 가능합니다.

구성원 초대, 역할 할당, 사용자 지정 역할 관리에는 항상 계정 전체에 대한 기본 제공 `owner` 또는 `admin` 역할이 필요합니다. 사용자 지정 역할로는 이러한 팀 작업을 수행할 수 없습니다.

### 범위 할당

역할은 계정 전체, 프로젝트 하나(해당 프로젝트의 모든 환경) 또는 환경 하나에 할당할 수 있습니다. 프로젝트나 환경은 계정에 속해 있어야 합니다. 범위 할당만 가진 구성원은 해당 할당이 포함하는 프로젝트와 환경만 보며, 그 환경에만 대시보드 접근 권한을 얻습니다. 여러 할당이 같은 환경을 포함하면 구성원은 그 환경에서 모든 할당의 권한을 가집니다.

`owner` 역할은 범위를 지정할 수 없습니다.

## 관련 페이지

- [대시보드 접근 보안](/docs/security/dashboard-access)
- [환경 간 데이터 격리](/docs/security/tenant-isolation)