Android-এর জন্য Navigation SDK সুরক্ষিত করতে App Check ব্যবহার করা

Firebase App Check আপনার অ্যাপ থেকে Google Maps Platform-এ করা কলকে সুরক্ষিত রাখে। এটি আপনার বৈধ অ্যাপ ছাড়া অন্য সোর্স থেকে আসা ট্রাফিককে ব্লক করে। এটি Play Integrity-এর মতো অ্যাটেস্টেশন প্রদানকারীর থেকে অ্যাপ বা ডিভাইসের সত্যতা মূল্যায়ন করার অনুরোধ করে এটি করে। আপনি যখন অ্যাপ চেকের সাথে আপনার অ্যাপ ইন্টিগ্রেট করেন, তখন আপনি ক্ষতিকর এবং অননুমোদিত অনুরোধের বিরুদ্ধে সুরক্ষা যোগ করেন, যা আপনার বিলিংকে অননুমোদিত চার্জ থেকে রক্ষা করে। এছাড়াও, অ্যাপ চেক আপনার ফ্লিট অ্যাপ ইকোসিস্টেমে রিয়েল-টাইম বিঘ্ন রিপোর্টিং উল্লেখযোগ্যভাবে উন্নত করে, যার ফলে আপনার অ্যাপ ব্যবহারকারী সব ড্রাইভার উপকৃত হন। আরও তথ্যের জন্য, বিঘ্ন রিপোর্টিং দেখুন।

App Check কেন ব্যবহার করবেন?

App Check, Android-এর জন্য Navigation SDK-এর দুটি আলাদা ক্ষেত্রকে সুরক্ষিত করে: প্রধান নেভিগেশন কার্যকারিতা এবং বিঘ্ন রিপোর্টিং।

App Check, ক্ষতিকর বা অননুমোদিত সোর্স থেকে Android-এর জন্য প্রধান Navigation SDK-এর অনুরোধ ব্লক করতে সাহায্য করে। এটি বিলিং সংক্রান্ত প্রতারণা এবং কোটা শেষ হয়ে যাওয়া থেকে আপনার প্রোজেক্টকে রক্ষা করে আপনাকে সরাসরি উপকৃত করে।

বিঘ্ন ঘটার বিষয়ে অভিযোগ জানানো

আপনার অ্যাপে রিয়েল-টাইম বিঘ্ন রিপোর্টিং এবং ভোট দেওয়ার ক্ষমতা থাকলে, অ্যাপ চেক ব্যবহার করার জন্য বিশেষভাবে সাজেস্ট করা হয়। অ্যাপ চেক চালু করলে, আপনার ড্রাইভারদের সব রিয়েল-টাইম ফিডব্যাক বিবেচনা করে সবচেয়ে সঠিক রুট প্রদান করা হয়।

রিপোর্টিংয়ের জন্য App Check কেন গুরুত্বপূর্ণ:

  • রাস্তা বন্ধের ক্ষেত্রে উচ্চ বিশ্বাসযোগ্যতার মাপকাঠি: রাস্তা বন্ধের মতো ঘটনা যা রুটের উপর প্রভাব ফেলে, তা সব চালকের রুট সংক্রান্ত আচরণে উল্লেখযোগ্য পরিবর্তন আনতে পারে। সম্ভাব্য ভাঙচুর, স্প্যাম বা ভুল রিপোর্টিং থেকে ম্যাপকে সুরক্ষিত রাখতে, রাস্তা বন্ধ থাকার কারণে বিঘ্ন ঘটার জন্য Google-এর মডারেশন ইনফ্রাস্ট্রাকচার শক্তিশালী ডিভাইস এবং অ্যাপ ইন্টিগ্রিটি সিগন্যালের উপর নির্ভর করে।
  • App Check কীভাবে রিপোর্ট যাচাই করে: Android-এর জন্য Navigation SDK থেকে পাঠানো ব্যবহারকারীর রিপোর্ট ও ভোটে App Check টোকেন অন্তর্ভুক্ত থাকে, যা Google-এর ব্যাকএন্ড দ্বারা মতামতের বৈধতা যাচাই করতে ব্যবহার করা হয়, এর ফলে বিশ্বস্ততার লেভেল বৃদ্ধি পায় এবং লাইভ ম্যাপের উপর প্রভাবের জন্য এটিকে মূল্যায়ন করার অনুমতি দেয়।
  • অ্যাপ চেক বাদ দেওয়ার প্রভাব: সঠিক অ্যাপ চেক টোকেন ছাড়া জমা দেওয়া রিপোর্ট কম-বিশ্বস্ত মডেলের অধীনে মূল্যায়ন করা হয় এবং শুধুমাত্র সাইলেন্ট সিগন্যাল হিসেবে প্রসেস করা হতে পারে। এর অর্থ হল, আপনার ব্যবহারকারীরা এখনও রিপোর্ট করতে এবং ভোট দিতে পারলেও, তাদের রিপোর্ট ম্যাপে দৃশ্যমান হওয়ার বা অন্যান্য ড্রাইভারের রুটকে প্রভাবিত করার সম্ভাবনা কম এবং এর জন্য অতিরিক্ত যাচাইকরণের প্রয়োজন হবে।

