> 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/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'
```

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

{% hint style="warning" %}
이 과정에서는 다음을 다시 생성해야 합니다. **sharelatex** 그러면 일부 다운타임이 발생합니다. 먼저 테스트/스테이징 환경에서 이 과정을 직접 수행해 보며 익숙해질 것을 강력히 권장합니다.
{% endhint %}

{% stepper %}
{% step %}

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

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

예를 들어, Alice에게 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을 통해 로그인할 수 있습니다

다음에 Alice가 로그인하려고 하면 새 양식이 표시됩니다.

![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://ayakaleaf-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.