Yêu cầu xác minh qua SMS trong ứng dụng Android

Để tự động xác minh số điện thoại, bạn phải triển khai cả ứng dụng và của quy trình xác minh. Tài liệu này mô tả cách triển khai phần ứng dụng khách trong một ứng dụng Android.

Để bắt đầu quy trình xác minh số điện thoại trong một ứng dụng Android, bạn phải gửi số điện thoại đến máy chủ xác minh của bạn rồi gọi SMS Retriever API để bắt đầu đang nghe tin nhắn SMS chứa mã dùng một lần cho ứng dụng của bạn. Sau khi nhận tin nhắn, bạn hãy gửi mã dùng một lần trở lại máy chủ của mình để hoàn tất quá trình xác minh.

Trước khi bắt đầu

Để chuẩn bị cho ứng dụng của bạn, hãy hoàn tất các bước trong những phần sau.

Điều kiện tiên quyết đối với ứng dụng

Hãy đảm bảo tệp bản dựng của ứng dụng sử dụng các giá trị sau:

  • minSdkVersion từ 19 trở lên
  • Một compileSdkVersion từ 28 trở lên

Định cấu hình ứng dụng

Trong tệp build.gradle cấp dự án, hãy thêm kho lưu trữ Maven của Googlekho lưu trữ trung tâm Maven trong cả hai phần buildscriptallprojects:

buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

Thêm phần phụ thuộc Dịch vụ Google Play cho SMS Retriever API vào tệp bản dựng Gradle của mô-đun, thường là app/build.gradle:

dependencies {
  implementation 'com.google.android.gms:play-services-auth:21.2.0'
  implementation 'com.google.android.gms:play-services-auth-api-phone:18.1.0'
}

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

Bạn có thể lấy số điện thoại của người dùng theo bất kỳ cách nào thích hợp với . Thông thường, đây là trải nghiệm tốt nhất khi sử dụng bộ chọn gợi ý để nhắc người dùng chọn trong số các số điện thoại được lưu trữ trên thiết bị và do đó tránh được phải nhập số điện thoại theo cách thủ công. Cách sử dụng bộ chọn gợi ý:

// Construct a request for phone numbers and show the picker
private void requestHint() {
    HintRequest hintRequest = new HintRequest.Builder()
           .setPhoneNumberIdentifierSupported(true)
           .build();

    PendingIntent intent = Auth.CredentialsApi.getHintPickerIntent(
            apiClient, hintRequest);
    startIntentSenderForResult(intent.getIntentSender(),
            RESOLVE_HINT, null, 0, 0, 0);
}

// Obtain the phone number from the result
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
  super.onActivityResult(requestCode, resultCode, data);
  if (requestCode == RESOLVE_HINT) {
      if (resultCode == RESULT_OK) {
          Credential credential = data.getParcelableExtra(Credential.EXTRA_KEY);
          // credential.getId();  <-- will need to process phone number string
      }
  }
}

2. Khởi động trình truy xuất SMS

Khi bạn đã sẵn sàng xác minh số điện thoại của người dùng, hãy tải một phiên bản SmsRetrieverClient, hãy gọi startSmsRetriever, đính kèm thành công và trình nghe lỗi đối với tác vụ truy xuất SMS:

// Get an instance of SmsRetrieverClient, used to start listening for a matching
// SMS message.
SmsRetrieverClient client = SmsRetriever.getClient(this /* context */);

// Starts SmsRetriever, which waits for ONE matching SMS message until timeout
// (5 minutes). The matching SMS message will be sent via a Broadcast Intent with
// action SmsRetriever#SMS_RETRIEVED_ACTION.
Task<Void> task = client.startSmsRetriever();

// Listen for success/failure of the start Task. If in a background thread, this
// can be made blocking using Tasks.await(task, [timeout]);
task.addOnSuccessListener(new OnSuccessListener<Void>() {
  @Override
  public void onSuccess(Void aVoid) {
    // Successfully started retriever, expect broadcast intent
    // ...
  }
});

task.addOnFailureListener(new OnFailureListener() {
  @Override
  public void onFailure(@NonNull Exception e) {
    // Failed to start retriever, inspect Exception for more details
    // ...
  }
});

