Android Uygulamasında SMS Doğrulaması İsteme

Telefon numaralarını otomatik olarak doğrulamak için doğrulama akışının hem istemci hem de sunucu bölümlerini uygulamanız gerekir. Bu belgede, istemci bölümünün bir Android uygulamasında nasıl uygulanacağı açıklanmaktadır.

Android uygulamasında telefon numarası doğrulama akışını başlatmak için telefon numarasını doğrulama sunucunuza gönderir ve SMS Retriever API'yi çağırarak uygulamanız için tek seferlik kod içeren bir SMS mesajı almaya başlarsınız. Mesajı aldıktan sonra doğrulama sürecini tamamlamak için tek seferlik kodu sunucunuza geri gönderirsiniz.

Başlamadan önce

Uygulamanızı hazırlamak için aşağıdaki bölümlerdeki adımları tamamlayın.

Uygulama ön koşulları

Uygulamanızın derleme dosyasında aşağıdaki değerlerin kullanıldığından emin olun:

• minSdkVersion 19 veya sonraki sürümler
• 28 veya daha yeni bir compileSdkVersion

Uygulamanızı yapılandırma

Proje düzeyindeki build.gradle dosyanızda, Google'ın Maven deposunu ve Maven merkezi deposunu hem buildscript hem de allprojects bölümünüze ekleyin:

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

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

SMS Retriever API için Google Play Hizmetleri bağımlılığını, genellikle app/build.gradle olan modülünüzün Gradle derleme dosyasına ekleyin:

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

1. Kullanıcının telefon numarasını alma

Kullanıcının telefon numarasını, uygulamanız için uygun olan herhangi bir şekilde alabilirsiniz. Kullanıcıdan cihazda depolanan telefon numaralarından seçim yapmasını isteyerek ve böylece telefon numarasını manuel olarak yazmak zorunda kalmadan ipucu seçiciyi kullanmak genellikle en iyi kullanıcı deneyimidir. İpucu seçiciyi kullanmak için:

// 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. SMS retriever'ı başlatma

Kullanıcının telefon numarasını doğrulamaya hazır olduğunuzda SmsRetrieverClient nesnesinin bir örneğini alın, startSmsRetriever işlevini çağırın ve SMS alma görevine başarı ve başarısızlık dinleyicileri ekleyin:

// 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
    // ...
  }
});

SMS alma görevi, uygulamanızı tanımlayan benzersiz bir dize içeren bir SMS mesajı için beş dakikaya kadar dinler.

3. Telefon numarasını sunucunuza gönderin

Kullanıcının telefon numarasını aldıktan ve SMS mesajlarını dinlemeye başladıktan sonra, herhangi bir yöntemi (genellikle HTTPS POST isteği) kullanarak kullanıcının telefon numarasını doğrulama sunucunuza gönderin.

Sunucunuz bir doğrulama mesajı oluşturur ve bu mesajı belirttiğiniz telefon numarasına SMS ile gönderir. Sunucuda SMS Doğrulaması Yapma bölümüne bakın.

4. Doğrulama mesajları alma

Kullanıcının cihazında bir doğrulama mesajı alındığında Play Hizmetleri, mesajın metnini içeren bir SmsRetriever.SMS_RETRIEVED_ACTION Intent'i uygulamanıza açıkça yayınlar. Bu doğrulama mesajını almak için BroadcastReceiver kullanın.

BroadcastReceiver'nin onReceive işleyicisinde, Intent'in eklerinden doğrulama mesajının metnini (ve isteğe bağlı olarak gönderen adresini) alın:

/**
 * 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;
      }
    }
  }
}

Bu BroadcastReceiver değerini, aşağıdaki örnekte gösterildiği gibi uygulamanızın AndroidManifest.xml dosyasında intent filtresi com.google.android.gms.auth.api.phone.SMS_RETRIEVED (SmsRetriever.SMS_RETRIEVED_ACTION sabit değerinin değeri) ve izin com.google.android.gms.auth.api.phone.permission.SEND (SmsRetriever.SEND_PERMISSION sabit değerinin değeri) ile veya Context.registerReceiver'i dinamik olarak kullanarak kaydedin.

<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>

Önemli: Alıcınıza com.google.android.gms.auth.api.phone.permission.SEND iznini ekleyerek yayın intent'inin SMS Retriever API'den geldiğini algılayabilirsiniz. Bu izin ayarı, Google Play Hizmetleri 19.8.31 veya sonraki sürümlerde kullanılabilir.

Önemli: com.google.android.gms.auth.api.phone.permission.SEND iznini uygulamanıza eklemeyin. Bu izin yalnızca intent'in yayın alıcısındaki SMS Retriever API'den geldiğini algılamak için kullanılmalıdır.

5. Doğrulama mesajındaki tek seferlik kodu sunucunuza gönderin

Doğrulama mesajının metnine sahip olduğunuza göre, mesajdaki tek kullanımlık kodu almak için normal ifade veya başka bir mantık kullanın. Tek kullanımlık kodun biçimi, sunucunuza nasıl uyguladığınıza bağlıdır.

Son olarak, bir defalık kodu güvenli bir bağlantı üzerinden sunucunuza gönderin. Sunucunuz bir defalık kodu aldığında telefon numarasının doğrulandığını kaydeder.

Önemli: Tek kullanımlık kodun doğrulamasını istemci uygulamanızda değil, sunucunuzda yapmanız gerekir.