> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/ko/user-and-project-management/user-management/migrating-to-ldap-or-saml.md).

# LDAP 또는 SAML로 마이그레이션

```
{
  _id:        '123',
  email:      'alice@example.com'
  first_name: 'Alice',
  last_name:  'Jones'
}
```

이제 회사의 LDAP/Active Directory 시스템과 통합하려고 합니다. 그 시스템에서 Alice의 상세 정보는 다음과 같습니다:

```
Alice:
  - uid:  'alicejones'
  - mail: 'alicejones@tech.example.com'
  - givenName:   'Alice'
  - sn: 'Jones'
```

목표는 앨리스가 자신의 LDAP 사용자 이름(`alicejones`)과 비밀번호로 이전 Overleaf 자격 증명 대신 로그인하게 하되, 작업 내용을 잃지 않도록 하는 것입니다. 이를 구현하는 방법은 다음과 같습니다.

{% hint style="warning" %}
이 과정에서는 다음을 다시 생성해야 합니다 **sharelatex** 컨테이너를 다시 생성해야 하므로 약간의 다운타임이 발생합니다. 먼저 테스트/스테이징 환경에서 이 과정을 진행해 보며 익숙해지는 것을 강력히 권장합니다.
{% endhint %}

{% stepper %}
{% step %}

### 사용자들에게 이메일 주소를 업데이트하도록 요청하세요

Overleaf 계정은 이메일 주소에 연결되어 있으므로, 첫 단계는 사용자들의 Overleaf 이메일을 LDAP 또는 SAML 이메일과 일치시키는 것입니다.

예를 들어, 앨리스에게 Overleaf 계정에 로그인하여 이메일을 다음에서 변경하도록 요청합니다: `alice@example.com` 에서 `alicejones@tech.example.com`.

{% hint style="warning" %}
관리자라면 본인 이메일 주소도 업데이트해야 한다는 점을 잊지 마세요.
{% endhint %}

{% hint style="success" %}
사용자가 많다면 다음을 사용할 수 있습니다: [사용자 이름 마이그레이션](/on-premises/ko/user-and-project-management/user-management/username-migration.md) 스크립트로 사용자의 기본 이메일 주소를 일괄 변경할 수 있습니다.
{% endhint %}
{% endstep %}

{% step %}

### LDAP 또는 SAML 모듈을 활성화하세요

모든 사람의 이메일 주소를 업데이트했다면, 이제 전환할 때입니다! 새 인증 방식에 맞는 올바른 환경 변수를 설정한 다음 다음을 다시 생성해야 합니다: **sharelatex** 다음을 사용하여 컨테이너를 `bin/up -d` 명령을 사용해 모든 서비스를 다시 생성합니다.

이렇게 하면 표준 Overleaf 로그인 양식이 새 LDAP 또는 SAML 로그인 양식으로 바뀝니다.

{% hint style="info" %}
LDAP 활성화에 필요한 관련 정보는 다음에서 [여기](/on-premises/ko/configuration/overleaf-toolkit/authentication/ldap-authentication.md)와 SAML 2.0 [여기](/on-premises/ko/configuration/overleaf-toolkit/authentication/saml-authentication.md).
{% endhint %}
{% endstep %}

{% step %}

### 이제 사용자는 LDAP 또는 SAML을 통해 로그인할 수 있습니다

다음에 앨리스가 로그인하면 새 양식이 표시됩니다.

![LDAP/Active Directory 로그인 페이지](/files/5b722d145e1d5d2dc51e29cf3991574bce3ec555)

LDAP 사용자 이름(`alicejones`)과 비밀번호를 입력할 수 있으며, 이메일 주소가 이제 LDAP의 주소와 일치하므로 기존 Overleaf 계정에 바로 로그인됩니다. 모든 프로젝트는 그대로 있던 위치에 있습니다.

SAML 2.0을 활성화했다면, 사용자는 버튼을 보게 되며, 이를 클릭하면 IdP로 리디렉션되어 자격 증명을 입력하게 됩니다. 인증에 성공하면 Overleaf 인스턴스로 다시 리디렉션되어 계정에 로그인됩니다.

![SAML 로그인 페이지](/files/31d9ad6682f858edefd2009942c63d88aefebd2e)

{% hint style="info" %}
자세한 내용은 [환경 변수](broken://pages/906d29a7f121d3d121ddd462343b3b44ff90041a) 로그인 페이지 경험을 사용자 지정하는 방법에 대한 정보는 해당 페이지를 참조하세요.

나중에 롤백해야 한다면, LDAP/SAML 설정을 주석 처리하고 다음을 다시 생성하기만 하면 됩니다: **sharelatex** 다음을 사용하여 컨테이너를 `bin/up -d` 명령어. 그러면 사용자는 현재 이메일 주소와 Overleaf 전용 비밀번호로 로그인할 수 있습니다.
{% endhint %}
{% endstep %}
{% endstepper %}

## 반대로: LDAP/SAML에서 기본 인증으로 전환하기

LDAP 또는 SAML을 한동안 사용해 오다가 Overleaf의 기본 로그인 시스템으로 옮기고 싶다면(아마 LDAP를 폐기했을 수도 있습니다)? 문제없습니다! 전환하는 방법은 다음과 같습니다.

{% stepper %}
{% step %}

### 모든 사람의 이메일이 올바른지 확인하세요

사용자 계정은 이미 LDAP 또는 SAML 이메일 주소에 연결되어 있습니다. 앞으로 로그인할 때 사용할 이메일이므로, 모든 것이 올바른지 확인하기만 하면 됩니다.
{% endstep %}

{% step %}

### LDAP 또는 SAML 모듈을 비활성화하세요

LDAP/SAML 구성 설정을 제거하거나 해제한 다음 다음을 다시 생성하기만 하면 됩니다: **sharelatex** 다음을 사용하여 컨테이너를 `bin/up -d` 명령어. 그러면 Overleaf 기본 이메일 및 비밀번호 로그인 양식이 다시 나타납니다.

![기본 인증 로그인 페이지](/files/78d2fff25392505367396460e046c603d89df7f5)
{% endstep %}

{% step %}

### 사용자들에게 비밀번호를 재설정하도록 요청하세요

이제 사용자가 로그인 페이지를 방문하면 LDAP/SAML 양식 대신 Overleaf 로그인 양식이 표시됩니다.

기본 Overleaf 비밀번호를 한 번도 사용한 적이 없을 수 있으므로 새 비밀번호를 만들어야 합니다. 각 사용자는 다음을 해야 합니다:

* "비밀번호를 잊으셨나요?" 링크를 클릭합니다.
* 계정에 연결된 이메일 주소(LDAP/SAML의 이메일)를 입력합니다.
* 비밀번호 재설정 이메일의 링크를 따라 새 비밀번호를 설정합니다.

{% hint style="info" %}
아직 하지 않았다면, 다음을 활성화하는 방법에 대한 가이드를 확인하세요 [이메일 전송](/on-premises/ko/configuration/overleaf-toolkit/email-delivery.md).
{% endhint %}

그게 끝나면, 이메일과 새 Overleaf 전용 비밀번호로 로그인하여 모든 프로젝트에 액세스할 수 있습니다.
{% endstep %}
{% endstepper %}


---

# 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://overleaf-pro.ayaka.space/on-premises/ko/user-and-project-management/user-management/migrating-to-ldap-or-saml.md?ask=<question>&goal=<endgoal>
```

`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.