InfoGrab DocsInfoGrab Docs

커스텀 인스턴스 역할

요약

커스텀 인스턴스 역할은 Self-hosted Enterprise 및 Cloud Enterprise 플랜에서 사용할 수 있습니다. 사용 가능 버전: n8n 버전 2.30.0(2026년 7월 7일 릴리즈)부터 n8n에는 두 가지 유형의 커스텀 역할이 있습니다.

Note

기능 사용 가능 여부

커스텀 인스턴스 역할은 Self-hosted Enterprise 및 Cloud Enterprise 플랜에서 사용할 수 있습니다. 플랜 상세 정보는 n8n의 가격 페이지를 참조하세요.

사용 가능 버전: n8n 버전 2.30.0(2026년 7월 7일 릴리즈)부터

Note

인스턴스 역할 vs 프로젝트 역할

n8n에는 두 가지 유형의 커스텀 역할이 있습니다.

  • 커스텀 인스턴스 역할: n8n 인스턴스 전체에 적용되는 역할입니다. 소속된 프로젝트와 관계없이 특정 인스턴스 수준 기능이 필요한 사용자에게 할당합니다.
  • 커스텀 프로젝트 역할: 특정 프로젝트 내에서 적용되는 역할입니다. 커스텀 프로젝트 역할 생성을 참조하세요.

커스텀 인스턴스 역할을 사용하면 사용자에게 전체 Admin 권한을 부여하지 않고도 특정 인스턴스 수준 기능을 부여할 수 있습니다. 기본 제공 계정 유형(Owner, Admin, Member)과 달리, 커스텀 인스턴스 역할을 사용하면 인스턴스 설정, 사용자 관리 및 기타 인스턴스 전체 리소스에 대한 세분화된 권한을 정의할 수 있습니다.

커스텀 인스턴스 역할 생성#

인스턴스 소유자와 인스턴스 관리자는 커스텀 인스턴스 역할을 생성할 수 있습니다.

커스텀 인스턴스 역할을 생성하려면:

  1. Settings > Roles > Instance roles로 이동합니다.
  2. Create role을 선택합니다.
  3. 역할 이름과 선택적으로 설명을 입력합니다.
  4. 선택적으로 Preset(Admin, Member)을 선택하여 기본 제공 계정 유형을 기반으로 권한을 미리 채운 다음 필요에 따라 조정합니다.
  5. 이 역할에 대한 권한을 선택합니다.
    • 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: 인스턴스 수준 인사이트를 조회
  6. Save를 선택합니다.

사용자에게 커스텀 인스턴스 역할 할당#

Roles: Manage 권한을 가진 사용자는 커스텀 인스턴스 역할을 할당할 수 있습니다. 한 사용자는 기본 제공 계정 유형(Owner, Admin, Member)과 하나 이상의 커스텀 인스턴스 역할을 동시에 가질 수 있습니다.

커스텀 인스턴스 역할을 할당하려면:

  1. Settings > Users로 이동합니다.
  2. 업데이트할 사용자를 찾습니다.
  3. 사용자의 현재 역할을 선택하여 역할 드롭다운을 엽니다.
  4. Custom roles 아래에서 할당할 역할을 선택합니다.

커스텀 인스턴스 역할 편집#

기존 커스텀 인스턴스 역할을 업데이트하려면:

  1. Settings > Roles > Instance roles로 이동합니다.
  2. 편집할 커스텀 역할을 찾습니다.
  3. three-dot menu > Edit을 선택합니다.
  4. 역할 이름, 설명 또는 권한을 업데이트합니다.
  5. Save changes를 선택합니다.
Warning

편집은 할당된 모든 사용자에게 영향을 미칩니다

커스텀 인스턴스 역할에 대한 변경 사항은 인스턴스 전체에서 해당 역할을 가진 모든 사용자에게 적용됩니다.

커스텀 인스턴스 역할 복제#

기존 역할을 기반으로 새 역할을 생성하려면:

  1. Settings > Roles > Instance roles로 이동합니다.
  2. 복제할 역할을 찾습니다.
  3. three-dot menu > Duplicate를 선택합니다.
  4. 필요에 따라 역할 이름과 권한을 업데이트합니다.
  5. Create role을 선택합니다.

커스텀 인스턴스 역할 삭제#

커스텀 인스턴스 역할을 삭제하려면:

  1. Settings > Roles > Instance roles로 이동합니다.
  2. 삭제할 역할을 찾습니다.
  3. three-dot menu > Delete를 선택합니다.
  4. 삭제를 확인합니다.
Note

삭제 전 사용자 재할당

이 역할을 가진 사용자가 있는 경우, 삭제하기 전에 다른 역할로 재할당하세요.

권한 참조#

아래 표는 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 인스턴스 수준 인사이트와 사용 데이터를 조회
Warning

권한 상승 위험

특정 권한 조합은 권한 상승 위험을 초래합니다.

  • Roles: Manage 권한을 가진 사용자는 자신의 커스텀 역할을 편집하여 원래 부여받지 않은 권한을 추가할 수 있습니다.
  • Members: Manage 권한을 가진 사용자는 자신이 통제하는 사용자를 초대한 다음, 해당 사용자에게 Admin 수준 접근 권한을 부여할 수 있습니다.

이러한 권한은 완전히 신뢰할 수 있는 사용자에게만 할당하고, 불필요하게 조합하지 마세요.

