> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/ko/configuration/overleaf-toolkit/authentication/ldap-authentication.md).
# LDAP 인증
이 기능은 다음에 의해 개발되었습니다 [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep). 여기에서는 구성에 필요한 몇 가지 문서를 제공합니다.
{% hint style="warning" %}
Overleaf는 다음을 사용합니다 **passport-ldapauth** 라이브러리는 비교적 오래되어 LDAP 호환성을 완전히 보장할 수 없습니다. 특정 LDAP ID 공급자(예: ), 로그인 실패가 발생할 수 있습니다. 따라서 가능하면 먼저 OAuth/SAML 방식을 사용하는 것이 권장됩니다.
{% endhint %}
### LDAP란 무엇인가
LDAP는 외부 ID 확인에 사용되는 인증 프로토콜입니다. Overleaf Server Pro는 표준 인증 방식과 분리된, 웹 인터페이스에 전용 LDAP 로그인 양식을 제공합니다. 사용자가 LDAP 사용자 이름과 비밀번호를 제출하면 Overleaf 백엔드는 구성된 LDAP 서버를 대상으로 자격 증명을 검증합니다. 예: `ldap://ldap:10389`.
LDAP를 위한 Server Pro 예시
### 설정
내부적으로 Overleaf LDAP는 다음을 사용합니다 [passport-ldapauth](https://github.com/vesse/passport-ldapauth) 라이브러리입니다. 이러한 구성 옵션 대부분은 다음으로 전달됩니다. `서버` config 객체는 다음을 구성하는 데 사용됩니다 `passport-ldapauth`. LDAP 구성에 문제가 있다면, 다음의 README를 읽어보는 것이 좋습니다. `passport-ldapauth` 예상하는 구성이 어떤 것인지 감을 잡아보세요.
환경 변수 `EXTERNAL_AUTH` 는 LDAP 인증 모듈을 활성화하는 데 필요합니다. 이 환경 변수는 어떤 외부 인증 방식이 활성화되는지를 지정합니다. 이 변수의 값은 목록입니다. 목록에 `ldap` 가 포함되어 있으면 LDAP 인증이 활성화됩니다.
예: `EXTERNAL_AUTH=ldap saml`
Overleaf CEP와 달리, ayaka-notes 버전에서는 LDAP 인증을 순수 인증 방식으로 제한하며, 다음에서 사용할 수 있습니다. `http://your-overleaf.com/ldap/login`.
LDAP 인증 방식을 사용할 때 사용자는 로그인 양식에 `사용자 이름` 및 `비밀번호` 를 입력하면, 다음이 시도됩니다:
1. 다음 필터로 LDAP 디렉터리에서 LDAP 사용자를 검색합니다. `OVERLEAF_LDAP_SEARCH_FILTER` 를 사용하여 인증합니다.
2. 인증이 성공하면, Overleaf 사용자 데이터베이스에서 인증된 LDAP 사용자의 이메일 주소와 일치하는 기본 이메일 주소를 가진 사용자를 확인합니다:
* 일치하는 사용자가 발견되면, `hashedPassword` 필드를 삭제합니다(존재하는 경우). 이렇게 하면 사용자는 앞으로 LDAP 인증으로만 로그인할 수 있습니다.
* 일치하는 사용자가 없으면, LDAP 서버에서 가져온 이메일, 이름, 성을 사용하여 새로운 Overleaf 사용자가 생성됩니다.
{% hint style="danger" %}
LDAP를 통해 로그인하는 사용자의 경우, Overleaf Mongo 데이터베이스에 해시된 비밀번호를 저장하지 않습니다(또는 기존 해시를 제거합니다).
{% endhint %}
#### 환경 변수
* `OVERLEAF_LDAP_URL` **(필수)**
* LDAP 서버의 URL입니다.
* 예: `ldaps://ldap.example.com:636` (SSL을 통한 LDAP)
* 예: `ldap://ldap.example.com:389` (암호화되지 않음 또는 구성된 경우 STARTTLS).
* `OVERLEAF_LDAP_IDENTITY_SERVICE_NAME`
* 로그인 페이지에서 사용되는 LDAP ID 서비스의 표시 이름입니다.
* 기본값: `LDAP 공급자로 로그인`.
* `OVERLEAF_LDAP_EMAIL_ATT`
* LDAP 서버가 반환하는 이메일 속성으로, 기본값은 `mail`입니다. 각 LDAP 사용자는 최소 하나의 이메일 주소를 가져야 합니다. 여러 주소가 제공되면 첫 번째 주소만 사용됩니다.
* `OVERLEAF_LDAP_FIRST_NAME_ATT`
* 애플리케이션에서 사용되는 사용자의 이름을 담는 속성 이름으로, 일반적으로 `givenName`.
* `OVERLEAF_LDAP_LAST_NAME_ATT`
* 애플리케이션에서 사용되는 사용자의 성을 담는 속성 이름으로, 일반적으로 `sn`.
* `OVERLEAF_LDAP_NAME_ATT`
* 애플리케이션에서 사용되는 사용자의 전체 이름을 담는 속성 이름으로, 일반적으로 `cn`. 앞의 두 변수 중 하나라도 정의되지 않으면 사용자의 이름 및/또는 성이 이 변수에서 추출됩니다. 그렇지 않으면 사용되지 않습니다.
* `OVERLEAF_LDAP_PLACEHOLDER`
* 로그인 양식의 자리표시자로, 기본값은 `사용자 이름`.
* `OVERLEAF_LDAP_UPDATE_USER_DETAILS_ON_LOGIN`
* 다음으로 설정하면 `true`, 로그인 시 LDAP 사용자 `이름` 및 `성과` 필드를 업데이트하고, LDAP 사용자의 `/user/settings` 페이지에서 사용자 정보 양식을 비활성화합니다. 그렇지 않으면 세부 정보는 첫 로그인 시에만 가져옵니다.
* `OVERLEAF_LDAP_BIND_DN`
* LDAP 연결에 사용해야 하는 LDAP 사용자의 고유 이름입니다(이 사용자는 LDAP 서버에서 계정을 검색/나열할 수 있어야 합니다). 예: `cn=ldap_reader,dc=example,dc=com`. 정의되지 않으면 익명 바인딩이 사용됩니다.
* `OVERLEAF_LDAP_BIND_CREDENTIALS`
* 비밀번호 `OVERLEAF_LDAP_BIND_DN`.
* `OVERLEAF_LDAP_BIND_PROPERTY`
* 클라이언트에 바인딩할 사용자의 속성으로, 기본값은 `dn`.
* `OVERLEAF_LDAP_SEARCH_BASE` **(필수)**
* 사용자를 검색할 기준 DN입니다. 예: `ou=people,dc=example,dc=com`.
* `OVERLEAF_LDAP_SEARCH_FILTER`
* 사용자를 찾기 위한 LDAP 검색 필터입니다. LDAP 검색 시 주어진 사용자 이름을 삽입하려면 리터럴 '{{username}}'을 사용하세요.
* 예: `(|(uid={{username}})(mail={{username}}))` (사용자는 이메일 또는 로그인 이름으로 로그인할 수 있습니다).
* 예: `(sAMAccountName={{username}})` (Active Directory).
* `OVERLEAF_LDAP_SEARCH_SCOPE`
* 검색 범위는 `base`, `one`, 또는 `sub` (기본값).
* `OVERLEAF_LDAP_SEARCH_ATTRIBUTES`
* LDAP 서버에서 가져올 속성의 JSON 배열입니다. 예: `["uid", "mail", "givenName", "sn"]`기본적으로 모든 속성이 가져와집니다.
* `OVERLEAF_LDAP_STARTTLS`
* 만약 `true`, LDAP를 TLS를 통해 사용합니다.
* `OVERLEAF_LDAP_TLS_OPTS_CA_PATH`
* LDAP 서버의 SSL/TLS 인증서를 검증하는 데 사용되는 CA 인증서가 들어 있는 파일의 경로입니다. 인증서가 여러 개라면, 인증서 경로들의 JSON 배열일 수 있습니다. 파일은 Docker 컨테이너에서 접근 가능해야 합니다.
* 예시(인증서 1개): `/var/lib/overleaf/certs/ldap_ca_cert.pem`
* 예시(여러 인증서): `["/var/lib/overleaf/certs/ldap_ca_cert1.pem", "/var/lib/overleaf/certs/ldap_ca_cert2.pem"]`
* `OVERLEAF_LDAP_TLS_OPTS_REJECT_UNAUTH`
* 만약 `true`, 서버 인증서는 제공된 CA 목록과 비교하여 검증됩니다.
* `OVERLEAF_LDAP_CACHE`
* 만약 `true`, 그러면 한 번에 최대 100개의 자격 증명이 5분 동안 캐시됩니다.
* `OVERLEAF_LDAP_TIMEOUT`
* 클라이언트가 시간 초과 전에 작업을 유지할 수 있는 시간, ms(기본값: Infinity).
* `OVERLEAF_LDAP_CONNECT_TIMEOUT`
* 클라이언트가 TCP 연결에서 시간 초과되기 전까지 기다려야 하는 시간, ms(기본값: OS 기본값).
* `OVERLEAF_LDAP_IS_ADMIN_ATT` 및 `OVERLEAF_LDAP_IS_ADMIN_ATT_VALUE`
* 두 환경 변수가 모두 설정되면, 로그인 과정에서 `user.isAdmin = true` LDAP 프로필에 `OVERLEAF_LDAP_IS_ADMIN_ATT` 로 지정된 속성이 포함되어 있고, 그 값이 `OVERLEAF_LDAP_IS_ADMIN_ATT_VALUE` 와 일치하거나 `OVERLEAF_LDAP_IS_ADMIN_ATT_VALUE`을 포함하는 배열인 경우 `user.isAdmin` 은 `false`로 설정됩니다. 이 변수들 중 하나라도 설정되지 않으면, 관리자 상태는 `true` Launchpad에서 관리자 사용자를 생성할 때만
다음 다섯 변수는 LDAP 서버에서 사용자 연락처를 가져오는 방법을 구성하는 데 사용됩니다.
* `OVERLEAF_LDAP_CONTACTS_FILTER`
* 연락처로 불러올 LDAP 서버의 사용자를 검색하는 데 사용되는 필터입니다. 필터 내의 '{{userProperty}}' 자리표시자는 다음에 의해 지정된 속성의 값으로 대체됩니다. `OVERLEAF_LDAP_CONTACTS_PROPERTY` LDAP 검색을 시작한 사용자의 LDAP 속성에서 가져옵니다. 정의되지 않으면 LDAP 서버에서 연락처로 가져오는 사용자는 없습니다.
* `OVERLEAF_LDAP_CONTACTS_SEARCH_BASE`
* 연락처 검색을 시작할 기준 DN을 지정합니다. 기본값: `OVERLEAF_LDAP_SEARCH_BASE`.
* `OVERLEAF_LDAP_CONTACTS_SEARCH_SCOPE`
* 검색 범위는 `base`, `one`, 또는 `sub` (기본값).
* `OVERLEAF_LDAP_CONTACTS_PROPERTY`
* '{{userProperty}}' 자리표시자를 대체할 사용자 객체의 속성을 지정합니다. 다음의 `OVERLEAF_LDAP_CONTACTS_FILTER`.
* `OVERLEAF_LDAP_CONTACTS_NON_LDAP_VALUE`
* 다음의 값을 지정합니다. `OVERLEAF_LDAP_CONTACTS_PROPERTY` 검색이 비LDAP 사용자에 의해 시작된 경우. 이 변수가 정의되지 않으면 결과 필터는 아무것도 일치하지 않습니다. 값 `*` 은 와일드카드로 사용할 수 있습니다.
예시
```
OVERLEAF_LDAP_CONTACTS_FILTER=(gidNumber={{userProperty}})
OVERLEAF_LDAP_CONTACTS_PROPERTY=gidNumber
OVERLEAF_LDAP_CONTACTS_NON_LDAP_VALUE=1000
```
위 예시는 현재 LDAP 사용자의 연락처에 동일한 UNIX `gid`. 비LDAP 사용자는 모든 LDAP 사용자를 UNIX `gid=1000` 과 함께 연락처에 갖게 됩니다.
샘플 variables.env 파일
```
OVERLEAF_APP_NAME="우리 Overleaf 인스턴스"
ENABLED_LINKED_FILE_TYPES=project_file,project_output_file,url
# ImageMagick을 사용한 썸네일 생성을 활성화합니다
ENABLE_CONVERSIONS=true
# 이메일 확인 요구 사항을 비활성화합니다
EMAIL_CONFIRMATION_DISABLED=true
## Nginx
# NGINX_WORKER_PROCESSES=4
# NGINX_WORKER_CONNECTIONS=768
## nginx-proxy를 통한 TLS용으로 설정
# OVERLEAF_BEHIND_PROXY=true
# OVERLEAF_SECURE_COOKIE=true
OVERLEAF_SITE_URL=http://my-overleaf-instance.com
OVERLEAF_NAV_TITLE=우리 Overleaf 인스턴스
# OVERLEAF_HEADER_IMAGE_URL=http://somewhere.com/mylogo.png
OVERLEAF_ADMIN_EMAIL=support@example.com
OVERLEAF_LEFT_FOOTER=[{"text": "지원팀에 문의하세요", "url": "mailto:support@example.com"}]
OVERLEAF_RIGHT_FOOTER=[{"text":"안녕하세요, 저는 오른쪽에 있습니다", "url":"https://github.com/yu-i-i/overleaf-cep"}]
OVERLEAF_EMAIL_FROM_ADDRESS=team@example.com
OVERLEAF_EMAIL_SMTP_HOST=smtp.example.com
OVERLEAF_EMAIL_SMTP_PORT=587
OVERLEAF_EMAIL_SMTP_SECURE=false
# OVERLEAF_EMAIL_SMTP_USER=
# OVERLEAF_EMAIL_SMTP_PASS=
# OVERLEAF_EMAIL_SMTP_NAME=
OVERLEAF_EMAIL_SMTP_LOGGER=false
OVERLEAF_EMAIL_SMTP_TLS_REJECT_UNAUTH=true
OVERLEAF_EMAIL_SMTP_IGNORE_TLS=false
OVERLEAF_CUSTOM_EMAIL_FOOTER=이 시스템은 x 부서에서 운영합니다
OVERLEAF_PROXY_LEARN=true
NAV_HIDE_POWERED_BY=true
#################
## CE용 LDAP ##
#################
EXTERNAL_AUTH=ldap
OVERLEAF_LDAP_URL=ldap://ldap.example.com:389
OVERLEAF_LDAP_STARTTLS=true
OVERLEAF_LDAP_TLS_OPTS_CA_PATH=/var/lib/overleaf/certs/ldap_ca_cert.pem
OVERLEAF_LDAP_SEARCH_BASE=ou=people,dc=example,dc=com
OVERLEAF_LDAP_SEARCH_FILTER=(|(uid={{username}})(mail={{username}}))
OVERLEAF_LDAP_BIND_DN=cn=ldap_reader,dc=example,dc=com
OVERLEAF_LDAP_BIND_CREDENTIALS=GoodNewsEveryone
OVERLEAF_LDAP_EMAIL_ATT=mail
OVERLEAF_LDAP_FIRST_NAME_ATT=givenName
OVERLEAF_LDAP_LAST_NAME_ATT=sn
# OVERLEAF_LDAP_NAME_ATT=cn
OVERLEAF_LDAP_SEARCH_ATTRIBUTES=["uid", "sn", "givenName", "mail"]
OVERLEAF_LDAP_UPDATE_USER_DETAILS_ON_LOGIN=true
OVERLEAF_LDAP_PLACEHOLDER='사용자 이름 또는 이메일 주소'
OVERLEAF_LDAP_IS_ADMIN_ATT=mail
OVERLEAF_LDAP_IS_ADMIN_ATT_VALUE=admin@example.com
OVERLEAF_LDAP_CONTACTS_FILTER=(gidNumber={{userProperty}})
OVERLEAF_LDAP_CONTACTS_PROPERTY=gidNumber
OVERLEAF_LDAP_CONTACTS_NON_LDAP_VALUE='*'
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://ayakaleaf-pro.ayaka.space/on-premises/ko/configuration/overleaf-toolkit/authentication/ldap-authentication.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.