Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Xác thực với Firebase bằng Số điện thoại có Unity

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Bạn có thể sử dụng Xác thực Firebase để đăng nhập người dùng bằng cách gửi tin nhắn SMS đến điện thoại của người dùng. Người dùng đăng nhập bằng mã một lần có trong tin nhắn SMS.

Tài liệu này mô tả cách triển khai quy trình đăng nhập bằng số điện thoại bằng SDK Firebase.

Trước khi bắt đầu

  1. Trước khi có thể sử dụng Xác thực Firebase , bạn cần thêm SDK Unity Firebase (cụ thể là FirebaseAuth.unitypackage ) vào dự án Unity của mình.

    Tìm hướng dẫn chi tiết cho các bước thiết lập ban đầu này trong Thêm Firebase vào dự án Unity của bạn .

  2. Nếu bạn chưa kết nối ứng dụng của mình với dự án Firebase, hãy thực hiện việc này từ bảng điều khiển Firebase .
  3. Hiểu các yêu cầu nền tảng để đăng nhập bằng Số điện thoại:
    • Đăng nhập bằng Số điện thoại chỉ dành cho nền tảng di động.
    • Trên iOS, đăng nhập bằng Số điện thoại yêu cầu thiết bị thực và sẽ không hoạt động trên trình giả lập.

mối quan tâm an ninh

Xác thực chỉ sử dụng một số điện thoại, mặc dù thuận tiện, nhưng lại kém an toàn hơn so với các phương pháp khả dụng khác, bởi vì việc sở hữu một số điện thoại có thể dễ dàng chuyển giao giữa những người dùng. Ngoài ra, trên các thiết bị có nhiều hồ sơ người dùng, bất kỳ người dùng nào có thể nhận tin nhắn SMS đều có thể đăng nhập vào tài khoản bằng số điện thoại của thiết bị.

Nếu bạn sử dụng tính năng đăng nhập dựa trên số điện thoại trong ứng dụng của mình, thì bạn nên cung cấp tính năng này cùng với các phương thức đăng nhập an toàn hơn và thông báo cho người dùng về những đánh đổi bảo mật khi sử dụng tính năng đăng nhập bằng số điện thoại.

Bật đăng nhập Số điện thoại cho dự án Firebase của bạn

Để đăng nhập người dùng bằng SMS, trước tiên bạn phải bật phương thức đăng nhập bằng Số điện thoại cho dự án Firebase của mình:

  1. Trong bảng điều khiển Firebase , hãy mở phần Xác thực .
  2. Trên trang Phương thức đăng nhập, bật phương thức đăng nhập Số điện thoại .

Hạn ngạch yêu cầu đăng nhập bằng số điện thoại của Firebase đủ cao để hầu hết các ứng dụng không bị ảnh hưởng. Tuy nhiên, nếu bạn cần đăng nhập một lượng lớn người dùng bằng xác thực qua điện thoại, bạn có thể cần phải nâng cấp gói giá của mình. Xem trang giá cả .

Bắt đầu nhận thông báo APN (chỉ dành cho iOS)

Để sử dụng xác thực số điện thoại trên iOS, ứng dụng của bạn phải có thể nhận thông báo APN từ Firebase. Khi bạn đăng nhập người dùng bằng số điện thoại của họ lần đầu tiên trên thiết bị, Xác thực Firebase sẽ gửi thông báo đẩy im lặng tới thiết bị để xác minh rằng yêu cầu đăng nhập số điện thoại đến từ ứng dụng của bạn. (Vì lý do này, không thể sử dụng đăng nhập bằng số điện thoại trên trình mô phỏng.)

Để bật thông báo APN để sử dụng với Xác thực Firebase:

  1. Trong Xcode, bật thông báo đẩy cho dự án của bạn.
  2. Tải chứng chỉ APN của bạn lên Firebase. Nếu bạn chưa có chứng chỉ APN, hãy đảm bảo tạo một chứng chỉ trong Trung tâm thành viên dành cho nhà phát triển của Apple .

    1. Bên trong dự án của bạn trong bảng điều khiển Firebase, hãy chọn biểu tượng bánh răng, chọn Cài đặt dự án rồi chọn tab Nhắn tin qua đám mây .

    2. Chọn nút Tải lên chứng chỉ cho chứng chỉ phát triển, chứng chỉ sản xuất của bạn hoặc cả hai. Ít nhất một là bắt buộc.

    3. Đối với mỗi chứng chỉ, hãy chọn tệp .p12 và cung cấp mật khẩu, nếu có. Đảm bảo ID gói cho chứng chỉ này khớp với ID gói ứng dụng của bạn. Chọn Lưu .

