Các phương pháp hay nhất để sử dụng signInWith Redirect trên trình duyệt chặn quyền truy cập vào bộ nhớ của bên thứ ba

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:

  1. Đị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>"
    };
    
  1. Thêm authDomain mớ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 authDomain mới vào URL của Dịch vụ xác nhận người dùng (ACS) SAML.

  2. Đảm bảo continue_uri của bạn có trong danh sách miền được uỷ quyền.

  3. 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à ".firebaseapp.com"). 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.

  1. 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 đến https://<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;
    }
    
  2. Làm theo các bước trong Cách 1 để cập nhật redirect_uri được uỷ quyền, URL ACS và authDomain củ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:

  1. Tải các tệp xuống máy chủ lưu trữ từ vị trí <project>.firebaseapp.com bằ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.json
    
  2. Lư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.

  3. Làm theo các bước trong Cách 1 để cập nhật redirect_uri được uỷ quyền và authDomain củ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.