사용자 정의 프로젝트 역할을 사용하면 팀의 요구 사항에 맞는 특정 권한을 가진 역할을 만들 수 있습니다. 내장 프로젝트 역할(관리자, 편집자, 뷰어)과 달리, 사용자 정의 역할을 사용하면 워크플로, 자격 증명, 기타 프로젝트 리소스에 대한 세분화된 접근 권한을 정의할 수 있습니다.

사용자 정의 역할 만들기#

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

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

1. Settings > Roles > Project roles로 이동합니다.
2. Create role을 선택합니다.
3. 역할 이름과 선택적으로 설명을 입력합니다.
4. 이 역할에 대한 권한(범위)을 선택합니다:
   • 워크플로 권한: 워크플로에 대한 보기, 실행, 편집, 생성, 게시, 이전, 삭제, 또는 데이터 편집(redaction) 관리
   • 자격 증명 권한: 자격 증명에 대한 보기, 편집, 생성, 공유, 공유 해제, 이전, 삭제
   • 프로젝트 권한: 프로젝트 보기, 편집, 삭제
   • 폴더 권한: 폴더에 대한 보기, 편집, 생성, 이전, 삭제
   • 실행 권한: 편집(redaction)된 실행 데이터 표시
   • 시크릿 볼트 권한: 프로젝트의 시크릿 볼트에 대한 보기, 생성, 편집, 삭제, 동기화
   • 시크릿 권한: 자격 증명에서 시크릿 사용
   • 데이터 테이블 권한: 테이블 보기, 행 보기, 테이블 편집, 행 편집, 생성, 테이블 삭제
   • 프로젝트 변수 권한: 프로젝트 변수에 대한 보기, 편집, 생성, 삭제
   • 소스 컨트롤: 소스 컨트롤에 푸시
5. Create role을 선택합니다.

사용자에게 사용자 정의 역할 할당하기#

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

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

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

사용자 정의 역할 편집하기#

기존 사용자 정의 역할을 업데이트하려면:

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

사용자 정의 역할 복제하기#

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

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

사용자 정의 역할 삭제하기#

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

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

권한 범위 참조#

사용자 정의 역할은 권한 범위(scope)를 사용하여 프로젝트 내에서 사용자가 수행할 수 있는 작업을 정의합니다. 아래의 각 범위는 Project roles 편집기의 체크박스에 대응합니다. 섹션 제목은 편집기의 섹션 이름과 일치하며, 범위 코드는 API 응답과 감사 로그에서 볼 수 있는 값입니다.

워크플로 범위#

• workflow:create - 새 워크플로 생성
• workflow:read - 워크플로 세부 정보 보기
• workflow:update - 워크플로 편집
• workflow:execute - 워크플로 실행
• workflow:publish - 워크플로 게시(workflow:unpublish도 함께 부여됨)
• workflow:delete - 워크플로 삭제
• workflow:move - 프로젝트 간 워크플로 이전
• workflow:enableRedaction - 워크플로에 대한 데이터 편집(redaction) 켜기(실행 데이터 편집 참고)
• workflow:disableRedaction - 워크플로에 대한 데이터 편집(redaction) 끄기(실행 데이터 편집 참고)

자격 증명 범위#

• credential:create - 새 자격 증명 생성
• credential:read - 자격 증명 세부 정보 보기
• credential:update - 자격 증명 편집
• credential:delete - 자격 증명 삭제
• credential:move - 프로젝트 간 자격 증명 이전
• credential:share - 다른 사용자와 자격 증명 공유
• credential:unshare - 자격 증명 공유 해제

프로젝트 범위#

• project:read - 프로젝트 세부 정보 보기
• project:update - 프로젝트 설정 편집
• project:delete - 프로젝트 삭제

폴더 범위#

• folder:create - 새 폴더 생성
• folder:read - 폴더 내용 보기
• folder:update - 폴더 이름 변경
• folder:delete - 폴더 삭제
• folder:move - 폴더 이전

실행 범위#

• execution:reveal - 편집(redaction)된 실행 데이터 표시(실행 데이터 편집 참고)

시크릿 볼트 범위#

범위 코드는 externalSecretsProvider 접두사를 사용합니다. 역할 편집기에서는 이 섹션을 Secrets vaults로 표시합니다.

• externalSecretsProvider:create - 프로젝트에서 새 시크릿 볼트 생성
• externalSecretsProvider:read - 프로젝트의 시크릿 볼트 보기
• externalSecretsProvider:update - 시크릿 볼트 구성 편집
• externalSecretsProvider:delete - 프로젝트에서 시크릿 볼트 삭제
• externalSecretsProvider:sync - 볼트의 시크릿 다시 불러오기

시크릿 범위#

범위 코드는 externalSecret 접두사를 사용합니다. 역할 편집기에서는 이 섹션을 Secrets로 표시합니다.

• externalSecret:list - 자격 증명에서 시크릿 사용

데이터 테이블 범위#

• dataTable:create - 새 데이터 테이블 생성
• dataTable:read - 데이터 테이블 스키마 보기
• dataTable:update - 데이터 테이블 스키마 편집
• dataTable:delete - 데이터 테이블 삭제
• dataTable:readRow - 데이터 테이블에서 행 읽기
• dataTable:writeRow - 데이터 테이블에 행 삽입 또는 업데이트

프로젝트 변수 범위#

• projectVariable:create - 새 변수 생성
• projectVariable:read - 변수 값 보기
• projectVariable:update - 변수 값 편집
• projectVariable:delete - 변수 삭제

소스 컨트롤 범위#

• sourceControl:push - 소스 컨트롤에 변경 사항 푸시

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

다음은 일반적인 사용 사례를 위해 만들 수 있는 사용자 정의 프로젝트 역할의 예시입니다. 이러한 역할은 전체 n8n 인스턴스가 아니라 개별 프로젝트 내에 적용된다는 점을 기억하세요.

워크플로 개발자#

워크플로만 다루는 사용자를 위한 역할:

• workflow:create, workflow:read, workflow:update, workflow:execute, workflow:delete
• credential:read (자격 증명을 보지만 편집하지는 않음)
• project:read

자격 증명 관리자#

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

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

시크릿 사용자#

볼트를 관리하지는 않지만 자격 증명에서 외부 시크릿을 사용하는 사용자를 위한 역할:

• externalSecret:list (자격 증명 표현식에서 시크릿 사용)
• credential:create, credential:read, credential:update (시크릿을 사용하는 자격 증명 관리)
• workflow:read
• project:read

워크플로 게시자#

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

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