App Check কি আমার জন্য সঠিক?

বেশিরভাগ ক্ষেত্রে অ্যাপ চেক ব্যবহার করার সাজেশন দেওয়া হয়; তবে, নিম্নলিখিত পরিস্থিতিতে অ্যাপ চেক প্রয়োজন হয় না বা কাজ করে না:

  • ব্যক্তিগত বা পরীক্ষামূলক অ্যাপ: আপনার অ্যাপ সর্বজনীনভাবে অ্যাক্সেসযোগ্য না হলে, App Check-এর প্রয়োজন নেই।
  • আপোস করা ডিভাইস: সাজেস্ট করা অ্যাটেস্টেশন প্রদানকারী, রুট করা বা জেলব্রোকেন ফোনের মতো ভরসাযোগ্য নয় এমন ডিভাইসে Navigation SDK for Android চালানো আটকায়। এইসব ডিভাইসে কাজ করার জন্য, কাস্টম অ্যাটেস্টেশন প্রোভাইডার ডেপ্লয় করুন।
  • GMS-বিহীন Android ডিভাইস: Play Integrity-র জন্য Android ডিভাইসে Google Mobile Services (GMS) রান করতে হবে। আপনি যদি GMS-বিহীন Android ডিভাইসে সহায়তা করার পরিকল্পনা করেন, তাহলে একটি কাস্টম অ্যাটেস্টেশন প্রদানকারী ডিপ্লয় করুন।

প্রয়োগ করার বিভিন্ন ধাপের ওভারভিউ

উচ্চ স্তরে, আপনার অ্যাপকে App Check-এর সাথে ইন্টিগ্রেট করতে আপনাকে এইসব ধাপ অনুসরণ করতে হবে:

  1. আপনার অ্যাপে Firebase যোগ করুন।
  2. App Check লাইব্রেরি যোগ করুন এবং App Check শুরু করুন।
  3. টোকেন প্রদানকারী যোগ করুন। এই ধাপটি ডিভাইস বা অ্যাপের ইন্টিগ্রিটি যাচাই করার জন্য আপনার পছন্দের অ্যাটেস্টেশন প্রদানকারীকে কল করে।
  4. নেভিগেশন এবং অ্যাপ চেক API শুরু করুন।
  5. ডিবাগিং চালু করুন। এটি ডেভেলপমেন্টের সময় বা কন্টিনিউয়াস ইন্টিগ্রেশন (CI) এনভায়রনমেন্টে উপযোগী।
  6. এনফোর্সমেন্ট চালু করার আগে আপনার অ্যাপের অনুরোধ মনিটর করুন। এইভাবে, আপনি ব্যবহারকারীদের কোনও সমস্যা না করেই নির্বিঘ্নে অ্যাপ চেক এনফোর্স করতে পারবেন।