Gửi mã xác minh đến điện thoại của người dùng

Để bắt đầu đăng nhập bằng số điện thoại, hãy cung cấp cho người dùng một giao diện nhắc họ cung cấp số điện thoại của mình, sau đó gọi PhoneAuthProvider.VerifyPhoneNumber để yêu cầu Firebase gửi mã xác thực tới điện thoại của người dùng bằng SMS:

  1. Lấy số điện thoại của người dùng.

    Các yêu cầu pháp lý khác nhau, nhưng theo phương pháp hay nhất và để đặt kỳ vọng cho người dùng của bạn, bạn nên thông báo cho họ rằng nếu họ sử dụng đăng nhập bằng điện thoại, họ có thể nhận được tin nhắn SMS để xác minh và áp dụng mức phí tiêu chuẩn.

  2. Gọi PhoneAuthProvider.VerifyPhoneNumber , chuyển đến số điện thoại của người dùng.
    PhoneAuthProvider provider = PhoneAuthProvider.GetInstance(firebaseAuth);
    provider.VerifyPhoneNumber(phoneNumber, phoneAuthTimeoutMs, null,
      verificationCompleted: (credential) => {
        // Auto-sms-retrieval or instant validation has succeeded (Android only).
        // There is no need to input the verification code.
        // `credential` can be used instead of calling GetCredential().
      },
      verificationFailed: (error) => {
        // The verification code was not sent.
        // `error` contains a human readable explanation of the problem.
      },
      codeSent: (id, token) => {
        // Verification code was successfully sent via SMS.
        // `id` contains the verification id that will need to passed in with
        // the code from the user when calling GetCredential().
        // `token` can be used if the user requests the code be sent again, to
        // tie the two requests together.
      },
      codeAutoRetrievalTimeout: (id) => {
        // Called when the auto-sms-retrieval has timed out, based on the given
        // timeout parameter.
        // `id` contains the verification id of the request that timed out.
      });
    
    Khi bạn gọi PhoneAuthProvider.VerifyPhoneNumber , Firebase,
    • (trên iOS), gửi thông báo đẩy im lặng tới ứng dụng của bạn.
    • Firebase gửi tin nhắn SMS có chứa mã xác thực đến số điện thoại đã chỉ định và chuyển ID xác minh đến chức năng hoàn thành của bạn. Bạn sẽ cần cả mã xác minh và ID xác minh để đăng nhập người dùng.
  3. Lưu ID xác minh và khôi phục nó khi ứng dụng của bạn tải. Bằng cách đó, bạn có thể đảm bảo rằng mình vẫn có ID xác minh hợp lệ nếu ứng dụng của bạn bị chấm dứt trước khi người dùng hoàn tất quy trình đăng nhập (ví dụ: trong khi chuyển sang ứng dụng SMS).

    Bạn có thể duy trì ID xác minh theo bất kỳ cách nào bạn muốn. Một cách đơn giản là lưu ID xác minh bằng UnityEngine.PlayerPrefs .

Nếu lệnh gọi lại được chuyển vào codeSent được gọi, bạn có thể nhắc người dùng nhập mã xác minh khi họ nhận được mã đó trong tin nhắn SMS.

Mặt khác, nếu cuộc gọi lại cho verificationCompleted được gọi, thì xác minh tự động đã thành công và bây giờ bạn sẽ có Credential thực mà bạn có thể sử dụng như được mô tả bên dưới.

Đăng nhập người dùng bằng mã xác minh

Sau khi người dùng cung cấp cho ứng dụng của bạn mã xác minh từ tin nhắn SMS, hãy đăng nhập người dùng bằng cách tạo đối tượng Credential thực từ mã xác minh và ID xác minh, đồng thời chuyển đối tượng đó tới FirebaseAuth.SignInWithCredential .

  1. Nhận mã xác minh từ người dùng.
  2. Tạo một đối tượng Credential thực từ mã xác minh và ID xác minh.
    Credential credential =
        phoneAuthProvider.GetCredential(verificationId, verificationCode);
        
  3. Đăng nhập người dùng bằng đối tượng Credential thực:
    auth.SignInWithCredentialAsync(credential).ContinueWith(task => {
      if (task.IsFaulted) {
        Debug.LogError("SignInWithCredentialAsync encountered an error: " +
                       task.Exception);
        return;
      }
    
      FirebaseUser newUser = task.Result;
      Debug.Log("User signed in successfully");
      // This should display the phone number.
      Debug.Log("Phone number: " + newUser.PhoneNumber);
      // The phone number providerID is 'phone'.
      Debug.Log("Phone provider ID: " + newUser.ProviderId);
    });
    

