Khoá truy cập được liên kết với một trang web cụ thể và chỉ có thể dùng để đăng nhập vào trang web mà khoá truy cập đó được tạo.
Thông tin này được chỉ định trong mã nhận dạng bên tin cậy (mã nhận dạng RP). Đối với khoá truy cập được tạo cho miền example.com, mã nhận dạng này có thể là www.example.com hoặc example.com.
Mặc dù mã nhận dạng bên tin cậy ngăn việc sử dụng khoá truy cập làm thông tin xác thực duy nhất để xác thực ở mọi nơi, nhưng mã này lại gây ra vấn đề cho:
- Trang web có nhiều miền: Người dùng không thể sử dụng cùng một khoá truy cập để đăng nhập vào các miền theo quốc gia (ví dụ:
example.comvàexample.co.uk) do cùng một công ty quản lý. - Miền có thương hiệu: Người dùng không thể sử dụng cùng một thông tin xác thực trên các miền khác nhau mà một thương hiệu sử dụng (ví dụ:
acme.comvàacmerewards.com). - Ứng dụng di động: Ứng dụng di động thường không có miền riêng, khiến việc quản lý thông tin xác thực trở nên khó khăn.
Có những giải pháp dựa trên liên kết danh tính và những giải pháp khác dựa trên iframe, nhưng chúng không thuận tiện trong một số trường hợp. Yêu cầu về nguồn gốc liên quan là một giải pháp.
Giải pháp
Với Yêu cầu về nguồn gốc liên quan, một trang web có thể chỉ định các nguồn gốc được phép sử dụng mã nhận dạng RP của trang web đó.
Điều này cho phép người dùng sử dụng lại cùng một khoá truy cập trên nhiều trang web mà bạn vận hành.
Để sử dụng Yêu cầu về nguồn gốc có liên quan, bạn cần phân phát một tệp JSON đặc biệt tại một URL cụ thể https://{RP ID}/.well-known/webauthn. Nếu example.com muốn cho phép các nguồn gốc bổ sung sử dụng nguồn gốc đó làm mã nhận dạng bên tin cậy, thì nguồn gốc đó phải phân phát tệp sau tại https://example.com/.well-known/webauthn:
{
"origins": [
"https://example.co.uk",
"https://example.de",
"https://example-rewards.com"
]
}
Lần tới, khi bất kỳ trang web nào trong số này thực hiện lệnh gọi để tạo khoá truy cập (navigator.credentials.create) hoặc xác thực (navigator.credentials.get) bằng example.com làm mã nhận dạng RP, trình duyệt sẽ nhận thấy mã nhận dạng RP không khớp với nguồn gốc yêu cầu. Nếu trình duyệt hỗ trợ Yêu cầu nguồn gốc có liên quan, thì trước tiên, trình duyệt sẽ tìm tệp webauthn tại https://{RP ID}/.well-known/webauthn. Nếu tệp tồn tại, trình duyệt sẽ kiểm tra xem nguồn gốc đưa ra yêu cầu có nằm trong allowlist hay không.
Nếu có, hệ thống sẽ chuyển sang các bước tạo hoặc xác thực khoá truy cập.
Nếu không hỗ trợ Yêu cầu về nguồn gốc liên quan, trình duyệt sẽ gửi SecurityError.
Hỗ trợ trình duyệt
Yêu cầu về nguồn gốc liên quan được hỗ trợ trên Chrome và Safari. Tính đến tháng 1 năm 2026, Firefox vẫn đang xem xét tính năng này. Bạn có thể theo dõi trạng thái của tính năng này trong vấn đề về vị trí tiêu chuẩn của Mozilla.
Thiết lập yêu cầu về nguồn gốc liên quan
Bản minh hoạ sau đây sử dụng hai trang web, https://ror-1.glitch.me và https://ror-2.glitch.me.
Để cho phép người dùng đăng nhập bằng cùng một khoá truy cập trên cả hai trang web đó, trang web này sử dụng Yêu cầu về nguồn gốc có liên quan để cho phép ror-2.glitch.me sử dụng ror-1.glitch.me làm mã nhận dạng bên Relying Party.
Bản minh hoạ
https://ror-2.glitch.me triển khai Yêu cầu về nguồn gốc có liên quan để sử dụng ror-1.glitch.me làm mã nhận dạng bên tin cậy, vì vậy, cả ror-1 và ror-2 đều sử dụng ror-1.glitch.me làm mã nhận dạng bên tin cậy khi tạo khoá truy cập hoặc xác thực bằng khoá truy cập.
Chúng tôi cũng đã triển khai một cơ sở dữ liệu khoá truy cập dùng chung trên các trang web này.
Hãy quan sát trải nghiệm người dùng sau đây:
- Bạn có thể tạo thành công khoá truy cập và xác thực bằng khoá truy cập đó trên
ror-2, ngay cả khi mã nhận dạng bên phụ thuộc của khoá truy cập đó làror-1(chứ không phảiror-2). - Sau khi tạo khoá truy cập trên
ror-1hoặcror-2, bạn có thể xác thực bằng khoá truy cập đó trên cảror-1vàror-2. Vìror-2chỉ địnhror-1làm mã nhận dạng bên tin cậy, nên việc tạo khoá truy cập hoặc yêu cầu xác thực từ bất kỳ trang web nào trong số này cũng giống như việc đưa ra yêu cầu trên ror-1. Mã nhận dạng RP là thứ duy nhất liên kết một yêu cầu với một nguồn gốc. - Sau khi bạn tạo khoá truy cập trên
ror-1hoặcror-2, Chrome có thể tự động điền khoá truy cập đó trên cảror-1vàror-2. - Thông tin xác thực được tạo trên bất kỳ trang web nào trong số này sẽ có mã nhận dạng RP là
ror-1.
Xem mã:
- Xem tệp
/.well-known/webauthnđược thiết lập trong toàn bộ mã nguồn ror-1. - Xem
RP_ID_RORlần xuất hiện trong toàn bộ mã nguồn ror-2.
Bước 1: Triển khai cơ sở dữ liệu tài khoản dùng chung
Nếu bạn muốn người dùng có thể đăng nhập bằng cùng một khoá truy cập trên site-1 và site-2, hãy triển khai một cơ sở dữ liệu tài khoản được chia sẻ trên hai trang web này.
Bước 2: Thiết lập tệp JSON .well-known/webauthn trong site-1
Trước tiên, hãy định cấu hình site-1.com sao cho cho phép site-2.com sử dụng làm mã nhận dạng bên tin cậy. Để làm việc này, hãy tạo tệp JSON webauthn:
{
"origins": [
"https://site-2.com"
]
}
Đối tượng JSON phải chứa khoá có tên là origins, có giá trị là một mảng gồm một hoặc nhiều chuỗi chứa nguồn gốc trang web.
Giới hạn quan trọng: Tối đa 5 nhãn
Mỗi phần tử trong danh sách này sẽ được xử lý để trích xuất nhãn eTLD + 1.
Ví dụ: nhãn eTLD + 1 của example.co.uk và example.de đều là example. Nhưng nhãn eTLD + 1 của example-rewards.com là example-rewards.
Trong Chrome, số lượng nhãn tối đa là 5.
Bước 3: Phân phát tệp JSON .well-known/webauthn trong site-1
Sau đó, phân phát tệp JSON của bạn trong site-1.com/.well-known/webauthn.
Ví dụ: trong express:
app.get("/.well-known/webauthn", (req, res) => {
const origins = {
origins: ["https://site-2.com"],
};
return res.json(origins);
});
Ở đây, chúng ta đang sử dụng res.json, vốn đã đặt content-type ('application/json') chính xác;
Bước 4: Chỉ định mã nhận dạng bên tin cậy trong trang web-2
Trong cơ sở mã site-2, hãy đặt site-1.com làm mã nhận dạng RP ở mọi nơi cần thiết:
- Sau khi tạo thông tin xác thực:
- Đặt
site-1.comlàm mã nhận dạng bên tin cậy trong quá trình tạo thông tin xác thựcoptionsđược truyền đến lệnh gọi giao diện người dùngnavigator.credentials.createvà thường được tạo phía máy chủ. - Đặt
site-1.comlàm mã nhận dạng bên tin cậy dự kiến khi bạn chạy quy trình xác minh thông tin xác thực trước khi lưu thông tin xác thực vào cơ sở dữ liệu.
- Đặt
- Sau khi xác thực:
- Đặt
site-1.comlàm mã nhận dạng bên tin cậy trongoptionsxác thực được truyền đến lệnh gọi giao diện người dùngnavigator.credentials.getvà thường được tạo phía máy chủ. - Đặt
site-1.comlàm mã nhận dạng RP dự kiến cần xác minh trên máy chủ, vì bạn chạy quy trình xác minh thông tin xác thực trước khi xác thực người dùng.
- Đặt
Khắc phục sự cố
Lưu ý khác
Chia sẻ khoá truy cập trên các trang web và ứng dụng di động
Yêu cầu về nguồn gốc liên quan cho phép người dùng sử dụng lại khoá truy cập trên nhiều trang web. Để cho phép người dùng sử dụng lại khoá truy cập trên trang web và ứng dụng di động, hãy sử dụng các kỹ thuật sau:
- Trong Chrome: Đường liên kết đến tài sản kỹ thuật số. Tìm hiểu thêm tại bài viết Thêm tính năng hỗ trợ cho Digital Asset Links (Đường liên kết đến tài sản kỹ thuật số).
- Trong Safari: Miền được liên kết.
Chia sẻ mật khẩu giữa các trang web
Yêu cầu về nguồn gốc liên quan cho phép người dùng sử dụng lại khoá truy cập trên nhiều trang web. Mỗi trình quản lý mật khẩu có giải pháp riêng để chia sẻ mật khẩu giữa các trang web. Đối với Trình quản lý mật khẩu của Google, hãy sử dụng Đường liên kết đến tài sản kỹ thuật số . Safari có một hệ thống khác.
Vai trò của trình quản lý thông tin xác thực và tác nhân người dùng
Điều này nằm ngoài phạm vi của bạn với tư cách là nhà phát triển trang web, nhưng xin lưu ý rằng về lâu dài, mã nhận dạng bên tin cậy không được là một khái niệm mà người dùng nhìn thấy trong tác nhân người dùng hoặc trình quản lý thông tin xác thực mà người dùng đang sử dụng. Thay vào đó, tác nhân người dùng và trình quản lý thông tin xác thực nên cho người dùng biết nơi thông tin xác thực của họ đã được sử dụng. Thay đổi này sẽ cần thời gian để triển khai. Một giải pháp tạm thời là hiển thị cả trang web hiện tại và trang web đăng ký ban đầu.