دمج Android Google reCAPTCHA في تطبيق Android

دمج Android Google reCAPTCHA في تطبيق Android

SafetyNet reCAPTCHA API

reCAPTCHA هي خدمة مجانية تستخدم محركًا متقدمًا لتحليل المخاطر لحماية تطبيقك من الرسائل غير المرغوب فيها والإجراءات المسيئة الأخرى. إذا اشتبهت الخدمة في أن المستخدم الذي يتفاعل مع تطبيقك قد يكون روبوتًا بدلاً من إنسان ، فإنه يقدم اختبار CAPTCHA الذي يجب على الإنسان حله قبل أن يتمكن تطبيقك من الاستمرار في التنفيذ.

العمل

1. أولاً ، يجب عليك الحصول على مفتاح الموقع والمفتاح السري من موقع reCAPTCHA . سيتم استخدام مفتاح الموقع في تطبيق Android الخاص بك ويجب وضع المفتاح السري في خادمك.
2. باستخدام مفتاح “الموقع” ، سيتم إنشاء reCAPTCHA ويجب على المستخدم إكمال التحدي reCAPTCHA إذا لزم الأمر.
3. بعد إنشاء reCAPTCHA ، سيتواصل التطبيق مع خادم captcha وسيُرجع رمز استجابة المستخدم باستخدام مفتاح الموقع الخاص بك.
4. الآن سيرسل تطبيق Android الخاص بك الرمز المميز إلى الخادم الخاص بك وسيرسل الخادم الرمز المميز إلى خادم reCAPTCHA مرة أخرى ولكن باستخدام المفتاح السري. سيرسل خادم reCAPTCHA حالة النجاح إلى الخادم الخاص بك والخادم في المقابل يرسل حالة النجاح إلى تطبيق Android الخاص بك.

قم بإنشاء مفتاح موقع reCAPTCHA والمفتاح السري

1. زيارة موقع reCAPTCHA .
2. أدخل التسمية لتحديد مفتاحك. يمكنك إدخال أي اسم هنا.
3. بعد إدخال التسمية ، حدد نوع reCAPTCHA الذي تريد إضافته في تطبيقك. سأستخدم reCAPTCHA v2 وبعد ذلك reCAPTCHA Android.
4. أدخل اسم حزمة مشروع Android الخاص بك.
5. أخيرًا ، حدد قبول شروط وأحكام reCAPTCHA وإرسال التنبيهات إلى أصحابها.
6. انقر فوق إرسال

إعداد مشروع Android لـ reCAPTCHA

//dependency for the reCAPTCHA (safetynet)
implementation 'com.google.android.gms:play-services-safetynet:17.0.0'
//dependency for fast networking for networking
implementation 'com.amitshekhar.android:android-networking:1.0.2'

<uses-permission android:name="android.permission.INTERNET"/>

AndroidNetworking.initialize(applicationContext);

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:app="http://schemas.android.com/apk/res-auto"
        android:layout_width="match_parent"
        android:layout_height="match_parent">

    <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="reCAPTCHA example"
            app:layout_constraintBottom_toBottomOf="parent"
            android:layout_marginTop="8dp"
            app:layout_constraintTop_toTopOf="parent"
            app:layout_constraintEnd_toEndOf="parent"
            android:layout_marginEnd="8dp"
            app:layout_constraintStart_toStartOf="parent"
            android:layout_marginStart="8dp"
            android:id="@+id/textView"
            android:textSize="32sp"/>

    <Button
            android:id="@+id/button"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Click for CAPTCHA"
            android:layout_marginTop="8dp"
            app:layout_constraintTop_toBottomOf="@+id/textView" app:layout_constraintEnd_toEndOf="parent"
            android:layout_marginEnd="8dp" app:layout_constraintStart_toStartOf="parent"
            android:layout_marginStart="8dp"/>

</androidx.constraintlayout.widget.ConstraintLayout>

class MainActivity : AppCompatActivity(), View.OnClickListener {

    var TAG = "MainActivity"
    lateinit var btnverifyCaptcha: Button
    private var SITE_KEY = "YOUR_SITE_KEY"

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        btnverifyCaptcha = findViewById(R.id.button)
        btnverifyCaptcha.setOnClickListener(this)
    }

    override fun onClick(view: View) {
        SafetyNet.getClient(this).verifyWithRecaptcha(SITE_KEY)
            .addOnSuccessListener(this) { response ->
                if (!response.tokenResult.isEmpty()) {
                    handleVerify(response.tokenResult)
                }
            }
            .addOnFailureListener(this) { e ->
                if (e is ApiException) {
                    Log.d(TAG,("Error message: " + CommonStatusCodes.getStatusCodeString(e.statusCode)))
                } else {
                    Log.d(TAG, "Unknown type of error: " + e.message)
                }
            }
    }

    protected fun handleVerify(responseToken: String) {
        //it is google recaptcha siteverify server
        //you can place your server url
        val url = "https://www.google.com/recaptcha/api/siteverify"
        AndroidNetworking.get(url)
            .addHeaders("token", responseToken)
            .setTag("MY_NETWORK_CALL")
            .setPriority(Priority.LOW)
            .build()
            .getAsJSONArray(object : JSONArrayRequestListener() {
                fun onResponse(response: JSONArray) {
                    // do anything with response
                }

                fun onError(error: ANError) {
                    // handle error
                }
            })
    }
}

خطأ API شائع reCAPTCHA

1. RECAPTCHA_INVALID_SITEKEY: إذا لم تكن قد سجلت مفتاح API بشكل صحيح. مفتاح الموقع الخاص بك غير صالح.
2. RECAPTCHA_INVALID_KEYTYPE: نوع المفتاح غير صالح. إنشاء مفتاح reCAPTCHA جديد.
3. RECAPTCHA_INVALID_PACKAGENAME: اسم الحزمة الذي أدخلته أثناء إنشاء واجهة برمجة التطبيقات (API) ليس هو نفسه اسم حزمة التطبيق. أضف اسم الحزمة الصحيح.
4. NETWORK_ERROR: إذا لم يكن هناك اتصال بالإنترنت ، فسيتم مواجهة هذا الخطأ.
5. UNSUPPORTED_SDK_VERSION: ربما كنت تستخدم مستوى API 13 أو أقل. تغيير MinSdkVersion الخاص بك إلى 14 أو أعلى.

استنتاج