Trạng thái chuyển trong thao tác qua email

Bạn có thể truyền trạng thái thông qua URL tiếp tục khi gửi thao tác qua email để đặt lại mật khẩu hoặc xác minh email của người dùng. Điều này cho phép người dùng quay lại ứng dụng sau khi hoàn tất hành động. Ngoài ra, bạn có thể chỉ định có xử lý đường liên kết hành động trong email trực tiếp từ một ứng dụng di động khi ứng dụng đó được cài đặt hay không thay vì một 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:

• Người dùng hiện chưa đăng nhập có thể đang cố gắng truy cập vào nội dung yêu cầu người dùng phải đăng nhập. Tuy nhiên, người dùng có thể đã quên mật khẩu 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 mong muốn quay lại phần của ứng dụng mà họ đang cố gắng truy cập.

• Ứng dụng chỉ có thể cung cấp quyền truy cập vào các tài khoản đã được xác minh. Ví dụ: một ứng dụng 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ẽ trải qua quy trình xác minh email và dự kiến sẽ được chuyển về ứng dụng để hoàn tất việc đăng ký.

• Nhìn chung, khi bắt đầu quy trình đặt lại mật khẩu hoặc xác minh email trên một ứng dụng Apple, người dùng mong muốn hoàn tất quy trình này trong ứng dụng; khả năng truyền trạng thái thông qua URL tiếp tục giúp điều này trở nên khả thi.

Khả năng truyền trạng thái thông 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.

Truyền trạng thái/URL tiếp tục trong các thao tác qua email

Để truyền một URL tiếp tục một cách an toàn, bạn cần đưa miền của URL đó vào danh sách cho phép trong bảng điều khiển Firebase. Việc 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 Miền được uỷ quyền trong thẻ Phương thức đăng nhập nếu miền này chưa có trong danh sách.

Bạn cần cung cấp một thực thể 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:

Ví dụ sau đây minh hoạ cách gửi một đường liên kết xác minh email sẽ mở trong ứng dụng di động trước tiên dưới dạng một Đường liên kết động của Firebase bằng cách sử dụng miền đường liên kết động tuỳ 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). Đường 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.

final user = FirebaseAuth.instance.currentUser;

final actionCodeSettings = ActionCodeSettings(
  url: "http://www.example.com/verify?email=${user?.email}",
  iOSBundleId: "com.example.ios",
  androidPackageName: "com.example.android",
);

await user?.sendEmailVerification(actionCodeSettings);

Định cấu hình Đường liên kết động của Firebase

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

1. Bật Liên kết động của Firebase:

   1. Trong bảng điều khiển của Firebase, hãy mở mục Liên kết động.

   2. Nếu bạn chưa chấp nhận các điều khoản về Đường liên kết động và tạo một miền Đường liên kết động, hãy làm ngay.

   3. Nếu bạn đã tạo một miền cho Đường liên kết động, hãy ghi lại miền đó. Miền của Đường liên kết động thường có dạng như ví dụ sau:

      example.page.link

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

2. Định cấu hình ứng dụng Android:

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

3. Định cấu hình các ứng dụng của Apple:

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

Xử lý các thao tác với email trong ứng dụng web

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

URL trang web được dùng ở đây là URL được định cấu hình trong phần mẫu hành động qua email. Một dự án mặc định được cung cấp cho tất cả các dự án. Hãy tham khảo bài viết tuỳ chỉnh trình xử lý email để tìm hiểu thêm về cách tuỳ chỉnh trình xử lý thao tác email.

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

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

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

Bạn có thể chỉ định xem bạn có muốn xử lý đường liên kết mã thao tác trong ứng dụng di động của mình trước hay không, miễn là ứng dụng đó đã được cài đặt. Với các ứng dụng Android, bạn cũng có thể chỉ định thông qua androidInstallApp rằng ứng dụng sẽ được cài đặt nếu thiết bị hỗ trợ và chưa được cài đặt. Nếu người dùng nhấp vào đường liên kết trên một thiết bị không hỗ trợ ứng dụng di động, thì đường liên kết đó sẽ mở ra một trang web. Bạn có thể thực hiện việc này bằng cách đặt handleCodeInApp thành true trong đối tượng ActionCodeSettings. Bạn cũng cần chỉ định tên gói Android hoặc mã nhận dạng gói của ứng dụng di động.URL dự phòng của trang web được dùng ở đây (khi không có ứng dụng di động) là URL được định cấu hình trong phần mẫu hành động qua email. Một tài khoản mặc định được cung cấp cho tất cả các dự án. Hãy tham khảo bài viết tuỳ chỉnh trình xử lý email để tìm hiểu thêm về cách tuỳ chỉnh trình xử lý thao tác email.

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

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