커스텀 인스턴스 역할

n8n v2.29
원문 보기
요약

커스텀 인스턴스 역할은 Self-hosted Enterprise 및 Cloud Enterprise 플랜에서 사용할 수 있습니다. 사용 가능 버전: n8n 버전 2.30.0(2026년 7월 7일 릴리즈)부터 n8n에는 두 가지 유형의 커스텀 역할이 있습니다.

Note

기능 사용 가능 여부

커스텀 인스턴스 역할은 Self-hosted Enterprise 및 Cloud Enterprise 플랜에서 사용할 수 있습니다. 플랜 상세 정보는 n8n의 가격 페이지를 참조하세요.

사용 가능 버전: n8n 버전 2.30.0(2026년 7월 7일 릴리즈)부터

Note

인스턴스 역할 vs 프로젝트 역할

n8n에는 두 가지 유형의 커스텀 역할이 있습니다.

  • 커스텀 인스턴스 역할: n8n 인스턴스 전체에 적용되는 역할입니다. 소속된 프로젝트와 관계없이 특정 인스턴스 수준 기능이 필요한 사용자에게 할당합니다.
  • 커스텀 프로젝트 역할: 특정 프로젝트 내에서 적용되는 역할입니다. 커스텀 프로젝트 역할 생성을 참조하세요.

커스텀 인스턴스 역할을 사용하면 사용자에게 전체 Admin 권한을 부여하지 않고도 특정 인스턴스 수준 기능을 부여할 수 있습니다. 기본 제공 계정 유형(Owner, Admin, Member)과 달리, 커스텀 인스턴스 역할을 사용하면 인스턴스 설정, 사용자 관리 및 기타 인스턴스 전체 리소스에 대한 세분화된 권한을 정의할 수 있습니다.

커스텀 인스턴스 역할 생성#

인스턴스 소유자와 인스턴스 관리자는 커스텀 인스턴스 역할을 생성할 수 있습니다.

커스텀 인스턴스 역할을 생성하려면:

  1. Settings > Roles > Instance roles로 이동합니다.
  2. Create role을 선택합니다.
  3. 역할 이름과 선택적으로 설명을 입력합니다.
  4. 선택적으로 Preset(Admin, Member)을 선택하여 기본 제공 계정 유형을 기반으로 권한을 미리 채운 다음 필요에 따라 조정합니다.
  5. 이 역할에 대한 권한을 선택합니다.
    • 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: 인스턴스 수준 인사이트를 조회
  6. Save를 선택합니다.

사용자에게 커스텀 인스턴스 역할 할당#

Roles: Manage 권한을 가진 사용자는 커스텀 인스턴스 역할을 할당할 수 있습니다. 한 사용자는 기본 제공 계정 유형(Owner, Admin, Member)과 하나 이상의 커스텀 인스턴스 역할을 동시에 가질 수 있습니다.

커스텀 인스턴스 역할을 할당하려면:

  1. Settings > Users로 이동합니다.
  2. 업데이트할 사용자를 찾습니다.
  3. 사용자의 현재 역할을 선택하여 역할 드롭다운을 엽니다.
  4. Custom roles 아래에서 할당할 역할을 선택합니다.

커스텀 인스턴스 역할 편집#

기존 커스텀 인스턴스 역할을 업데이트하려면:

  1. Settings > Roles > Instance roles로 이동합니다.
  2. 편집할 커스텀 역할을 찾습니다.
  3. three-dot menu > Edit을 선택합니다.
  4. 역할 이름, 설명 또는 권한을 업데이트합니다.
  5. Save changes를 선택합니다.
Warning

편집은 할당된 모든 사용자에게 영향을 미칩니다

커스텀 인스턴스 역할에 대한 변경 사항은 인스턴스 전체에서 해당 역할을 가진 모든 사용자에게 적용됩니다.

커스텀 인스턴스 역할 복제#

기존 역할을 기반으로 새 역할을 생성하려면:

  1. Settings > Roles > Instance roles로 이동합니다.
  2. 복제할 역할을 찾습니다.
  3. three-dot menu > Duplicate를 선택합니다.
  4. 필요에 따라 역할 이름과 권한을 업데이트합니다.
  5. Create role을 선택합니다.

커스텀 인스턴스 역할 삭제#

커스텀 인스턴스 역할을 삭제하려면:

  1. Settings > Roles > Instance roles로 이동합니다.
  2. 삭제할 역할을 찾습니다.
  3. three-dot menu > Delete를 선택합니다.
  4. 삭제를 확인합니다.
Note

삭제 전 사용자 재할당

이 역할을 가진 사용자가 있는 경우, 삭제하기 전에 다른 역할로 재할당하세요.

권한 참조#

아래 표는 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 인스턴스 수준 인사이트와 사용 데이터를 조회
Warning

권한 상승 위험

특정 권한 조합은 권한 상승 위험을 초래합니다.

  • Roles: Manage 권한을 가진 사용자는 자신의 커스텀 역할을 편집하여 원래 부여받지 않은 권한을 추가할 수 있습니다.
  • Members: Manage 권한을 가진 사용자는 자신이 통제하는 사용자를 초대한 다음, 해당 사용자에게 Admin 수준 접근 권한을 부여할 수 있습니다.

이러한 권한은 완전히 신뢰할 수 있는 사용자에게만 할당하고, 불필요하게 조합하지 마세요.