사용자 지정 프로젝트 역할을 통해 팀의 필요에 맞게 특정 권한을 가진 역할을 만들 수 있습니다. 기본 제공 프로젝트 역할(관리자, 편집자, 뷰어)과 달리 사용자 지정 역할을 통해 워크플로, 자격 증명 및 기타 프로젝트 리소스에 대한 세분화된 접근을 정의할 수 있습니다.

사용자 지정 역할 만들기#

인스턴스 소유자와 인스턴스 관리자가 사용자 지정 역할을 만들 수 있습니다.

사용자 지정 역할을 만들려면:

1. Settings > Project roles로 이동합니다.
2. Create role을 선택합니다.
3. 역할 이름과 선택적 설명을 입력합니다.
4. 이 역할의 권한(스코프)을 선택합니다:
   • 워크플로 권한: 워크플로 생성, 읽기, 업데이트, 게시, 삭제, 목록, 실행, 이동 또는 공유
   • 자격 증명 권한: 자격 증명 생성, 읽기, 업데이트, 삭제, 목록, 이동 또는 공유
   • 프로젝트 권한: 프로젝트 목록, 읽기, 업데이트 또는 삭제
   • 폴더 권한: 폴더 생성, 읽기, 업데이트, 삭제, 목록 또는 이동
   • 데이터 테이블 권한: 프로젝트 테이블 생성, 읽기, 업데이트, 삭제, 목록, 행 읽기/쓰기
   • 프로젝트 변수 권한: 프로젝트 변수 생성, 읽기, 업데이트, 삭제 또는 목록
   • Secret vault 권한: 프로젝트의 vault 생성, 보기, 업데이트, 삭제 및 동기화(새로고침)
   • Secrets 권한: 자격 증명에서 secret 사용
   • 소스 제어: 소스 제어에 푸시
5. Create role을 선택합니다.

사용자에게 사용자 지정 역할 할당#

프로젝트 관리자는 프로젝트 멤버에게 사용자 지정 역할을 할당할 수 있습니다. 사용자 지정 역할은 할당된 특정 프로젝트 내에서만 적용됩니다. 사용자는 서로 다른 프로젝트에서 다른 역할을 가질 수 있습니다.

사용자 지정 역할을 할당하려면:

1. 프로젝트를 선택합니다.
2. Project settings를 선택합니다.
3. Project members 아래에서 사용자를 찾아보거나 검색합니다.
4. 사용자를 선택하고 드롭다운에서 사용자 지정 역할을 선택합니다.
5. Save를 선택합니다.

사용자 지정 역할 편집#

기존 사용자 지정 역할을 수정하려면:

1. Settings > Project roles로 이동합니다.
2. 편집하려는 사용자 지정 역할을 찾습니다.
3. 점 세 개 메뉴 > Edit를 선택합니다.
4. 역할 이름, 설명 또는 권한을 업데이트합니다.
5. Save changes를 선택합니다.

사용자 지정 역할 복제#

기존 역할을 기반으로 새 역할을 만들려면:

1. Settings > Project roles로 이동합니다.
2. 복제하려는 역할을 찾습니다.
3. 점 세 개 메뉴 > Duplicate를 선택합니다.
4. 필요에 따라 역할 이름과 권한을 수정합니다.
5. Create role을 선택합니다.

사용자 지정 역할 삭제#

사용자 지정 역할을 삭제하려면:

1. Settings > Project roles로 이동합니다.
2. 삭제하려는 역할을 찾습니다.
3. 점 세 개 메뉴 > Delete를 선택합니다.
4. 삭제를 확인합니다.

권한 스코프 참조#

사용자 지정 역할은 권한 스코프를 사용하여 프로젝트 내에서 사용자가 할 수 있는 작업을 정의합니다. 다음은 리소스별 사용 가능한 스코프입니다:

워크플로 스코프#

