커스텀 인스턴스 역할
n8n v2.29커스텀 인스턴스 역할은 Self-hosted Enterprise 및 Cloud Enterprise 플랜에서 사용할 수 있습니다. 사용 가능 버전: n8n 버전 2.30.0(2026년 7월 7일 릴리즈)부터 n8n에는 두 가지 유형의 커스텀 역할이 있습니다.
기능 사용 가능 여부
커스텀 인스턴스 역할은 Self-hosted Enterprise 및 Cloud Enterprise 플랜에서 사용할 수 있습니다. 플랜 상세 정보는 n8n의 가격 페이지를 참조하세요.
사용 가능 버전: n8n 버전 2.30.0(2026년 7월 7일 릴리즈)부터
인스턴스 역할 vs 프로젝트 역할
n8n에는 두 가지 유형의 커스텀 역할이 있습니다.
- 커스텀 인스턴스 역할: n8n 인스턴스 전체에 적용되는 역할입니다. 소속된 프로젝트와 관계없이 특정 인스턴스 수준 기능이 필요한 사용자에게 할당합니다.
- 커스텀 프로젝트 역할: 특정 프로젝트 내에서 적용되는 역할입니다. 커스텀 프로젝트 역할 생성을 참조하세요.
커스텀 인스턴스 역할을 사용하면 사용자에게 전체 Admin 권한을 부여하지 않고도 특정 인스턴스 수준 기능을 부여할 수 있습니다. 기본 제공 계정 유형(Owner, Admin, Member)과 달리, 커스텀 인스턴스 역할을 사용하면 인스턴스 설정, 사용자 관리 및 기타 인스턴스 전체 리소스에 대한 세분화된 권한을 정의할 수 있습니다.
커스텀 인스턴스 역할 생성#
인스턴스 소유자와 인스턴스 관리자는 커스텀 인스턴스 역할을 생성할 수 있습니다.
커스텀 인스턴스 역할을 생성하려면:
- Settings > Roles > Instance roles로 이동합니다.
- Create role을 선택합니다.
- 역할 이름과 선택적으로 설명을 입력합니다.
- 선택적으로 Preset(Admin, Member)을 선택하여 기본 제공 계정 유형을 기반으로 권한을 미리 채운 다음 필요에 따라 조정합니다.
- 이 역할에 대한 권한을 선택합니다.
- Instance settings > Manage: 인스턴스 전체 설정을 보고 변경
- Members > Manage: 인스턴스 전체의 사용자를 초대, 제거, 업데이트
- Roles > Manage project roles: 커스텀 프로젝트 역할만 생성, 편집, 삭제
- Roles > Manage: 모든 커스텀 역할(인스턴스 및 프로젝트)을 생성, 편집, 삭제. 이 항목을 선택하면 Manage project roles가 자동으로 포함됩니다.
- API keys > Manage own: 사용자 본인의 API 키를 생성 및 삭제
- API keys > Manage others: 다른 사용자의 API 키를 보고 삭제. Manage own이 자동으로 포함됩니다.
- Tags > View: 모든 태그를 조회
- Tags > Manage: 태그를 생성, 편집, 삭제
- Projects > Create: 새 프로젝트를 생성
- Insights > View: 인스턴스 수준 인사이트를 조회
- Save를 선택합니다.
사용자에게 커스텀 인스턴스 역할 할당#
Roles: Manage 권한을 가진 사용자는 커스텀 인스턴스 역할을 할당할 수 있습니다. 한 사용자는 기본 제공 계정 유형(Owner, Admin, Member)과 하나 이상의 커스텀 인스턴스 역할을 동시에 가질 수 있습니다.
커스텀 인스턴스 역할을 할당하려면:
- Settings > Users로 이동합니다.
- 업데이트할 사용자를 찾습니다.
- 사용자의 현재 역할을 선택하여 역할 드롭다운을 엽니다.
- Custom roles 아래에서 할당할 역할을 선택합니다.
커스텀 인스턴스 역할 편집#
기존 커스텀 인스턴스 역할을 업데이트하려면:
- Settings > Roles > Instance roles로 이동합니다.
- 편집할 커스텀 역할을 찾습니다.
- three-dot menu > Edit을 선택합니다.
- 역할 이름, 설명 또는 권한을 업데이트합니다.
- Save changes를 선택합니다.
편집은 할당된 모든 사용자에게 영향을 미칩니다
커스텀 인스턴스 역할에 대한 변경 사항은 인스턴스 전체에서 해당 역할을 가진 모든 사용자에게 적용됩니다.
커스텀 인스턴스 역할 복제#
기존 역할을 기반으로 새 역할을 생성하려면:
- Settings > Roles > Instance roles로 이동합니다.
- 복제할 역할을 찾습니다.
- three-dot menu > Duplicate를 선택합니다.
- 필요에 따라 역할 이름과 권한을 업데이트합니다.
- Create role을 선택합니다.
커스텀 인스턴스 역할 삭제#
커스텀 인스턴스 역할을 삭제하려면:
- Settings > Roles > Instance roles로 이동합니다.
- 삭제할 역할을 찾습니다.
- three-dot menu > Delete를 선택합니다.
- 삭제를 확인합니다.
삭제 전 사용자 재할당
이 역할을 가진 사용자가 있는 경우, 삭제하기 전에 다른 역할로 재할당하세요.
권한 참조#
아래 표는 Instance roles 편집기에 표시되는 각 권한 그룹과 체크박스를 설명합니다.
| Group | Checkbox | What it allows |
|---|---|---|
| Instance settings | Manage | 인스턴스 전체 설정을 보고 변경 |
| Members | Manage | 인스턴스 전체의 사용자를 초대, 제거, 업데이트 |
| Roles | Manage project roles | 커스텀 프로젝트 역할만 생성, 편집, 복제, 삭제, 할당 |
| Roles | Manage | 모든 커스텀 역할(인스턴스 및 프로젝트)을 생성, 편집, 복제, 삭제, 할당. Manage project roles가 자동으로 포함됩니다. |
| API keys | Manage own | 사용자 본인의 API 키를 생성 및 삭제 |
| API keys | Manage others | 다른 사용자의 API 키를 보고 삭제. Manage own이 자동으로 포함됩니다. |
| Tags | View | 모든 태그를 조회 |
| Tags | Manage | 태그를 생성, 편집, 삭제 |
| Projects | Create | 새 프로젝트를 생성 |
| Insights | View | 인스턴스 수준 인사이트와 사용 데이터를 조회 |
권한 상승 위험
특정 권한 조합은 권한 상승 위험을 초래합니다.
- Roles: Manage 권한을 가진 사용자는 자신의 커스텀 역할을 편집하여 원래 부여받지 않은 권한을 추가할 수 있습니다.
- Members: Manage 권한을 가진 사용자는 자신이 통제하는 사용자를 초대한 다음, 해당 사용자에게 Admin 수준 접근 권한을 부여할 수 있습니다.
이러한 권한은 완전히 신뢰할 수 있는 사용자에게만 할당하고, 불필요하게 조합하지 마세요.