Trạng thái vượt qua trong các thao tác qua email

Bạn có thể chuyển trạng thái qua URL tiếp tục khi gửi các tác vụ email để đặt lại mật khẩu hoặc xác minh email của người dùng. Điều này cung cấp cho người dùng khả năng quay lại ứng dụng sau khi hành động hoàn tất. Ngoài ra, bạn có thể chỉ định xem có xử lý liên kết hành động email trực tiếp từ ứng dụng di động hay không khi nó được cài đặt thay vì trang web.

Điều này có thể cực kỳ hữu ích trong các trường hợp phổ biến sau:

  • Một người dùng, hiện chưa đăng nhập, có thể đang cố truy cập nội dung yêu cầu người dùng đăng nhập. Tuy nhiên, người dùng có thể đã quên mật khẩu của họ và do đó kích hoạt quy trình đặt lại mật khẩu. Khi kết thúc quy trình, người dùng sẽ quay lại phần của ứng dụng mà họ đang cố gắng truy cập.

  • Một ứng dụng chỉ có thể cung cấp quyền truy cập vào các tài khoản đã xác minh. Ví dụ: một bản tin có thể yêu cầu người dùng xác minh email của họ trước khi đăng ký. Người dùng sẽ thực hiện quy trình xác minh email và mong đợi quay lại ứng dụng để hoàn tất đăng ký của họ.

  • Trong các trường hợp khác, người dùng có thể đã bắt đầu quy trình từ thiết bị di động của họ và mong đợi sau khi xác minh sẽ quay lại ứng dụng di động của họ thay vì trình duyệt.

Khả năng chuyển trạng thái qua URL tiếp tục là một tính năng mạnh mẽ mà Firebase Auth cung cấp và có thể cải thiện đáng kể trải nghiệm người dùng.

Chuyển trạng thái / URL tiếp tục trong các tác vụ email

Để chuyển URL tiếp tục một cách an toàn, miền cho URL sẽ cần được thêm làm miền được ủy quyền trong bảng điều khiển Firebase . Điều này được thực hiện trong phần Xác thực bằng cách thêm miền này vào danh sách các miền được Ủy quyền trong tab Phương thức đăng nhập nếu miền này chưa có.

Cần cung cấp phiên bản firebase.auth.ActionCodeSettings khi gửi email đặt lại mật khẩu hoặc email xác minh. Giao diện này có các tham số sau:

Tham số Loại Sự miêu tả
url chuỗi

Đặt liên kết (URL trạng thái / tiếp tục) có các ý nghĩa khác nhau trong các ngữ cảnh khác nhau:

  • Khi liên kết được xử lý trong các tiện ích tác vụ web, đây là liên kết sâu trong tham số truy vấn continueUrl .
  • Khi liên kết được xử lý trực tiếp trong ứng dụng, đây là tham số truy vấn continueUrl trong liên kết sâu của Liên kết động.
iOS ({packId: string} | không xác định) Đặt ID gói iOS. Thao tác này sẽ cố gắng mở liên kết trong ứng dụng iOS nếu nó được cài đặt. Ứng dụng iOS cần được đăng ký trong Bảng điều khiển.
android ({packageName: string, installApp: boolean | undefined, MinimumVersion: string | undefined} | undefined) Đặt tên gói Android. Thao tác này sẽ cố gắng mở liên kết trong ứng dụng Android nếu nó được cài đặt. Nếu installApp được thông qua, nó sẽ chỉ định có cài đặt ứng dụng Android hay không nếu thiết bị hỗ trợ và ứng dụng chưa được cài đặt. Nếu trường này được cung cấp mà không có packageName , thì sẽ xảy ra lỗi giải thích rằng tên packageName phải được cung cấp cùng với trường này. Nếu minimumVersion được chỉ định và phiên bản cũ hơn của ứng dụng được cài đặt, người dùng sẽ được đưa đến Cửa hàng Play để nâng cấp ứng dụng. Ứng dụng Android cần được đăng ký trong Bảng điều khiển.
handleCodeInApp (boolean | undefined) Trước tiên, liên kết hành động email sẽ được mở trong ứng dụng dành cho thiết bị di động hay liên kết web. Mặc định này sai. Khi được đặt thành true, liên kết mã hành động sẽ được gửi dưới dạng Liên kết chung hoặc Liên kết ứng dụng Android và sẽ được ứng dụng mở nếu được cài đặt. Trong trường hợp sai, mã sẽ được gửi đến tiện ích web trước tiên và sau đó tiếp tục sẽ chuyển hướng đến ứng dụng nếu được cài đặt.
dynamicLinkDomain (chuỗi | không xác định) Đặt miền liên kết động (hoặc miền phụ) để sử dụng cho liên kết hiện tại nếu nó được mở bằng Liên kết động Firebase. Vì nhiều miền liên kết động có thể được định cấu hình cho mỗi dự án, trường này cung cấp khả năng chọn một cách rõ ràng. Nếu không có miền nào được cung cấp, miền đầu tiên được sử dụng theo mặc định.

