Tài liệu này mô tả các phương pháp hay nhất để sử dụng tính năng đăng nhập chuyển hướng trên các trình duyệt chặn cookie của bên thứ ba. Bạn phải làm theo một trong các lựa chọn được liệt kê tại đây để signInWithRedirect() hoạt động như dự kiến trong môi trường thực tế, trên mọi trình duyệt.
Tổng quan
Để quy trình signInWithRedirect() diễn ra liền mạch cho bạn và người dùng, SDK JavaScript của Firebase Authentication sử dụng một iframe nhiều nguồn gốc kết nối với miền Lưu trữ Firebase của ứng dụng.
Tuy nhiên, cơ chế này không hoạt động với các trình duyệt chặn quyền truy cập vào bộ nhớ của bên thứ ba.
Vì việc yêu cầu người dùng tắt tính năng phân vùng bộ nhớ trên trình duyệt hiếm khi là một lựa chọn, nên bạn nên áp dụng một trong các lựa chọn thiết lập sau cho ứng dụng của mình, tuỳ thuộc vào trường hợp sử dụng cụ thể.
- Nếu lưu trữ ứng dụng bằng Firebase Hosting trên một miền con của
firebaseapp.com, thì bạn sẽ không bị ảnh hưởng bởi vấn đề này và không cần làm gì cả. - Nếu bạn lưu trữ ứng dụng bằng Lưu trữ Firebase trên một miền tuỳ chỉnh hoặc miền con của
web.app, hãy sử dụng Cách 1. - Nếu bạn lưu trữ ứng dụng bằng một dịch vụ không phải Firebase, hãy sử dụng Cách 2, Cách 3, Cách 4 hoặc Cách 5.
Cách 1: Cập nhật cấu hình Firebase để sử dụng miền tuỳ chỉnh làm authDomain
Nếu đang lưu trữ ứng dụng bằng Lưu trữ Firebase thông qua một miền tuỳ chỉnh, bạn có thể định cấu hình Firebase SDK để sử dụng miền tuỳ chỉnh của mình làm authDomain. Điều này đảm bảo rằng ứng dụng của bạn và iframe xác thực sử dụng cùng một miền, giúp ngăn chặn vấn đề đăng nhập. (Nếu không sử dụng dịch vụ Lưu trữ Firebase, bạn cần sử dụng một lựa chọn khác). Đảm bảo rằng bạn đã thiết lập miền tuỳ chỉnh trên cùng một dự án mà bạn đang dùng để xác thực.
Để cập nhật cấu hình Firebase nhằm sử dụng miền tuỳ chỉnh làm miền xác thực, hãy làm như sau:
Định cấu hình SDK JS của Firebase để sử dụng miền tuỳ chỉnh của bạn làm
authDomain:const firebaseConfig = { apiKey: "<api-key>", authDomain: "<the-domain-that-serves-your-app>", databaseURL: "<database-url>", projectId: "<project-id>", appId: "<app-id>" };
Thêm
authDomainmới vào danh sách URI chuyển hướng được uỷ quyền của nhà cung cấp OAuth. Cách thực hiện sẽ phụ thuộc vào nhà cung cấp, nhưng nhìn chung, bạn có thể làm theo phần "Trước khi bắt đầu" trong bất kỳ nhà cung cấp nào để biết hướng dẫn chính xác (ví dụ: nhà cung cấp Facebook). URI được cập nhật để uỷ quyền có dạng nhưhttps://<the-domain-that-serves-your-app>/__/auth/handler— dấu/__/auth/handlerở cuối là rất quan trọng.Tương tự, nếu bạn đang sử dụng một nhà cung cấp SAML, hãy thêm
authDomainmới vào URL của Dịch vụ xác nhận người dùng (ACS) SAML.Đảm bảo
continue_uricủa bạn có trong danh sách miền được uỷ quyền.Triển khai lại bằng Lưu trữ Firebase nếu cần để tìm nạp tệp cấu hình Firebase mới nhất được lưu trữ tại
/__/firebase/init.json.
Cách 2: Chuyển sang signInWithPopup()
Sử dụng signInWithPopup() thay vì signInWithRedirect(). Phần còn lại của mã ứng dụng vẫn giữ nguyên, nhưng đối tượng UserCredential được truy xuất theo cách khác.
Web
// Before
// ==============
signInWithRedirect(auth, new GoogleAuthProvider());
// After the page redirects back
const userCred = await getRedirectResult(auth);
// After
// ==============
const userCred = await signInWithPopup(auth, new GoogleAuthProvider());
Web
// Before
// ==============
firebase.auth().signInWithRedirect(new firebase.auth.GoogleAuthProvider());
// After the page redirects back
var userCred = await firebase.auth().getRedirectResult();
// After
// ==============
var userCred = await firebase.auth().signInWithPopup(
new firebase.auth.GoogleAuthProvider());
```
Đăng nhập bằng cửa sổ bật lên không phải lúc nào cũng phù hợp với người dùng. Đôi khi, cửa sổ bật lên bị thiết bị hoặc nền tảng chặn và quy trình này không mượt mà đối với người dùng thiết bị di động. Nếu việc sử dụng cửa sổ bật lên là một vấn đề đối với ứng dụng của bạn, thì bạn cần phải làm theo một trong các lựa chọn khác.
Cách 3: Yêu cầu xác thực proxy đến firebaseapp.com
Quy trình signInWithRedirect bắt đầu bằng cách chuyển hướng từ miền ứng dụng của bạn đến miền được chỉ định trong tham số authDomain trong cấu hình firebase (mặc định là "authDomain lưu trữ mã trợ giúp đăng nhập để chuyển hướng đến Nhà cung cấp danh tính. Khi thành công, mã này sẽ chuyển hướng trở lại miền ứng dụng.
Khi quy trình xác thực quay lại miền ứng dụng của bạn, bộ nhớ trình duyệt của miền trợ giúp đăng nhập sẽ được truy cập. Lựa chọn này và lựa chọn tiếp theo (để tự lưu trữ mã) sẽ loại bỏ quyền truy cập vào bộ nhớ khác nguồn gốc, nếu không thì trình duyệt sẽ chặn quyền truy cập này.
Thiết lập proxy đảo ngược trên máy chủ ứng dụng để các yêu cầu GET/POST đến
https://<app domain>/__/auth/được chuyển tiếp đếnhttps://<project>.firebaseapp.com/__/auth/. Đảm bảo rằng trình duyệt có thể thấy rõ việc chuyển tiếp này; không thể thực hiện việc này thông qua lệnh Chuyển hướng 302.Nếu bạn đang sử dụng nginx để phân phát miền tuỳ chỉnh, thì cấu hình proxy ngược sẽ có dạng như sau:
# reverse proxy for signin-helpers for popup/redirect sign in. location /__/auth { proxy_pass https://<project>.firebaseapp.com; }Làm theo các bước trong Cách 1 để cập nhật
redirect_uriđược uỷ quyền, URL ACS vàauthDomaincủa bạn. Sau khi bạn triển khai lại ứng dụng, quyền truy cập vào bộ nhớ khác nguồn gốc sẽ không còn xảy ra nữa.
Cách 4: Tự lưu trữ mã trợ giúp đăng nhập trong miền của bạn
Một cách khác để loại bỏ quyền truy cập vào bộ nhớ khác nguồn gốc là tự lưu trữ mã trợ giúp đăng nhập Firebase. Tuy nhiên, phương pháp này không áp dụng được cho tính năng đăng nhập bằng Apple hoặc SAML. Chỉ sử dụng lựa chọn này nếu bạn không thể thiết lập proxy ngược trong lựa chọn 3.
Việc lưu trữ mã trợ giúp gồm có các bước sau:
Tải các tệp xuống máy chủ lưu trữ từ vị trí
<project>.firebaseapp.combằng cách thực thi các lệnh sau:mkdir signin_helpers/ && cd signin_helpers wget https://<project>.firebaseapp.com/__/auth/handler wget https://<project>.firebaseapp.com/__/auth/handler.js wget https://<project>.firebaseapp.com/__/auth/experiments.js wget https://<project>.firebaseapp.com/__/auth/iframe wget https://<project>.firebaseapp.com/__/auth/iframe.js wget https://<project>.firebaseapp.com/__/auth/links wget https://<project>.firebaseapp.com/__/auth/links.js wget https://<project>.firebaseapp.com/__/firebase/init.jsonLưu trữ các tệp trên trong miền ứng dụng của bạn. Đảm bảo rằng máy chủ web của bạn có thể phản hồi
https://<app domain>/__/auth/<filename>vàhttps://<app domain>/__/firebase/init.json.Dưới đây là máy chủ mẫu tải xuống và lưu trữ các tệp.
Làm theo các bước trong Cách 1 để cập nhật
redirect_uriđược uỷ quyền vàauthDomaincủa bạn. Sau khi bạn triển khai lại ứng dụng, quyền truy cập vào bộ nhớ khác nguồn gốc sẽ không còn xảy ra nữa.
Cách 5: Xử lý việc đăng nhập của nhà cung cấp một cách độc lập
Firebase Authentication SDK cung cấp
signInWithPopup() và
signInWithRedirect() dưới dạng
các phương thức thuận tiện để gói logic phức tạp và tránh phải sử dụng
một SDK khác. Bạn có thể tránh hoàn toàn việc sử dụng cả hai phương thức bằng cách đăng nhập độc lập vào nhà cung cấp, sau đó sử dụng signInWithCredential() để trao đổi thông tin đăng nhập của nhà cung cấp lấy thông tin xác thực Firebase.
Ví dụ: bạn có thể sử dụng
SDK Đăng nhập bằng Google,
mã mẫu
để lấy thông tin đăng nhập Tài khoản Google, sau đó tạo thực thể cho thông tin đăng nhập mới của Google
bằng cách chạy mã sau:
Web
// `googleUser` from the onsuccess Google Sign In callback.
// googUser = gapi.auth2.getAuthInstance().currentUser.get();
const credential = GoogleAuthProvider.credential(googleUser.getAuthResponse().id_token);
const result = await signInWithCredential(auth, credential);
Web
// `googleUser` from the onsuccess Google Sign In callback.
const credential = firebase.auth.GoogleAuthProvider.credential(
googleUser.getAuthResponse().id_token);
const result = await firebase.auth().signInWithCredential(credential);
Sau khi bạn gọi signInWithCredential(), phần còn lại của ứng dụng sẽ hoạt động giống như trước đây.
Bạn có thể xem hướng dẫn về cách lấy thông tin xác thực của Apple tại đây.