Giờ đây, WebOTP API có thể nhận OTP từ bên trong iframe.
Mật khẩu một lần (OTP) qua SMS thường được dùng để xác minh số điện thoại, chẳng hạn như bước thứ hai trong quy trình xác thực hoặc để xác minh các khoản thanh toán trên web. Tuy nhiên, việc chuyển đổi giữa trình duyệt và ứng dụng SMS để sao chép-dán hoặc nhập OTP theo cách thủ công có thể dễ mắc lỗi và gây khó khăn cho trải nghiệm người dùng.
WebOTP API cho phép các trang web lấy mật khẩu một lần từ tin nhắn SMS theo phương thức lập trình và tự động nhập mật khẩu đó vào biểu mẫu cho người dùng chỉ bằng một lần nhấn mà không cần chuyển đổi ứng dụng. Tin nhắn SMS được định dạng đặc biệt và liên kết với nguồn gốc, nhờ đó giảm thiểu khả năng các trang web lừa đảo đánh cắp OTP.
Một trường hợp sử dụng chưa được hỗ trợ trong WebOTP là nhắm đến một nguồn gốc bên trong iframe. Thao tác này thường được dùng để xác nhận thanh toán, đặc biệt là với 3D Secure. Nhờ có định dạng chung để hỗ trợ iframe trên nhiều nguồn gốc, WebOTP API hiện cung cấp OTP liên kết với các nguồn gốc lồng nhau kể từ Chrome 91.
Cách hoạt động của WebOTP API
Bản thân WebOTP API khá đơn giản:
…
const otp = await navigator.credentials.get({
otp: { transport:['sms'] }
});
…
Tin nhắn SMS phải được định dạng bằng mã một lần liên kết với nguồn gốc.
Your OTP is: 123456.
@web-otp.example.com #12345
Lưu ý rằng ở dòng cuối cùng, dòng này chứa nguồn gốc cần liên kết, đứng trước là @, theo sau là OTP, đứng trước là #.
Khi tin nhắn văn bản đến, một thanh thông tin sẽ bật lên và nhắc người dùng xác minh số điện thoại của họ. Sau khi người dùng nhấp vào nút Verify, trình duyệt sẽ tự động chuyển tiếp OTP đến trang web và phân giải navigator.credentials.get(). Sau đó, trang web có thể trích xuất OTP và hoàn tất
quy trình xác minh.
Tìm hiểu thông tin cơ bản về cách sử dụng WebOTP tại bài viết Xác minh số điện thoại trên web bằng WebOTP API.
Trường hợp sử dụng iframe khác nguồn gốc
Việc nhập OTP vào biểu mẫu trong iframe khác nguồn gốc là điều thường thấy trong các trường hợp thanh toán. Một số công ty phát hành thẻ tín dụng yêu cầu thêm một bước xác minh để kiểm tra tính xác thực của người thanh toán. Đây được gọi là 3D Secure và biểu mẫu này thường xuất hiện trong một iframe trên cùng một trang, như thể đó là một phần của quy trình thanh toán.
Ví dụ:
- Người dùng truy cập vào
shop.exampleđể mua một đôi giày bằng thẻ tín dụng. - Sau khi nhập số thẻ tín dụng, nhà cung cấp dịch vụ thanh toán tích hợp sẽ hiển thị một biểu mẫu của
bank.exampletrong một iframe để yêu cầu người dùng xác minh số điện thoại của họ nhằm thanh toán nhanh. bank.examplegửi một tin nhắn SMS chứa OTP cho người dùng để họ có thể nhập mã đó nhằm xác minh danh tính.
Cách sử dụng API WebOTP từ một iframe khác nguồn gốc
Để sử dụng WebOTP API từ trong một iframe khác nguồn gốc, bạn cần làm hai việc:
- Chú thích cả nguồn gốc khung cấp cao nhất và nguồn gốc iframe trong tin nhắn văn bản SMS.
- Định cấu hình chính sách về quyền để cho phép iframe khác nguồn gốc nhận OTP trực tiếp từ người dùng.
Bạn có thể tự mình dùng thử bản minh hoạ tại https://web-otp-iframe-demo.stackblitz.io.
Chú thích nguồn gốc ràng buộc cho tin nhắn văn bản SMS
Khi WebOTP API được gọi từ bên trong một iframe, tin nhắn văn bản SMS phải
bao gồm nguồn gốc khung cấp cao nhất đứng trước @, theo sau là OTP đứng trước #,
theo sau là nguồn gốc iframe đứng trước @.
@shop.example #123456 @bank.exmple
Định cấu hình Chính sách về quyền
Để sử dụng WebOTP trong iframe khác nguồn gốc, trình nhúng phải cấp quyền truy cập vào API này thông qua Chính sách về quyền otp-credentials để tránh hành vi ngoài ý muốn. Nhìn chung, có hai cách để đạt được mục tiêu này:
- thông qua Tiêu đề HTTP:
Permissions-Policy: otp-credentials=(self "https://bank.example")
- thông qua thuộc tính
allowcủa iframe:
<iframe src="https://bank.example/…" allow="otp-credentials"></iframe>
Xem các ví dụ khác về cách chỉ định chính sách về quyền.
Chú ý
Mức lồng ghép
Hiện tại, Chrome chỉ hỗ trợ các lệnh gọi WebOTP API từ iframe nhiều nguồn gốc có không quá một nguồn gốc riêng biệt trong chuỗi gốc. Trong các trường hợp sau:
- a.com -> b.com
- a.com -> b.com -> b.com
- a.com -> a.com -> b.com
- a.com -> b.com -> c.com
bạn có thể sử dụng WebOTP trong b.com nhưng không thể sử dụng trong c.com.
Xin lưu ý rằng trường hợp sau đây cũng không được hỗ trợ do thiếu nhu cầu và sự phức tạp về trải nghiệm người dùng.
- a.com -> b.com -> a.com (gọi WebOTP API)
Khả năng tương tác
Mặc dù các công cụ trình duyệt không phải Chromium không triển khai API WebOTP, nhưng Safari cũng dùng chung định dạng SMS với tính năng hỗ trợ input[autocomplete="one-time-code"]. Trong Safari, ngay khi một tin nhắn SMS chứa định dạng mã một lần liên kết với nguồn gốc đến cùng với nguồn gốc khớp, bàn phím sẽ đề xuất nhập OTP vào trường nhập dữ liệu.
Kể từ tháng 4 năm 2021, Safari hỗ trợ iframe có định dạng SMS riêng biệt bằng cách sử dụng %.
Tuy nhiên, vì cuộc thảo luận về thông số kỹ thuật đã kết luận rằng nên sử dụng @, nên chúng tôi hy vọng việc triển khai định dạng SMS được hỗ trợ sẽ hội tụ.
Phản hồi
Ý kiến phản hồi của bạn là vô giá trong việc cải thiện WebOTP API, vì vậy, hãy tiếp tục và dùng thử và cho chúng tôi biết bạn nghĩ gì.