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 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 được quay lại ứng dụng sau khi hoàn thành hành động. Ngoài ra, bạn có thể chỉ định có xử lý liên kết tác vụ email trực tiếp từ ứng dụng dành cho thiết bị di động khi ứng dụng này được cài đặt thay vì trang web hay không.

Điều này có thể cực kỳ hữu ích trong các tình huống phổ biến sau:

• 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 phải đă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 ứng dụng mà họ đang cố 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 đã đượ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ẽ thực hiện quy trình xác minh email và mong muốn được quay lại ứng dụng để hoàn tất đăng ký của họ.

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

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ể nâng cao đáng kể trải nghiệm người dùng.

Chuyển trạng thái/tiếp tục URL trong các hành động email

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

Phiên FIRActionCodeSettings cần được cung cấp 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 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 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 =  ActionCodeSettings.init()
actionCodeSettings.canHandleInApp = true
let user = Auth.auth().currentUser()
actionCodeSettings.URL =
    String(format: "https://www.example.com/?email=%@", user.email)
actionCodeSettings.iOSbundleID = Bundle.main.bundleIdentifier!
actionCodeSettings.setAndroidPakageName("com.example.android",
                                         installIfNotAvailable:true,
                                         minumumVersion:"12")
// When multiple custom dynamic link domains are defined, specify which one to use.
actionCodeSettings.dynamicLinkDomain = "example.page.link"
user.sendEmailVerification(withActionCodeSettings:actionCodeSettings { error in
  if error {
    // Error occurred. Inspect error.code and handle error.
    return
  }
  // Email verification sent.
})

 FIRActionCodeSettings *actionCodeSettings = [[FIRActionCodeSettings alloc] init];
 actionCodeSettings.handleCodeInApp = YES;
 FIRUser *user = [FIRAuth auth].currentUser;
 NSString *urlString =
     [NSString stringWithFormat:@"https://www.example.com/?email=%@", user.email];
 actionCodeSettings.URL = [NSURL URLWithString:urlString];
 actionCodeSettings.iOSBundleID = [NSBundle mainBundle].bundleIdentifier;
 // When multiple custom dynamic link domains are defined, specify which one to use.
 actionCodeSettings.dynamicLinkDomain = @"example.page.link";
 [actionCodeSettings setAndroidPackageName:@"com.example.android"
                     installIfNotAvailable:YES
                            minimumVersion:'12'];
 [user sendEmailVerificationWithActionCodeSettings:actionCodeSettings
                                        completion:^(NSError *_Nullable error) {
   if (error) {
     // Error occurred. Inspect error.code and handle error.
     return;
   }
   // Email verification sent.
 }];

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

Firebase Auth sử dụng Liên kết động Firebase khi gửi một liên kết được dùng để 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 một miền Liên kết động, hãy làm như vậy ngay bây giờ.

      Nếu bạn đã tạo một 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, tên gói Android cần được chỉ định trong cài đặt dự án Bảng điều khiển Firebase. Ngoài ra, cần cung cấp SHA-1 và SHA-256 của chứng chỉ ứng dụng.
   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 Android .

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

   1. Nếu bạn định xử lý các liên kết này từ ứng dụng của mình, ID gói cần đượ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 định cấu hình miền liên kết phổ quát FDL làm Miền liên kết trong khả năng ứng dụng của mình.
   3. Nếu bạn dự định phân phối ứng dụng của mình cho các phiên bản iOS 8 trở xuống, bạn sẽ cần đặt ID gói của mình làm 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 Nhận hướng dẫn Liên kết động nền tảng của Apple .

Xử lý các hành động 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ừ một ứng dụng web trước hay không và sau đó 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 khả dụng. Điều này được thực hiện bằng cách đặt handleCodeInApp thành false trong đối FIRActionCodeSettings (Obj-C) hoặc ActionCodeSettings (Swift). Mặc dù không bắt buộc phải có ID gói 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 đã 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 hành động email. Một mặc định được cung cấp cho tất cả các dự án. Tham khảo 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ý tác vụ 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ó tải trọng 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ó bất kỳ sự phụ thuộc bổ sung nào, chúng tôi khuyên bạn nên sử dụng thư viện máy khách 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 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 rồi áp dụng qua applyActionCode để thay đổi có hiệu lực, tức là email được xác minh.

Xử lý các hành động email trong một ứng dụng di động

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 dành cho thiết bị di động của mình trước 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 androidInstallIfNotAvailable rằng ứng dụng sẽ được cài đặt nếu thiết bị hỗ trợ và ứng dụng này chưa được cài đặt. Nếu liên kết được nhấp vào từ một thiết bị không hỗ trợ ứng dụng dành cho thiết bị di động, thay vào đó, 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 FIRActionCodeSettings (Obj-C) hoặc ActionCodeSettings (Swift). Tên gói hoặc ID gói Android của ứng dụng dành cho thiết bị di động cũng cần phải đượ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, 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 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ý tác vụ 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 tới người dùng sẽ là một liên kết FDL có tải trọng 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 , apiKey và continueUrl . Cái sau sẽ là URL ban đầu được chỉ định trong đối FIRActionCodeSettings (Obj-C) hoặc ActionCodeSettings (Swift). 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ó bất kỳ sự phụ thuộc bổ sung nào, chúng tôi khuyên bạn nên sử dụng thư viện máy khách 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ừ một ứng dụng 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 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 rồi áp dụng qua applyActionCode để thay đổi có hiệu lực, tức là email được xác minh.