> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/vi/xac-thuc/google-auth.md).

# Sử dụng Google cho xác thực

Hướng dẫn từng bước để cấu hình Google làm nguồn ủy quyền OAuth2 trong VergeOS, bao gồm lấy thông tin xác thực và tạo người dùng.

VergeOS có thể được cấu hình để cho phép người dùng xác thực bằng thông tin đăng nhập Google doanh nghiệp của họ. Trang này sẽ hướng dẫn bạn qua quy trình cấu hình.

## Cấu hình một nguồn ủy quyền Google

1. Lấy **Mã ứng dụng khách** và **Bí mật ứng dụng khách** từ hệ thống Google. Các giá trị này nên được tạo dựa trên URL công khai của hệ thống VergeOS. Xem tài liệu Google để biết hướng dẫn, chẳng hạn như [**https://developers.google.com/identity/protocols/oauth2**](https://developers.google.com/identity/protocols/oauth2)

{% hint style="success" %}
Mã ứng dụng khách và Bí mật ứng dụng khách thường có thể được tạo tại: [***https://console.developers.google.com***](https://console.developers.google.com/)
{% endhint %}

2. Nhấp **Hệ thống** trên menu phía trên.
3. Chọn **Nguồn xác thực**.
4. Nhấp **Mới** trên menu bên trái.
5. Nhập một ***Tên*** cho nguồn này (chẳng hạn như "Google"). Tên này sẽ xuất hiện trên nút đăng nhập của trang đăng nhập VergeOS.
6. Trong ***Trình điều khiển*** trường (danh sách thả xuống), chọn **Google**.
7. ***URI chuyển hướng*** nên được điền bằng URL của hệ thống VergeOS. Đây phải là một địa chỉ công khai mà Google API có thể truy cập.
8. Nhập các ***Mã ứng dụng khách*** và ***Bí mật ứng dụng khách*** giá trị nhận được từ Google.
9. ***Các trường người dùng từ xa*** là danh sách các trường được dùng để tìm người dùng Google ban đầu; trường này được tự động điền bằng (sub,preferred\_username,email nickname), một danh sách mặc định thường có thể hoạt động cho các triển khai Google. **Lưu ý: Vì lý do bảo mật, không nên xác định người dùng từ xa dựa trên các trường có thể bị người dùng cuối thay đổi trên hệ thống từ xa.**
10. **Tùy chọn (Khuyến nghị bật các tùy chọn này.)**
    * ***Cập nhật người dùng từ xa:*** - sau khi người dùng được xác định trong hệ thống Google, cập nhật người dùng VergeOS *Tên người dùng từ xa* thành ID duy nhất tương ứng của Google (chuỗi sub)
    * **Cập nhật địa chỉ email của người dùng:** - cập nhật địa chỉ email của người dùng VergeOS để khớp với địa chỉ email trong Google.
    * **Cập nhật tên hiển thị của người dùng:** - cập nhật tên hiển thị của người dùng VergeOS để khớp với tên hiển thị trong Google.

{% hint style="success" %}
**Bật&#x20;*****Cập nhật người dùng từ xa*****&#x20;trường sẽ cho phép hệ thống VergeOS lưu ID Google duy nhất trong bản ghi người dùng VergeOS (sau khi ban đầu xác định người dùng Google bằng các trường được định nghĩa trong Các trường người dùng từ xa), để mã định danh duy nhất này có thể được dùng về sau để tìm người dùng Google; điều này thường được khuyến nghị vì các trường như địa chỉ email có thể thay đổi.**
{% endhint %}

11. **Các trường tùy chọn bổ sung** Xem [**Nguồn ủy quyền - Tổng quan**](https://docs.verge.io/run-the-platform/vi/xac-thuc/auth-sources-general.md) để biết thông tin về các trường tùy chọn bổ sung.
12. Sau khi hoàn tất cấu hình, nhấp **Gửi** để lưu nguồn ủy quyền mới.

## Thêm người dùng VergeOS sẽ sử dụng xác thực Google

Sau khi nguồn ủy quyền được tạo, có thể tạo người dùng để sử dụng nguồn Google cho đăng nhập. **Tạo người dùng VergeOS mới với cấu hình sau:**

* ***Nguồn ủy quyền:*** Chọn nguồn Google từ danh sách thả xuống
* ***Tên người dùng:*** tên duy nhất trong hệ thống VergeOS; thường khuyến nghị sử dụng cùng tên đăng nhập dùng trong Google.
* ***Tên người dùng từ xa:*** sử dụng giá trị của một trong các trường được định nghĩa là trường Người dùng từ xa, là các trường được tìm kiếm trong Google; địa chỉ email người dùng hoặc chuỗi sub, tương đương với ID Google của người dùng, thường là tốt nhất.
* ***Tên hiển thị:*** (tùy chọn) Nếu *Cập nhật tên hiển thị của người dùng* được bật trên nguồn xác thực Google, tên hiển thị sẽ được đồng bộ từ người dùng Google.
* ***Địa chỉ email:*** (tùy chọn) Nếu *Cập nhật địa chỉ email của người dùng* được bật trên nguồn xác thực Google, địa chỉ email sẽ được đồng bộ từ người dùng Google.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/run-the-platform/vi/xac-thuc/google-auth.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
