사용자 관리를 위한 self-hosted n8n 구성
n8n v2.29n8n의 사용자 관리 기능을 사용하면 사람들을 초대하여 n8n 인스턴스에서 함께 작업할 수 있습니다. 이 문서에서는 사용자 관리를 지원하도록 n8n 인스턴스를 구성하는 방법과 사용자 초대를 시작하는 단계를 설명합니다.
n8n의 사용자 관리 기능을 사용하면 사람들을 초대하여 n8n 인스턴스에서 함께 작업할 수 있습니다.
이 문서에서는 사용자 관리를 지원하도록 n8n 인스턴스를 구성하는 방법과 사용자 초대를 시작하는 단계를 설명합니다.
사용법에 대한 자세한 내용은 다음을 포함하여 메인 사용자 관리 가이드를 참고하세요.
LDAP 설정 정보는 LDAP을 참고하세요.
SAML 설정 정보는 SAML을 참고하세요.
지원되지 않는 사용자 관리 방식
버전 1.0에서 n8n은 다음과 같이 변경되었습니다.
- basic auth 및 JWT 지원 제거
N8N_USER_MANAGEMENT_DISABLED환경 변수 제거. 로컬 또는 개발 용도를 포함해 최근 버전의 n8n에서는 로그인 화면을 비활성화할 수 있는 지원 방법이 존재하지 않습니다. 로컬 개발 환경에서 로그인을 간소화해야 하는 경우, 비밀번호 관리자를 사용하거나 간단한 로컬 비밀번호를 설정하거나 표준 로그인 흐름을 스크립트로 자동화하는 방법을 고려하세요.
설정#
n8n에서 사용자 관리를 설정하는 데는 세 단계가 있습니다.
- n8n 인스턴스가 SMTP 서버를 사용하도록 구성합니다.
- n8n을 시작하고 앱에서 설정 단계를 따릅니다.
- 사용자를 초대합니다.
1단계: SMTP#
n8n은 사용자 초대 및 비밀번호 재설정을 위해 SMTP 서버를 설정할 것을 권장합니다.
0.210.1부터 선택 사항
버전 0.210.1부터 이 단계는 선택 사항입니다. SMTP를 설정하는 대신 초대 링크를 수동으로 복사하여 전송하도록 선택할 수 있습니다. 이 단계를 건너뛰면 사용자가 비밀번호를 재설정할 수 없다는 점에 유의하세요.
SMTP 제공업체로부터 다음 정보를 받으세요.
- 서버 이름
- SMTP 사용자 이름
- SMTP 비밀번호
- SMTP 발신자 이름
n8n에서 SMTP를 설정하려면 n8n 인스턴스의 SMTP 환경 변수를 구성하세요. 환경 변수 설정 방법에 대한 정보는 구성을 참고하세요.
| 변수 | 유형 | 설명 | 필수 여부 |
|---|---|---|---|
N8N_EMAIL_MODE |
string | smtp |
필수 |
N8N_SMTP_HOST |
string | 사용자의_SMTP_서버_이름 | 필수 |
N8N_SMTP_PORT |
number | 사용자의_SMTP_서버_포트 기본값은 465입니다. |
선택 |
N8N_SMTP_USER |
string | 사용자의_SMTP_사용자_이름 | 선택 |
N8N_SMTP_PASS |
string | 사용자의_SMTP_비밀번호 | 선택 |
N8N_SMTP_OAUTH_SERVICE_CLIENT |
string | 사용자의_OAuth_서비스_클라이언트 | 선택 |
N8N_SMTP_OAUTH_PRIVATE_KEY |
string | 사용자의_OAuth_개인_키 | 선택 |
N8N_SMTP_SENDER |
string | 발신자 이메일 주소입니다. 선택적으로 발신자 이름을 포함할 수 있습니다. 이름 포함 예시: n8n <contact@n8n.com> |
필수 |
N8N_SMTP_SSL |
boolean | SMTP에 SSL을 사용할지(true) 여부(false)입니다. 기본값은 true입니다. |
선택 |
N8N_UM_EMAIL_TEMPLATES_INVITE |
string | HTML 이메일 템플릿의 전체 경로입니다. 초대 이메일의 기본 템플릿을 재정의합니다. | 선택 |
N8N_UM_EMAIL_TEMPLATES_PWRESET |
string | HTML 이메일 템플릿의 전체 경로입니다. 비밀번호 재설정 이메일의 기본 템플릿을 재정의합니다. | 선택 |
N8N_UM_EMAIL_TEMPLATES_WORKFLOW_SHARED |
String | 자격 증명이 공유되었음을 사용자에게 알리는 기본 HTML 템플릿을 재정의합니다. 템플릿의 전체 경로를 제공하세요. | 선택 |
N8N_UM_EMAIL_TEMPLATES_CREDENTIALS_SHARED |
String | 자격 증명이 공유되었음을 사용자에게 알리는 기본 HTML 템플릿을 재정의합니다. 템플릿의 전체 경로를 제공하세요. | 선택 |
N8N_UM_EMAIL_TEMPLATES_PROJECT_SHARED |
String | 프로젝트가 공유되었음을 사용자에게 알리는 기본 HTML 템플릿을 재정의합니다. 템플릿의 전체 경로를 제공하세요. | 선택 |
n8n 인스턴스가 이미 실행 중인 경우, 새 SMTP 설정을 적용하려면 재시작해야 합니다.
추가 구성 옵션
환경 변수로 사용할 수 있는 더 많은 구성 옵션이 있습니다. 목록은 환경 변수를 참고하세요. 여기에는 사용자에게 태그, 워크플로 템플릿, 개인화 설문조사를 표시하고 싶지 않은 경우 이를 비활성화하는 옵션이 포함됩니다.
SMTP가 처음이신가요?
SMTP에 익숙하지 않다면, SendGrid의 블로그 게시물에서 간단한 소개를 확인할 수 있으며, 위키백과의 Simple Mail Transfer Protocol 문서에서는 더 자세한 기술적 배경을 제공합니다.
2단계: 앱 내 설정#
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
환경 변수로 인스턴스 소유자 사전 프로비저닝하기#
n8n v2.17.0부터 사용 가능
앱 내 설정 과정을 거치는 대신 환경 변수로 인스턴스 소유자를 사전 프로비저닝할 수 있습니다. N8N_INSTANCE_OWNER_MANAGED_BY_ENV를 true로 설정하고 소유자 세부 정보를 제공하세요. 활성화 패턴이 작동하는 방식은 환경 변수를 사용하여 인스턴스 설정 관리를 참고하세요.
설정 후 소유자 이메일을 변경하려면 self-hosted n8n의 인스턴스 소유자 이메일 변경을 참고하세요.
N8N_INSTANCE_OWNER_PASSWORD_HASH는 bcrypt 해시여야 합니다
이 변수에는 사전에 해시 처리된 bcrypt 값이 필요합니다. 평문 비밀번호를 설정하면 로그인이 작동하지 않습니다.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
3단계: 사용자 초대#
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.