App Check ইন্টিগ্রেশন প্ল্যান করার সময় যেসব বিষয় বিবেচনা করতে হবে

  • অ্যাটেস্টেশন প্রদানকারীর কোটা: আমরা যে অ্যাটেস্টেশন প্রদানকারীর সাজেশন দিই, Play Integrity, তার স্ট্যান্ডার্ড API ব্যবহার টিয়ারের জন্য দৈনিক কল সীমা আছে। কলের সীমা সম্পর্কে আরও তথ্যের জন্য, Google Play Integrity ডেভেলপার ডকুমেন্টেশনের সেট-আপ পৃষ্ঠা দেখুন।
  • স্টার্টআপ লেটেন্সি: বেশিরভাগ ক্ষেত্রে, আপনার ব্যবহারকারীরা নিয়মিত ব্যবহারের সময় লেটেন্সি অনুভব করবেন না, কারণ App Check টোকেন ডিভাইসে ক্যাশে করা হয়। নির্বিঘ্ন পারফর্ম্যান্স বজায় রাখতে, সিস্টেম ব্যাকগ্রাউন্ডে মেয়াদ শেষ হওয়ার আগে App Check টোকেন অটোমেটিক রিফ্রেশ করে। তবে, সঠিক App Check টোকেন না থাকলে, আপনার অ্যাপ ব্যবহারকারীরা স্টার্টআপে কিছু লেটেন্সি অনুভব করবেন। যেমন, কোল্ড স্টার্টের সময় এই লেটেন্সি হয় যখন ক্যাশে করা টোকেনের মেয়াদ শেষ হয়ে যায় বা সেটি পাওয়া যায় না।
  • টোকেন TTL: টাইম টু লাইভ (TTL) নির্ধারণ করে যে রিফ্রেশ করার আগে অ্যাপ চেক টোকেন কতক্ষণ বৈধ থাকবে। আপনি Firebase কনসোলে এই সময়সীমা ৩০ মিনিট থেকে ৭ দিন পর্যন্ত কনফিগার করতে পারবেন। নিরাপদ বেসলাইন হিসেবে ১ ঘণ্টা সময়সীমা সাজেস্ট করা হয়, তবে SDK অটোমেটিক TTL সময়সীমার প্রায় অর্ধেক সময়ে ব্যাকগ্রাউন্ড রিফ্রেশ করার চেষ্টা করে। কনসোল সংক্রান্ত ধাপে-ধাপে নির্দেশাবলীর জন্য, Firebase App Check ডকুমেন্টেশন দেখুন।

App Check-এর সাথে আপনার অ্যাপ ইন্টিগ্রেট করা

পূর্বশর্ত ও প্রয়োজনীয়তা

  • Android ভার্সন ৭.৯ বা তার পরবর্তী ভার্সনের জন্য Navigation SDK সহ একটি অ্যাপ ইনস্টল করা আছে।
  • আপনার অ্যাপের SHA-256 সার্টিফিকেট ফিঙ্গারপ্রিন্ট।
  • আপনার অ্যাপের প্যাকেজের নাম।
  • আপনাকে Google Cloud কনসোলে অ্যাপের মালিক হতে হবে।
  • Google Cloud কনসোল থেকে আপনার অ্যাপের প্রোজেক্ট আইডি।

ধাপ ১: আপনার অ্যাপে Firebase যোগ করুন

আপনার অ্যাপে Firebase যোগ করতে Firebase ডেভেলপার ডকুমেন্টেশনে দেওয়া নির্দেশাবলী অনুসরণ করুন। আপনার প্রোজেক্টের অ্যাপ লেভেল ডিরেক্টরিতে google-services.json ফাইল যোগ করুন।

ধাপ ২: App Check লাইব্রেরি যোগ করা এবং App Check শুরু করা

আপনার অ্যাপের build.gradle ফাইলে App Check ডিপেন্ডেন্সি যোগ করুন:

Groovy (build.gradle)

dependencies {
    // Import the Firebase BoM
    implementation platform('com.google.firebase:firebase-bom:34.17.0')
    // Add the dependency for the App Check library with Play Integrity
    implementation 'com.google.firebase:firebase-appcheck-playintegrity'
}