Ví dụ sau minh họa cách gửi liên kết xác minh email sẽ mở trong ứng dụng dành cho thiết bị di động trước tiên dưới dạng Liên kết động Firebase bằng cách sử dụng miền liên kết động tùy chỉnh example.page.link (ứng dụng iOS com.example.ios hoặc ứng dụng Android com.example.android nơi ứng dụng sẽ cài đặt nếu chưa được cài đặt và phiên bản tối thiểu là 12 ). Liên kết sâu sẽ chứa tải trọng URL tiếp tục https://www.example.com/?email=user@example.com .

var actionCodeSettings = {
  url: 'https://www.example.com/?email=' + firebase.auth().currentUser.email,
  iOS: {
    bundleId: 'com.example.ios'
  },
  android: {
    packageName: 'com.example.android',
    installApp: true,
    minimumVersion: '12'
  },
  handleCodeInApp: true,
  // When multiple custom dynamic link domains are defined, specify which
  // one to use.
  dynamicLinkDomain: "example.page.link"
};
firebase.auth().currentUser.sendEmailVerification(actionCodeSettings)
  .then(function() {
    // Verification email sent.
  })
  .catch(function(error) {
    // Error occurred. Inspect error.code.
  });

Firebase Auth sử dụng Liên kết động Firebase khi gửi một liên kết được mở trong ứng dụng dành cho thiết bị di động. Để sử dụng tính năng này, Liên kết động cần được định cấu hình trong Bảng điều khiển Firebase.

  1. Bật liên kết động Firebase:

    1. Trong bảng điều khiển Firebase , hãy mở phần Liên kết động .
    2. Nếu bạn chưa chấp nhận các điều khoản của Liên kết động và tạo miền Liên kết động, hãy làm như vậy ngay bây giờ.

      Nếu bạn đã tạo miền Liên kết động, hãy lưu ý về nó. Miền Liên kết động thường trông giống như ví dụ sau:

      example.page.link

      Bạn sẽ cần giá trị này khi định cấu hình ứng dụng Apple hoặc Android của mình để chặn liên kết đến.

  2. Cấu hình các ứng dụng Android:

    1. Nếu bạn định xử lý các liên kết này từ ứng dụng Android của mình, thì tên gói Android cần phải được chỉ định trong cài đặt dự án Firebase Console. Ngoài ra, SHA-1 và SHA-256 của chứng chỉ ứng dụng cần phải được cung cấp.
    2. Bạn cũng sẽ cần định cấu hình bộ lọc ý định cho liên kết sâu trong tệp AndroidManifest.xml của mình.
    3. Để biết thêm về điều này, hãy tham khảo hướng dẫn Nhận liên kết động của Android .
  3. Định cấu hình ứng dụng iOS:

    1. Nếu bạn định xử lý các liên kết này từ ứng dụng iOS của mình, thì ID gói iOS cần phải được chỉ định trong cài đặt dự án Bảng điều khiển Firebase. Ngoài ra, ID cửa hàng ứng dụng và ID nhóm nhà phát triển Apple cũng cần được chỉ định.
    2. Bạn cũng sẽ cần phải định cấu hình miền liên kết chung FDL làm Miền liên kết trong khả năng ứng dụng của bạn.
    3. Nếu bạn định phân phối ứng dụng của mình cho iOS phiên bản 8 trở xuống, bạn sẽ cần đặt ID gói iOS của mình dưới dạng lược đồ tùy chỉnh cho các URL đến.
    4. Để biết thêm về điều này, hãy tham khảo hướng dẫn Nhận liên kết động iOS .