Bước tiếp theo

Sau khi người dùng đăng nhập lần đầu tiên, tài khoản người dùng mới được tạo và liên kết với thông tin đăng nhập—nghĩa là tên người dùng và mật khẩu, số điện thoại hoặc thông tin nhà cung cấp xác thực—người dùng đã đăng nhập bằng. Tài khoản mới này được lưu trữ như một phần của dự án Firebase của bạn và có thể được sử dụng để xác định người dùng trên mọi ứng dụng trong dự án của bạn, bất kể người dùng đăng nhập bằng cách nào.

  • Trong các ứng dụng của mình, bạn có thể lấy thông tin hồ sơ cơ bản của người dùng từ đối tượng Firebase.Auth.FirebaseUser :

    Firebase.Auth.FirebaseUser user = auth.CurrentUser;
    if (user != null) {
      string name = user.DisplayName;
      string email = user.Email;
      System.Uri photo_url = user.PhotoUrl;
      // The user's Id, unique to the Firebase project.
      // Do NOT use this value to authenticate with your backend server, if you
      // have one; use User.TokenAsync() instead.
      string uid = user.UserId;
    }
    
  • Trong Cơ sở dữ liệu thời gian thực Firebase và Quy tắc bảo mật bộ lưu trữ đám mây , bạn có thể lấy ID người dùng duy nhất của người dùng đã đăng nhập từ biến auth thực và sử dụng biến đó để kiểm soát dữ liệu mà người dùng có thể truy cập.

Bạn có thể cho phép người dùng đăng nhập vào ứng dụng của mình bằng nhiều nhà cung cấp xác thực bằng cách liên kết thông tin đăng nhập của nhà cung cấp xác thực với tài khoản người dùng hiện có.

Để đăng xuất người dùng, hãy gọi SignOut() :

auth.SignOut();
,

Bạn có thể sử dụng Xác thực Firebase để đăng nhập người dùng bằng cách gửi tin nhắn SMS đến điện thoại của người dùng. Người dùng đăng nhập bằng mã một lần có trong tin nhắn SMS.

Tài liệu này mô tả cách triển khai quy trình đăng nhập bằng số điện thoại bằng SDK Firebase.

Trước khi bắt đầu

  1. Trước khi có thể sử dụng Xác thực Firebase , bạn cần thêm SDK Unity Firebase (cụ thể là FirebaseAuth.unitypackage ) vào dự án Unity của mình.

    Tìm hướng dẫn chi tiết cho các bước thiết lập ban đầu này trong Thêm Firebase vào dự án Unity của bạn .

  2. Nếu bạn chưa kết nối ứng dụng của mình với dự án Firebase, hãy thực hiện việc này từ bảng điều khiển Firebase .
  3. Hiểu các yêu cầu nền tảng để đăng nhập bằng Số điện thoại:
    • Đăng nhập bằng Số điện thoại chỉ dành cho nền tảng di động.
    • Trên iOS, đăng nhập bằng Số điện thoại yêu cầu thiết bị thực và sẽ không hoạt động trên trình giả lập.

mối quan tâm an ninh

Xác thực chỉ sử dụng một số điện thoại, mặc dù thuận tiện, nhưng lại kém an toàn hơn so với các phương pháp khả dụng khác, bởi vì việc sở hữu một số điện thoại có thể dễ dàng chuyển giao giữa những người dùng. Ngoài ra, trên các thiết bị có nhiều hồ sơ người dùng, bất kỳ người dùng nào có thể nhận tin nhắn SMS đều có thể đăng nhập vào tài khoản bằng số điện thoại của thiết bị.

Nếu bạn sử dụng tính năng đăng nhập dựa trên số điện thoại trong ứng dụng của mình, thì bạn nên cung cấp tính năng này cùng với các phương thức đăng nhập an toàn hơn và thông báo cho người dùng về những đánh đổi bảo mật khi sử dụng tính năng đăng nhập bằng số điện thoại.

Bật đăng nhập Số điện thoại cho dự án Firebase của bạn

