Lightweight Directory Access Protocol (LDAP)
n8n v2.42요약
LDAP는 다음 플랜에서 사용할 수 있습니다. n8n 인스턴스 소유자 계정에 대한 접근 권한이 필요합니다. 이 페이지에서는 n8n에서 LDAP를 활성화하는 방법을 설명합니다. LDAP를 사용하면 사용자가 n8n 로그인 대신 조직의 자격 증명으로 n8n에 로그인할 수 있습니다.
기능 제공 범위
LDAP는 다음 플랜에서 사용할 수 있습니다.
- n8n Cloud: Enterprise
- Self-hosted: Business, Enterprise
n8n 인스턴스 소유자 계정에 대한 접근 권한이 필요합니다.
이 페이지에서는 n8n에서 LDAP를 활성화하는 방법을 설명합니다. 이 페이지는 사용자가 LDAP에 익숙하고 기존 LDAP 서버가 이미 설정되어 있다고 가정합니다.
LDAP를 사용하면 사용자가 n8n 로그인 대신 조직의 자격 증명으로 n8n에 로그인할 수 있습니다.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
LDAP 활성화#
- 인스턴스 소유자로 n8n에 로그인합니다.
- Settings
> LDAP를 선택합니다. - Enable LDAP Login을 켭니다.
- LDAP 서버 정보로 필드를 채웁니다. 연결 설정을 참고하세요.
- Test connection을 선택하여 연결 설정을 확인하거나, Save connection을 선택하여 연결을 생성합니다.
LDAP를 활성화하면 User Filter 설정으로 제외하지 않는 한, LDAP 서버에 있는 모든 사용자가 n8n 인스턴스에 로그인할 수 있습니다.
Settings > Users 페이지에서 LDAP를 사용하지 않는 사용자(이메일 사용자)를 계속 만들 수 있습니다.
연결 설정#
이 필드들은 Enable LDAP Login을 켜면 표시됩니다.
| 필드 | 입력할 내용 |
|---|---|
| LDAP Login | 로그인 페이지의 사용자 이름 필드에 Email 대신 n8n이 표시하는 레이블입니다. |
| LDAP Server Address | LDAP 서버의 IP 주소 또는 도메인입니다. |
| LDAP Server Port | n8n이 연결하는 포트입니다. n8n은 표준 LDAP 포트인 389를 미리 채워 둡니다. TLS를 선택하면 서버의 LDAPS 포트로 변경하세요. 기본값은 636입니다. |
| Connection Security | None, TLS 또는 STARTTLS입니다. TLS는 ldaps://로 연결합니다. None과 STARTTLS는 ldap://로 연결합니다. STARTTLS는 이후 해당 연결을 TLS로 업그레이드합니다. |
| Ignore SSL/TLS Issues | 인증서 검증에 실패해도 연결합니다. 이 필드는 Connection Security가 None이 아닐 때만 표시됩니다. |
| Base DN | n8n이 디렉터리 트리에서 사용자 검색을 시작하는 위치입니다. 예: o=acme,dc=example,dc=com |
| Binding as | Admin 또는 Anonymous입니다. 바인드 방식을 참고하세요. |
| Binding DN | n8n이 디렉터리를 검색할 때 사용하는 계정입니다. 예: uid=2da2de69435c,ou=Users,o=Acme,dc=com 이 필드는 Binding as가 Admin일 때만 표시됩니다. |
| Binding Password | Binding DN 사용자의 비밀번호입니다. 이 필드는 Binding as가 Admin일 때만 표시됩니다. |
| User Filter | 로그인할 수 있는 사용자를 제한하는 LDAP 쿼리입니다. 예: (ObjectClass=user) 이 쿼리가 반환하는 사용자만 로그인할 수 있습니다. |
다음은 Attribute mapping 필드입니다. 이 필드들은 사용자의 ID, 로그인 ID, 이메일, 이름, 성을 위해 n8n이 읽을 LDAP 속성을 지정합니다. 올바른 값은 디렉터리에 따라 다르며, n8n이 이 필드에 표시하는 예시는 모든 서버에 맞지 않습니다. ldapsearch 같은 도구로 LDAP 서버를 쿼리한 다음, 출력에서 사용자 항목 하나를 살펴보세요. 다섯 가지 값을 각각 담고 있는 속성 이름을 확인하여 매핑 필드에 입력합니다.
동기화 필드는 마지막에 있습니다. 이 필드들은 Enable periodic LDAP synchronization을 켰을 때만 표시됩니다.
Enforce Email Uniqueness는 동기화 필드 아래, 양식 맨 아래에 있습니다. 둘 이상의 LDAP 계정이 같은 이메일 주소를 사용하면 로그인을 차단합니다.
바인드 방식#
n8n은 단순 바인드(simple bind)를 사용하여 LDAP 서버에 연결합니다. Binding as가 연결 방식을 정합니다.
- Admin: n8n이 입력한 Binding DN과 Binding Password로 바인드합니다.
- Anonymous: n8n이 빈 DN과 비밀번호를 보내므로, 서버가 익명 검색을 허용해야 합니다.
n8n은 GSSAPI와 Kerberos를 포함한 SASL 바인드를 지원하지 않습니다. SASL 메커니즘, keytab, Kerberos 티켓 캐시를 위한 필드가 없습니다. 디렉터리가 Kerberos 기반 바인딩을 요구하는 경우(Active Directory 환경에서 흔합니다) LDAP 로그인을 사용할 수 없습니다. n8n은 싱글 사인온을 위해 SAML과 OIDC도 지원합니다.
n8n 계정과 LDAP 계정 병합#
n8n이 이메일 사용자와 LDAP 사용자에 대해 일치하는 계정(일치하는 이메일)을 찾으면, 해당 사용자는 반드시 LDAP 계정으로 로그인해야 합니다. n8n 인스턴스 소유자 계정은 여기서 제외됩니다. n8n은 소유자 계정을 LDAP 사용자로 전환하지 않습니다.
n8n의 LDAP 사용자 계정#
최초 로그인 시, n8n은 해당 LDAP 사용자를 위한 사용자 계정을 n8n에 생성합니다.
사용자 세부 정보는 n8n이 아닌 LDAP 서버에서 관리해야 합니다. LDAP 서버에서 사용자를 업데이트하거나 삭제하면, 다음 예약된 동기화 시점 또는 사용자가 다음에 로그인을 시도하는 시점 중 먼저 도래하는 시점에 n8n 계정이 업데이트됩니다.
사용자 삭제
LDAP 서버에서 사용자를 제거하면, 다음 동기화 시 해당 사용자는 n8n 접근 권한을 잃습니다.
LDAP 끄기#
LDAP를 끄려면:
- 인스턴스 소유자로 n8n에 로그인합니다.
- Settings > LDAP를 선택합니다.
- Enable LDAP Login을 끕니다.
LDAP를 끄면, n8n은 기존 LDAP 사용자를 다음 로그인 시 이메일 사용자로 전환합니다. 해당 사용자는 비밀번호를 재설정해야 합니다.