আপনার অ্যাপ্লিকেশন ক্লাস বা প্রধান অ্যাক্টিভিটিতে App Check শুরু করুন:

Java

import com.google.firebase.FirebaseApp;
import com.google.firebase.appcheck.FirebaseAppCheck;
import com.google.firebase.appcheck.playintegrity.PlayIntegrityAppCheckProviderFactory;

// Initialize Firebase App
FirebaseApp.initializeApp(/* context= */ this);

// Initialize App Check
FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
firebaseAppCheck.installAppCheckProviderFactory(
    PlayIntegrityAppCheckProviderFactory.getInstance());

Kotlin

import com.google.firebase.Firebase
import com.google.firebase.appcheck.appCheck
import com.google.firebase.appcheck.playintegrity.PlayIntegrityAppCheckProviderFactory
import com.google.firebase.initialize

// Initialize Firebase App
Firebase.initialize(context = this)

// Initialize App Check
Firebase.appCheck.installAppCheckProviderFactory(
    PlayIntegrityAppCheckProviderFactory.getInstance(),
)

ধাপ ৩: টোকেন প্রদানকারী যোগ করুন

MapsAppCheckTokenProvider ইন্টারফেসের একটি ইমপ্লিমেন্টেশন তৈরি করুন। এই পরিষেবা প্রদানকারী Firebase App Check থেকে অ্যাসিঙ্ক্রোনাসভাবে App Check টোকেন নিয়ে আসে এবং MapsAppCheckTokenCallback ব্যবহার করে Android নেটওয়ার্ক স্ট্যাকের জন্য Navigation SDK-তে সেগুলি পাস করে:

Java

import com.google.android.gms.maps.MapsAppCheckTokenCallback;
import com.google.android.gms.maps.MapsAppCheckTokenProvider;
import com.google.firebase.appcheck.FirebaseAppCheck;

public class NavigationTokenProvider implements MapsAppCheckTokenProvider {
  @Override
  public void fetchToken(MapsAppCheckTokenCallback callback) {
    FirebaseAppCheck.getInstance()
        .getAppCheckToken(false) // forcingRefresh = false
        .addOnSuccessListener(
            tokenResult -> {
              String token = tokenResult.getToken();
              callback.onSuccess(token);
            })
        .addOnFailureListener(
            e -> {
              callback.onFailure();
            });
  }
}

Kotlin

import com.google.android.gms.maps.MapsAppCheckTokenCallback
import com.google.android.gms.maps.MapsAppCheckTokenProvider
import com.google.firebase.appcheck.FirebaseAppCheck

class NavigationTokenProvider : MapsAppCheckTokenProvider {
    override fun fetchToken(callback: MapsAppCheckTokenCallback) {
        FirebaseAppCheck.getInstance()
            .getAppCheckToken(false)
            .addOnSuccessListener { tokenResult ->
                callback.onSuccess(tokenResult.token)
            }
            .addOnFailureListener {
                callback.onFailure()
            }
    }
}

ধাপ ৪: Navigation এবং App Check API শুরু করা

Android-এর জন্য Navigation SDK শুরু করুন এবং MapsApiSettings.setAppCheckTokenProvider() ব্যবহার করে আপনার ইউনিফায়েড টোকেন প্রোভাইডার ইনস্ট্যান্স রেজিস্টার করুন:

Java

import com.google.android.gms.maps.MapsApiSettings;

// Register your App Check token provider before initializing Navigation SDK for Android
MapsApiSettings.setAppCheckTokenProvider(context, new NavigationTokenProvider());

Kotlin

import com.google.android.gms.maps.MapsApiSettings

// Register your App Check token provider before initializing Navigation SDK for Android
MapsApiSettings.setAppCheckTokenProvider(context, NavigationTokenProvider())

ধাপ ৫: ডিবাগিং চালু করা (ঐচ্ছিক)