• workflow:create - 새 워크플로 만들기
• workflow:read - 워크플로 세부 정보 보기
• workflow:update - 워크플로 편집
• workflow:publish - 워크플로 게시
• workflow:unpublish - 워크플로 게시 취소
• workflow:delete - 워크플로 삭제
• workflow:list - 프로젝트의 워크플로 보기
• workflow:execute-chat - 채팅 인터페이스를 통해 워크플로 실행
• workflow:move - 프로젝트 간 워크플로 이동
• workflow:share - 다른 사용자와 워크플로 공유

자격 증명 스코프#

• credential:create - 새 자격 증명 만들기
• credential:read - 자격 증명 세부 정보 보기
• credential:update - 자격 증명 편집
• credential:delete - 자격 증명 삭제
• credential:list - 프로젝트의 자격 증명 보기
• credential:move - 프로젝트 간 자격 증명 이동
• credential:share - 다른 사용자와 자격 증명 공유

프로젝트 스코프#

• project:list - 사용 가능한 프로젝트 보기
• project:read - 프로젝트 세부 정보 보기
• project:update - 프로젝트 설정 편집 (관리자 전용)
• project:delete - 프로젝트 삭제 (관리자 전용)

폴더 스코프#

• folder:create - 새 폴더 만들기
• folder:read - 폴더 내용 보기
• folder:update - 폴더 이름 바꾸기
• folder:delete - 폴더 삭제
• folder:list - 프로젝트의 폴더 보기
• folder:move - 폴더 이동

데이터 테이블 스코프#

• dataTable:create - 새 데이터 테이블 만들기
• dataTable:read - 데이터 테이블 스키마 보기
• dataTable:update - 데이터 테이블 스키마 수정
• dataTable:delete - 데이터 테이블 삭제
• dataTable:listProject - 프로젝트의 데이터 테이블 보기
• dataTable:readRow - 데이터 테이블의 행 읽기
• dataTable:writeRow - 데이터 테이블에 행 삽입 또는 업데이트

프로젝트 변수 스코프#

• projectVariable:list - 프로젝트 변수 보기
• projectVariable:read - 변수 값 보기
• projectVariable:create - 새 변수 만들기
• projectVariable:update - 변수 값 편집
• projectVariable:delete - 변수 삭제

Secret vault 스코프#

• secretsVaults:view - 프로젝트의 secret vault 보기

• secretsVaults:create - 프로젝트 내 새 secret vault 만들기

• secretsVaults:edit - secret vault 설정 편집

• secretsVaults:delete - 프로젝트의 secret vault 삭제

• secretsVaults:sync - vault의 secret 새로고침

• secrets:list - 자격 증명에서 secret 사용

소스 제어 스코프#

• sourceControl:push - 소스 제어에 변경 사항 푸시

일반적인 사용자 지정 역할 예시#

다음은 일반적인 사용 사례를 위해 만들 수 있는 사용자 지정 프로젝트 역할의 예시입니다. 이 역할들은 전체 n8n 인스턴스가 아닌 개별 프로젝트 내에서 적용됩니다.

워크플로 개발자#

워크플로만 작업하는 사용자를 위한 역할:

• workflow:create, workflow:read, workflow:update, workflow:delete, workflow:list
• credential:read, credential:list (자격 증명 수정 불가, 보기만 가능)
• project:list, project:read

자격 증명 관리자#

자격 증명을 관리하는 사용자를 위한 역할:

• credential:create, credential:read, credential:update, credential:delete, credential:list, credential:share
• workflow:read, workflow:list (자격 증명 사용을 이해하기 위해 워크플로 보기)
• project:list, project:read

Secrets 사용자#

vault를 관리하지 않고 자격 증명에서 외부 secret을 사용해야 하는 사용자를 위한 역할:

• secrets:list (자격 증명 표현식에서 secret 사용)
• credential:create, credential:read, credential:update, credential:list (secret이 포함된 자격 증명 관리)
• workflow:read, workflow:list
• project:list, project:read

워크플로 게시자#

전체 편집 접근 없이 워크플로를 게시할 수 있는 사용자를 위한 역할:

• workflow:read, workflow:list, workflow:publish, workflow:unpublish
• credential:read, credential:list
• project:list, project:read