> 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/vi/quan-ly-nguoi-dung-va-du-an/user-management/migrating-to-ldap-or-saml.md).

# Di chuyển sang LDAP hoặc SAML

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

Bây giờ, bạn muốn tích hợp với hệ thống LDAP/Active Directory của công ty bạn. Trong hệ thống đó, thông tin của Alice là:

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

Mục tiêu của bạn là để Alice đăng nhập bằng tên người dùng LDAP của họ (`alicejones`) và mật khẩu thay vì thông tin đăng nhập Overleaf cũ, mà không mất bất kỳ công việc nào của họ. Sau đây là cách thực hiện.

{% hint style="warning" %}
Quá trình này sẽ yêu cầu tạo lại **sharelatex** container, điều này sẽ gây ra một khoảng gián đoạn dịch vụ. Chúng tôi đặc biệt khuyên bạn nên làm quen với quy trình này bằng cách thử trước trên môi trường kiểm thử/staging.
{% endhint %}

{% stepper %}
{% step %}

### Yêu cầu người dùng cập nhật địa chỉ email của họ

Tài khoản Overleaf được gắn với địa chỉ email, vì vậy bước đầu tiên là đồng bộ email Overleaf của người dùng với email LDAP hoặc SAML của họ.

Trong ví dụ của chúng tôi, bạn sẽ yêu cầu Alice đăng nhập vào tài khoản Overleaf của họ và đổi email từ `alice@example.com` đến `alicejones@tech.example.com`.

{% hint style="warning" %}
Đừng quên cả chính bạn! Nếu bạn là quản trị viên, bạn cũng cần cập nhật địa chỉ email của mình.
{% endhint %}

{% hint style="success" %}
Nếu bạn có nhiều người dùng, bạn có thể dùng [Di chuyển tên người dùng](/on-premises/vi/quan-ly-nguoi-dung-va-du-an/user-management/username-migration.md) script để thay đổi hàng loạt địa chỉ email chính của người dùng.
{% endhint %}
{% endstep %}

{% step %}

### Bật mô-đun LDAP hoặc SAML

Sau khi địa chỉ email của mọi người đã được cập nhật, đã đến lúc bật công tắc! Bạn sẽ cần đặt đúng các biến môi trường cho phương thức xác thực mới rồi tạo lại **sharelatex** container bằng `bin/up -d` lệnh.

Điều này thay biểu mẫu đăng nhập Overleaf tiêu chuẩn bằng biểu mẫu LDAP hoặc SAML mới của bạn.

{% hint style="info" %}
Bạn có thể tìm thông tin liên quan để bật LDAP [tại đây](/on-premises/vi/cau-hinh/overleaf-toolkit/authentication/ldap-authentication.md), và SAML 2.0 [tại đây](/on-premises/vi/cau-hinh/overleaf-toolkit/authentication/saml-authentication.md).
{% endhint %}
{% endstep %}

{% step %}

### Người dùng giờ đây có thể đăng nhập qua LDAP hoặc SAML

Lần tới khi Alice đăng nhập, họ sẽ thấy biểu mẫu mới.

![Trang đăng nhập LDAP/Active Directory](/files/63722bc213f95c7e02d698945fe17951805135f4)

Họ có thể nhập tên người dùng LDAP của họ (`alicejones`) và mật khẩu, và vì địa chỉ email của họ giờ khớp với địa chỉ trong LDAP, họ sẽ được đăng nhập thẳng vào tài khoản Overleaf hiện có. Tất cả dự án của họ sẽ nằm đúng nơi họ đã để lại.

Nếu bạn đã bật SAML 2.0, người dùng sẽ thấy một nút; khi bấm vào, họ sẽ được chuyển hướng đến IdP của bạn để nhập thông tin xác thực. Khi xác thực thành công, họ sẽ được chuyển hướng trở lại phiên bản Overleaf của bạn và đăng nhập vào tài khoản của họ.

![Trang đăng nhập SAML](/files/c6cd46559e850ba27860d34c5b8c76fcd35435f6)

{% hint style="info" %}
Xem [Các biến môi trường](broken://pages/556eaeb4dddcb30f8e61eab36f50573c660f1752) trang để xem thông tin về việc tùy chỉnh trải nghiệm trang đăng nhập.

Và nếu bạn cần quay lui, chỉ cần comment cấu hình LDAP/SAML và tạo lại **sharelatex** container bằng `bin/up -d` lệnh. Khi đó người dùng sẽ có thể đăng nhập bằng địa chỉ email hiện tại và mật khẩu dành riêng cho Overleaf của họ.
{% endhint %}
{% endstep %}
{% endstepper %}

## Chiều ngược lại: Chuyển từ LDAP/SAML trở lại xác thực gốc

Nếu bạn đã dùng LDAP hoặc SAML một thời gian và muốn chuyển sang hệ thống đăng nhập tích hợp sẵn của Overleaf (có thể bạn đã ngừng dùng LDAP)? Không vấn đề gì! Đây là cách bạn có thể chuyển đổi.

{% stepper %}
{% step %}

### Kiểm tra rằng email của mọi người là chính xác

Tài khoản của người dùng đã được liên kết với địa chỉ email LDAP hoặc SAML của họ. Đây là email họ sẽ dùng để đăng nhập từ giờ trở đi, vì vậy chỉ cần đảm bảo mọi thứ đều chính xác.
{% endstep %}

{% step %}

### Tắt mô-đun LDAP hoặc SAML

Chỉ cần xóa hoặc bỏ đặt các cài đặt cấu hình LDAP/SAML rồi tạo lại **sharelatex** container bằng `bin/up -d` lệnh. Việc này sẽ khôi phục biểu mẫu đăng nhập bằng email và mật khẩu gốc của Overleaf.

![Trang đăng nhập xác thực gốc](/files/3758539396efc7732d6ca1eecfcfce01e198bda8)
{% endstep %}

{% step %}

### Yêu cầu người dùng đặt lại mật khẩu

Khi người dùng truy cập trang đăng nhập lúc này, họ sẽ thấy biểu mẫu đăng nhập Overleaf thay vì biểu mẫu LDAP/SAML.

Vì có thể họ chưa từng có mật khẩu Overleaf gốc, họ sẽ cần tạo một mật khẩu. Mỗi người dùng nên:

* Nhấp vào liên kết "Quên mật khẩu?".
* Nhập địa chỉ email liên kết với tài khoản của họ (địa chỉ từ LDAP/SAML).
* Làm theo liên kết trong email đặt lại mật khẩu để đặt mật khẩu mới.

{% hint style="info" %}
Nếu bạn chưa làm, hãy xem hướng dẫn của chúng tôi về việc bật [Gửi email](/on-premises/vi/cau-hinh/overleaf-toolkit/email-delivery.md).
{% endhint %}

Khi xong, họ có thể đăng nhập bằng email và mật khẩu Overleaf mới của mình để truy cập tất cả dự án của họ.
{% 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/vi/quan-ly-nguoi-dung-va-du-an/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.