Xử lý các tác vụ email trong một ứng dụng web

Bạn có thể chỉ định xem bạn có muốn xử lý liên kết mã hành động từ ứng dụng web trước rồi chuyển hướng đến trang web hoặc ứng dụng di động khác sau khi hoàn tất thành công hay không, miễn là ứng dụng di động có sẵn. Điều này được thực hiện bằng cách đặt handleCodeInApp thành false trong đối tượng firebase.auth.ActionCodeSettings . Mặc dù không bắt buộc phải có ID gói iOS hoặc tên gói Android, nhưng việc cung cấp chúng sẽ cho phép người dùng chuyển hướng trở lại ứng dụng được chỉ định khi hoàn thành mã hành động qua email.

URL web được sử dụng ở đây, là URL được định cấu hình trong phần mẫu tác vụ email. Một mặc định được cung cấp cho tất cả các dự án. Tham khảo cách tùy chỉnh trình xử lý email để tìm hiểu thêm về cách tùy chỉnh trình xử lý hành động email.

Trong trường hợp này, liên kết trong tham số truy vấn continueUrl sẽ là liên kết FDL có trọng tải là URL được chỉ định trong đối tượng ActionCodeSettings . Mặc dù bạn có thể chặn và xử lý liên kết đến từ ứng dụng của mình mà không cần thêm bất kỳ sự phụ thuộc nào, chúng tôi khuyên bạn nên sử dụng thư viện ứng dụng FDL để phân tích cú pháp liên kết sâu cho bạn.

Khi xử lý các hành động email, chẳng hạn như xác minh email, mã hành động từ tham số truy vấn oobCode cần được phân tích cú pháp từ liên kết sâu và sau đó áp dụng qua applyActionCode để thay đổi có hiệu lực, tức là email cần được xác minh.

Xử lý các tác vụ email trong ứng dụng di động

Trước tiên, bạn có thể chỉ định xem bạn có muốn xử lý liên kết mã hành động trong ứng dụng di động của mình hay không, miễn là nó đã được cài đặt. Với các ứng dụng Android, bạn cũng có khả năng chỉ định thông qua android.installApp rằng ứng dụng sẽ được cài đặt nếu thiết bị hỗ trợ và nó chưa được cài đặt. Nếu liên kết được nhấp từ một thiết bị không hỗ trợ ứng dụng di động, liên kết đó sẽ được mở từ một trang web. Điều này được thực hiện bằng cách đặt handleCodeInApp thành true trong đối tượng firebase.auth.ActionCodeSettings . Tên gói Android hoặc ID gói iOS của ứng dụng di động cũng sẽ cần được chỉ định.

URL web dự phòng được sử dụng ở đây, khi không có ứng dụng dành cho thiết bị di động nào, là URL được định cấu hình trong phần mẫu hành động email. Một mặc định được cung cấp cho tất cả các dự án. Tham khảo cách tùy chỉnh trình xử lý email để tìm hiểu thêm về cách tùy chỉnh trình xử lý hành động email.

Trong trường hợp này, liên kết ứng dụng dành cho thiết bị di động được gửi đến người dùng sẽ là liên kết FDL có trọng tải là URL mã hành động, được định cấu hình trong Bảng điều khiển, với các tham số truy vấn oobCode , mode , apiKeycontinueUrl . Sau đó sẽ là URL ban đầu được chỉ định trong đối tượng ActionCodeSettings . Mặc dù bạn có thể chặn và xử lý liên kết đến từ ứng dụng của mình mà không cần thêm bất kỳ sự phụ thuộc nào, chúng tôi khuyên bạn nên sử dụng thư viện ứng dụng FDL để phân tích cú pháp liên kết sâu cho bạn. Mã hành động có thể được áp dụng trực tiếp từ ứng dụng dành cho thiết bị di động tương tự như cách nó được xử lý từ luồng web được mô tả trong phần tùy chỉnh trình xử lý email .

Khi xử lý các hành động email, chẳng hạn như xác minh email, mã hành động từ tham số truy vấn oobCode cần được phân tích cú pháp từ liên kết sâu và sau đó áp dụng qua applyActionCode để thay đổi có hiệu lực, tức là email cần được xác minh.