사용자 관리를 위한 셀프 호스팅 n8n 구성
n8n의 사용자 관리를 통해 n8n 인스턴스에서 함께 작업할 사람들을 초대할 수 있습니다. 이 문서에서는 사용자 관리를 지원하도록 n8n 인스턴스를 구성하는 방법과 사용자 초대를 시작하는 단계를 설명합니다. 사용법에 대한 자세한 내용은 기본 사용자 관리 가이드를 참조하세요.
n8n의 사용자 관리를 통해 n8n 인스턴스에서 함께 작업할 사람들을 초대할 수 있습니다.
이 문서에서는 사용자 관리를 지원하도록 n8n 인스턴스를 구성하는 방법과 사용자 초대를 시작하는 단계를 설명합니다.
사용법에 대한 자세한 내용은 기본 사용자 관리 가이드를 참조하세요. 여기에는 다음 내용이 포함됩니다.
LDAP 설정 정보는 LDAP를 참조하세요.
SAML 설정 정보는 SAML을 참조하세요.
버전 1.0에서 n8n은:
- basic auth 및 JWT 지원을 제거했습니다.
N8N_USER_MANAGEMENT_DISABLED환경 변수를 제거했습니다. 최신 버전의 n8n에서는 로컬 또는 개발 용도를 포함하여 로그인 화면을 비활성화하는 공식 방법이 없습니다. 로컬 개발 환경에서 로그인을 간소화하려면 비밀번호 관리자 사용, 간단한 로컬 비밀번호 설정, 또는 표준 로그인 플로우를 스크립팅하는 방법을 고려하세요.
설정#
n8n에서 사용자 관리를 설정하는 세 가지 단계가 있습니다.
- SMTP 서버를 사용하도록 n8n 인스턴스를 구성합니다.
- n8n을 시작하고 앱의 설정 단계를 따릅니다.
- 사용자를 초대합니다.
1단계: SMTP#
n8n은 사용자 초대 및 비밀번호 재설정을 위해 SMTP 서버 설정을 권장합니다.
버전 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에 익숙하지 않다면, SendGrid의 블로그 포스트에서 간단한 소개를 제공하며, Wikipedia의 Simple Mail Transfer Protocol 문서에서 더 자세한 기술적 배경을 확인할 수 있습니다.
2단계: 앱 내 설정#
처음으로 사용자 관리를 설정할 때 소유자 계정을 만듭니다.
- n8n을 엽니다. 앱에 회원가입 화면이 표시됩니다.
- 세부 정보를 입력합니다. 비밀번호는 최소 8자 이상이어야 하며, 숫자와 대문자가 각각 하나 이상 포함되어야 합니다.
- 다음을 클릭합니다. n8n이 새 소유자 계정으로 로그인됩니다.
환경 변수로 인스턴스 소유자 사전 프로비저닝#
앱 내 설정 과정을 거치지 않고 환경 변수를 통해 인스턴스 소유자를 사전 프로비저닝할 수 있습니다. N8N_INSTANCE_OWNER_MANAGED_BY_ENV를 true로 설정하고 소유자 세부 정보를 제공하세요. 활성화 패턴이 어떻게 작동하는지는 환경 변수를 사용한 인스턴스 설정 관리를 참조하세요.
이 변수는 사전 해시된 bcrypt 값을 기대합니다. 평문 비밀번호를 설정하면 로그인이 불가능해집니다.
이 섹션의 내용은 원문 문서를 참조하세요. (instance-owner.md)
3단계: 사용자 초대#
이제 n8n 인스턴스에 다른 사람들을 초대할 수 있습니다.
- 소유자 계정으로 워크스페이스에 로그인합니다. (관리자 패널에 있는 경우 대시보드에서 워크스페이스를 엽니다)
- 왼쪽 하단의 사용자 아이콘 옆 세 개의 점을 클릭하고 설정을 클릭합니다. n8n이 개인 설정 페이지를 엽니다.
- 사용자를 클릭하여 사용자 페이지로 이동합니다.
- 초대를 클릭합니다.
- 새 사용자의 이메일 주소를 입력합니다.
- 사용자 초대를 클릭합니다. n8n이 새 사용자가 참여할 수 있는 링크가 포함된 이메일을 발송합니다.