Để đăng nhập người dùng bằng SMS, trước tiên bạn phải bật phương thức đăng nhập bằng Số điện thoại cho dự án Firebase của mình:

  1. Trong bảng điều khiển Firebase , hãy mở phần Xác thực .
  2. Trên trang Phương thức đăng nhập, bật phương thức đăng nhập Số điện thoại .

Hạn ngạch yêu cầu đăng nhập bằng số điện thoại của Firebase đủ cao để hầu hết các ứng dụng không bị ảnh hưởng. Tuy nhiên, nếu bạn cần đăng nhập một lượng lớn người dùng bằng xác thực qua điện thoại, bạn có thể cần phải nâng cấp gói giá của mình. Xem trang giá cả .

Bắt đầu nhận thông báo APN (chỉ dành cho iOS)

Để sử dụng xác thực số điện thoại trên iOS, ứng dụng của bạn phải có thể nhận thông báo APN từ Firebase. Khi bạn đăng nhập người dùng bằng số điện thoại của họ lần đầu tiên trên thiết bị, Xác thực Firebase sẽ gửi thông báo đẩy im lặng tới thiết bị để xác minh rằng yêu cầu đăng nhập số điện thoại đến từ ứng dụng của bạn. (Vì lý do này, không thể sử dụng đăng nhập bằng số điện thoại trên trình giả lập.)

Để bật thông báo APN để sử dụng với Xác thực Firebase:

  1. Trong Xcode, bật thông báo đẩy cho dự án của bạn.
  2. Tải chứng chỉ APN của bạn lên Firebase. Nếu bạn chưa có chứng chỉ APN, hãy đảm bảo tạo một chứng chỉ trong Trung tâm thành viên dành cho nhà phát triển của Apple .

    1. Bên trong dự án của bạn trong bảng điều khiển Firebase, hãy chọn biểu tượng bánh răng, chọn Cài đặt dự án rồi chọn tab Nhắn tin qua đám mây .

    2. Chọn nút Tải lên chứng chỉ cho chứng chỉ phát triển, chứng chỉ sản xuất của bạn hoặc cả hai. Ít nhất một là bắt buộc.

    3. Đối với mỗi chứng chỉ, hãy chọn tệp .p12 và cung cấp mật khẩu, nếu có. Đảm bảo ID gói cho chứng chỉ này khớp với ID gói ứng dụng của bạn. Chọn Lưu .

Gửi mã xác minh đến điện thoại của người dùng

Để bắt đầu đăng nhập bằng số điện thoại, hãy cung cấp cho người dùng một giao diện nhắc họ cung cấp số điện thoại của mình, sau đó gọi PhoneAuthProvider.VerifyPhoneNumber để yêu cầu Firebase gửi mã xác thực tới điện thoại của người dùng bằng SMS:

  1. Lấy số điện thoại của người dùng.

    Các yêu cầu pháp lý khác nhau, nhưng theo phương pháp hay nhất và để đặt kỳ vọng cho người dùng của bạn, bạn nên thông báo cho họ rằng nếu họ sử dụng đăng nhập bằng điện thoại, họ có thể nhận được tin nhắn SMS để xác minh và áp dụng mức phí tiêu chuẩn.

  2. Gọi PhoneAuthProvider.VerifyPhoneNumber , chuyển đến số điện thoại của người dùng.
    PhoneAuthProvider provider = PhoneAuthProvider.GetInstance(firebaseAuth);
    provider.VerifyPhoneNumber(phoneNumber, phoneAuthTimeoutMs, null,
      verificationCompleted: (credential) => {
        // Auto-sms-retrieval or instant validation has succeeded (Android only).
        // There is no need to input the verification code.
        // `credential` can be used instead of calling GetCredential().
      },
      verificationFailed: (error) => {
        // The verification code was not sent.
        // `error` contains a human readable explanation of the problem.
      },
      codeSent: (id, token) => {
        // Verification code was successfully sent via SMS.
        // `id` contains the verification id that will need to passed in with
        // the code from the user when calling GetCredential().
        // `token` can be used if the user requests the code be sent again, to
        // tie the two requests together.
      },
      codeAutoRetrievalTimeout: (id) => {
        // Called when the auto-sms-retrieval has timed out, based on the given
        // timeout parameter.
        // `id` contains the verification id of the request that timed out.
      });
    
    Khi bạn gọi PhoneAuthProvider.VerifyPhoneNumber , Firebase,
    • (trên iOS), gửi thông báo đẩy im lặng tới ứng dụng của bạn.
    • Firebase gửi tin nhắn SMS có chứa mã xác thực đến số điện thoại đã chỉ định và chuyển ID xác minh đến chức năng hoàn thành của bạn. Bạn sẽ cần cả mã xác minh và ID xác minh để đăng nhập người dùng.
  3. Lưu ID xác minh và khôi phục nó khi ứng dụng của bạn tải. Bằng cách đó, bạn có thể đảm bảo rằng mình vẫn có ID xác minh hợp lệ nếu ứng dụng của bạn bị chấm dứt trước khi người dùng hoàn tất quy trình đăng nhập (ví dụ: trong khi chuyển sang ứng dụng SMS).

    Bạn có thể duy trì ID xác minh theo bất kỳ cách nào bạn muốn. Một cách đơn giản là lưu ID xác minh bằng UnityEngine.PlayerPrefs .