Android-এর জন্য Navigation SDK-এর জন্য App Check এনফোর্স করার পরে, Android-এর জন্য Navigation SDK-এর উপর নির্ভর করে এমন আপনার অ্যাপের ফিচার সিমুলেটর বা কন্টিনিউয়াস ইন্টিগ্রেশন (CI) এনভায়রনমেন্ট থেকে রান করবে না কারণ এইসব এনভায়রনমেন্ট বৈধ ডিভাইস হিসেবে গণ্য হয় না। ডেভেলপমেন্ট ও টেস্টিংয়ের সময় এইসব এনভায়রনমেন্টে আপনার অ্যাপ চালাতে, আপনাকে অ্যাপের একটি ডিবাগ বিল্ড তৈরি করতে হবে যা প্রোডাকশন অ্যাটেস্টেশন প্রোভাইডারের পরিবর্তে App Check ডিবাগ প্রোভাইডার ব্যবহার করে।

  1. আপনার অ্যাপের build.gradle ফাইলে ডিবাগ প্রোভাইডার ডিপেন্ডেন্সি যোগ করুন:

    Groovy (build.gradle)

    dependencies {
        implementation 'com.google.firebase:firebase-appcheck-debug'
    }
  2. আপনার ডিবাগ বিল্ডে ডিবাগ প্রোভাইডার ফ্যাক্টরি ব্যবহার করতে App Check কনফিগার করুন:

    Java

    import com.google.firebase.appcheck.debug.DebugAppCheckProviderFactory;
    import com.google.firebase.appcheck.playintegrity.PlayIntegrityAppCheckProviderFactory;
    
    if (BuildConfig.DEBUG) {
        firebaseAppCheck.installAppCheckProviderFactory(
            DebugAppCheckProviderFactory.getInstance()
        );
    } else {
        firebaseAppCheck.installAppCheckProviderFactory(
            PlayIntegrityAppCheckProviderFactory.getInstance()
        );
    }

    Kotlin

    import com.google.firebase.Firebase
    import com.google.firebase.appcheck.appCheck
    import com.google.firebase.appcheck.debug.DebugAppCheckProviderFactory
    import com.google.firebase.appcheck.playintegrity.PlayIntegrityAppCheckProviderFactory
    
    if (BuildConfig.DEBUG) {
        Firebase.appCheck.installAppCheckProviderFactory(
            DebugAppCheckProviderFactory.getInstance(),
        )
    } else {
        Firebase.appCheck.installAppCheckProviderFactory(
            PlayIntegrityAppCheckProviderFactory.getInstance(),
        )
    }
  3. এমুলেটর বা ডিবাগ ডিভাইসে আপনার অ্যাপ লঞ্চ করুন। App Check আপনার logcat আউটপুটে একটি লোকাল ডিবাগ টোকেন প্রিন্ট করবে।
  4. Firebase কনসোলে এই ডিবাগ টোকেন কপি করে রেজিস্টার করুন। আরও জানতে, Firebase App Check ডিবাগ প্রোভাইডার ডকুমেন্টেশন দেখুন।

ধাপ ৬: আপনার অ্যাপের অনুরোধ মনিটর করা এবং এনফোর্সমেন্ট সংক্রান্ত সিদ্ধান্ত নেওয়া

এনফোর্সমেন্ট চালু করার আগে, আপনার অ্যাপের অনুরোধ মনিটর করুন যাতে আপনি বৈধ ব্যবহারকারীদের বাধা না দেন।

  1. যাচাই করা বনাম যাচাই না করা ট্রাফিকের শতাংশ দেখতে Firebase কনসোলে App Check মেট্রিক্স স্ক্রিনে যান।
  2. আপনার বেশিরভাগ ট্রাফিক যাচাই করা হয়েছে এবং বৈধ ব্যবহারকারীরা আপনার অ্যাপের এমন একটি ভার্সনে আপডেট করেছেন যাতে আপনার App Check প্রয়োগ করা আছে, এই বিষয়ে নিশ্চিত হওয়ার পরে এনফোর্সমেন্ট চালু করুন।
  3. এনফোর্সমেন্ট চালু হয়ে গেলে, সঠিক App Check টোকেন ছাড়া সব ট্রাফিক App Check বাতিল করে দেবে।