Tác vụ truy xuất SMS sẽ nghe trong tối đa 5 phút đối với một tin nhắn SMS chứa chuỗi duy nhất xác định ứng dụng của bạn.

3. Gửi số điện thoại đến máy chủ của bạn

Sau khi bạn có được số điện thoại của người dùng và bắt đầu nghe tin nhắn SMS gửi số điện thoại của người dùng đến máy chủ xác minh của bạn bằng bất kỳ (thường là yêu cầu POST qua HTTPS).

Máy chủ của bạn tạo thông báo xác minh và gửi thông báo đó qua SMS đến điện thoại số điện thoại bạn đã chỉ định. Xem Thực hiện xác minh qua SMS trên máy chủ.

4. Nhận thông báo xác minh

Khi nhận được thông báo xác minh trên thiết bị của người dùng, Dịch vụ Play truyền phát rõ ràng đến ứng dụng của mình một Ý định SmsRetriever.SMS_RETRIEVED_ACTION, chứa nội dung thông báo. Sử dụng BroadcastReceiver để nhận thông báo xác minh này.

Trong trình xử lý onReceive của BroadcastReceiver, hãy lấy văn bản của thư xác minh (và địa chỉ người gửi (không bắt buộc)) từ tiện ích bổ sung:

/**
 * BroadcastReceiver to wait for SMS messages. This can be registered either
 * in the AndroidManifest or at runtime.  Should filter Intents on
 * SmsRetriever.SMS_RETRIEVED_ACTION.
 */
public class MySMSBroadcastReceiver extends BroadcastReceiver {

  @Override
  public void onReceive(Context context, Intent intent) {
    if (SmsRetriever.SMS_RETRIEVED_ACTION.equals(intent.getAction())) {
      Bundle extras = intent.getExtras();
      Status status = (Status) extras.get(SmsRetriever.EXTRA_STATUS);

      switch(status.getStatusCode()) {
        case CommonStatusCodes.SUCCESS:
          // (Optional) Get SMS Sender address - only available in
          // GMS version 24.20 onwards, else it will return null
          String senderAddress = extras.getString(SmsRetriever.EXTRA_SMS_ORIGINATING_ADDRESS);
          // Get SMS message contents
          String message = extras.getString(SmsRetriever.EXTRA_SMS_MESSAGE);
          // Extract one-time code from the message and complete verification
          // by sending the code back to your server.
          break;
        case CommonStatusCodes.TIMEOUT:
          // Waiting for SMS timed out (5 minutes)
          // Handle the error ...
          break;
      }
    }
  }
}

Đăng ký BroadcastReceiver này bằng bộ lọc ý định com.google.android.gms.auth.api.phone.SMS_RETRIEVED (giá trị của hằng số SmsRetriever.SMS_RETRIEVED_ACTION) và quyền com.google.android.gms.auth.api.phone.permission.SEND (giá trị của SmsRetriever.SEND_PERMISSION) trong AndroidManifest.xml của ứng dụng , như trong ví dụ sau, hoặc động bằng cách sử dụng Context.registerReceiver.

<receiver android:name=".MySMSBroadcastReceiver" android:exported="true"
          android:permission="com.google.android.gms.auth.api.phone.permission.SEND">
    <intent-filter>
        <action android:name="com.google.android.gms.auth.api.phone.SMS_RETRIEVED"/>
    </intent-filter>
</receiver>

5. Gửi mã một lần từ tin nhắn xác minh đến máy chủ của bạn

Bây giờ, bạn đã có nội dung của thông báo xác minh, hãy sử dụng một biểu thức chính quy hoặc một số logic khác để nhận mã một lần từ thông báo. Định dạng của mã một lần tuỳ thuộc vào cách bạn triển khai chúng trong máy chủ của mình.

Cuối cùng, hãy gửi mã dùng một lần đến máy chủ của bạn qua một kết nối bảo mật. Thời gian máy chủ của bạn nhận được mã một lần, máy chủ ghi lại rằng số điện thoại đã đã được xác minh.