Nếu lệnh gọi lại được chuyển vào codeSent được gọi, bạn có thể nhắc người dùng nhập mã xác minh khi họ nhận được mã đó trong tin nhắn SMS.

Mặt khác, nếu cuộc gọi lại cho verificationCompleted được gọi, thì xác minh tự động đã thành công và bây giờ bạn sẽ có Credential thực mà bạn có thể sử dụng như được mô tả bên dưới.

Đăng nhập người dùng bằng mã xác minh

Sau khi người dùng cung cấp cho ứng dụng của bạn mã xác minh từ tin nhắn SMS, hãy đăng nhập người dùng bằng cách tạo đối tượng Credential thực từ mã xác minh và ID xác minh, đồng thời chuyển đối tượng đó tới FirebaseAuth.SignInWithCredential .

  1. Nhận mã xác minh từ người dùng.
  2. Tạo một đối tượng Credential thực từ mã xác minh và ID xác minh.
    Credential credential =
        phoneAuthProvider.GetCredential(verificationId, verificationCode);
        
  3. Đăng nhập người dùng bằng đối tượng Credential thực:
    auth.SignInWithCredentialAsync(credential).ContinueWith(task => {
      if (task.IsFaulted) {
        Debug.LogError("SignInWithCredentialAsync encountered an error: " +
                       task.Exception);
        return;
      }
    
      FirebaseUser newUser = task.Result;
      Debug.Log("User signed in successfully");
      // This should display the phone number.
      Debug.Log("Phone number: " + newUser.PhoneNumber);
      // The phone number providerID is 'phone'.
      Debug.Log("Phone provider ID: " + newUser.ProviderId);
    });
    

Bước tiếp theo

Sau khi người dùng đăng nhập lần đầu tiên, tài khoản người dùng mới được tạo và liên kết với thông tin đăng nhập—nghĩa là tên người dùng và mật khẩu, số điện thoại hoặc thông tin nhà cung cấp xác thực—người dùng đã đăng nhập bằng. Tài khoản mới này được lưu trữ như một phần của dự án Firebase của bạn và có thể được sử dụng để xác định người dùng trên mọi ứng dụng trong dự án của bạn, bất kể người dùng đăng nhập bằng cách nào.

  • Trong các ứng dụng của mình, bạn có thể lấy thông tin hồ sơ cơ bản của người dùng từ đối tượng Firebase.Auth.FirebaseUser :

    Firebase.Auth.FirebaseUser user = auth.CurrentUser;
    if (user != null) {
      string name = user.DisplayName;
      string email = user.Email;
      System.Uri photo_url = user.PhotoUrl;
      // The user's Id, unique to the Firebase project.
      // Do NOT use this value to authenticate with your backend server, if you
      // have one; use User.TokenAsync() instead.
      string uid = user.UserId;
    }
    
  • Trong Cơ sở dữ liệu thời gian thực Firebase và Quy tắc bảo mật bộ lưu trữ đám mây , bạn có thể lấy ID người dùng duy nhất của người dùng đã đăng nhập từ biến auth thực và sử dụng biến đó để kiểm soát dữ liệu mà người dùng có thể truy cập.

Bạn có thể cho phép người dùng đăng nhập vào ứng dụng của mình bằng nhiều nhà cung cấp xác thực bằng cách liên kết thông tin đăng nhập của nhà cung cấp xác thực với tài khoản người dùng hiện có.

Để đăng xuất người dùng, hãy gọi SignOut() :

auth.SignOut();