Flutter সহ ডিবাগ প্রদানকারীর সাথে অ্যাপ চেক ব্যবহার করুন

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

অ্যাপল প্ল্যাটফর্ম

সিমুলেটরে আপনার অ্যাপটি ইন্টারেক্টিভভাবে চালানোর সময় (উদাহরণস্বরূপ, লোকাল ডেভেলপমেন্টের সময়) ডিবাগ প্রোভাইডারটি কীভাবে ব্যবহার করবেন, তা এখানে দেওয়া হলো:

1. আপনার Firebase অ্যাপটি ইনিশিয়ালাইজ করার ঠিক পরেই ডিবাগ প্রোভাইডারের সাহায্যে App Check সক্রিয় করুন:

   import 'package:flutter/material.dart';
   import 'package:firebase_core/firebase_core.dart';
   
   // Import the firebase_app_check plugin
   import 'package:firebase_app_check/firebase_app_check.dart';
   
   Future<void> main() async {
     WidgetsFlutterBinding.ensureInitialized();
     await Firebase.initializeApp();
     await FirebaseAppCheck.instance.activate(
       // Set appleProvider to `AppleProvider.debug`
       appleProvider: AppleProvider.debug,
     );
     runApp(App());
   }
   

2. আপনার Xcode প্রোজেক্টে (v11.0 বা নতুন সংস্করণ) ডিবাগ লগিং চালু করুন:

   1. প্রোডাক্ট > স্কিম > স্কিম সম্পাদনা খুলুন।
   2. বাম দিকের মেনু থেকে রান (Run) নির্বাচন করুন, তারপর আর্গুমেন্টস (Arguments) ট্যাবটি নির্বাচন করুন।
   3. "Arguments Passed on Launch" বিভাগে, -FIRDebugEnabled " যোগ করুন।

3. আপনার ডিবাগ টোকেন সংগ্রহ করুন:

   1. Xcode দিয়ে ios/Runner.xcworkspace খুলুন এবং আপনার অ্যাপটি সিমুলেটরে বা আপনার টেস্ট ডিভাইসে চালান।

   2. Xcode কনসোল খুলুন এবং App Check ডিবাগ টোকেনটি খুঁজুন। উদাহরণস্বরূপ:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
      

   3. টোকেনটি কপি করুন (উদাহরণস্বরূপ, 123a4567-b89c-12d3-e456-789012345678 )।

4. App Check সাথে আপনার ডিবাগ টোকেন নিবন্ধন করুন:

   1. Firebase কনসোলে, Security > App Check > Apps ট্যাবে যান।

   2. আপনার অ্যাপটি খুঁজুন, তিন-বিন্দুযুক্ত ওভারফ্লো মেনুতে ( more_vert ) ক্লিক করুন এবং তারপরে 'ম্যানেজ ডিবাগ টোকেনস' নির্বাচন করুন।

   3. আপনার ডিবাগ টোকেন নিবন্ধন করতে স্ক্রিনে দেওয়া নির্দেশাবলী অনুসরণ করুন।

   

App Check এ টোকেনটি নিবন্ধন করার পর, আপনার ব্যাকএন্ড পরিষেবাগুলো এটিকে বৈধ হিসেবে গ্রহণ করবে।

এই টোকেনটি একটি বৈধ ডিভাইস ছাড়াই আপনার ব্যাকএন্ড পরিষেবাগুলিতে অ্যাক্সেস দেয়, তাই এটিকে ব্যক্তিগত রাখা অত্যন্ত গুরুত্বপূর্ণ। এটিকে কোনো পাবলিক রিপোজিটরিতে কমিট করবেন না বা আপনার অ্যাপের প্রোডাকশন বিল্ডে অন্তর্ভুক্ত করবেন না। যদি কোনো নিবন্ধিত টোকেন কখনো অরক্ষিত হয়ে পড়ে, তাহলে Firebase কনসোলে থাকা ‘Manage debug tokens’ ব্যবহার করে অবিলম্বে সেটি মুছে ফেলুন।

অ্যান্ড্রয়েড

ইমুলেটরে আপনার অ্যাপটি ইন্টারেক্টিভভাবে চালানোর সময় (উদাহরণস্বরূপ, লোকাল ডেভেলপমেন্টের সময়) ডিবাগ প্রোভাইডারটি কীভাবে ব্যবহার করবেন, তা এখানে দেওয়া হলো:

1. আপনার Firebase অ্যাপটি ইনিশিয়ালাইজ করার ঠিক পরেই ডিবাগ প্রোভাইডারের সাহায্যে App Check সক্রিয় করুন:

   import 'package:flutter/material.dart';
   import 'package:firebase_core/firebase_core.dart';
   
   // Import the firebase_app_check plugin
   import 'package:firebase_app_check/firebase_app_check.dart';
   
   Future<void> main() async {
     WidgetsFlutterBinding.ensureInitialized();
     await Firebase.initializeApp();
     await FirebaseAppCheck.instance.activate(
       // Set androidProvider to `AndroidProvider.debug`
       androidProvider: AndroidProvider.debug,
     );
     runApp(App());
   }
   
   

2. আপনার ডিবাগ টোকেন সংগ্রহ করুন:

   1. আপনার অ্যাপটি এমুলেটরে অথবা আপনার টেস্ট ডিভাইসে চালান।

   2. আপনার লগগুলিতে App Check ডিবাগ টোকেনটি খুঁজুন। উদাহরণস্বরূপ:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      

   3. টোকেনটি কপি করুন (উদাহরণস্বরূপ, 123a4567-b89c-12d3-e456-789012345678 )।

3. App Check সাথে আপনার ডিবাগ টোকেন নিবন্ধন করুন:

   1. Firebase কনসোলে, Security > App Check > Apps ট্যাবে যান।

   2. আপনার অ্যাপটি খুঁজুন, তিন-বিন্দুযুক্ত ওভারফ্লো মেনুতে ( more_vert ) ক্লিক করুন এবং তারপরে 'ম্যানেজ ডিবাগ টোকেনস' নির্বাচন করুন।

   3. আপনার ডিবাগ টোকেন নিবন্ধন করতে স্ক্রিনে দেওয়া নির্দেশাবলী অনুসরণ করুন।

   

App Check এ টোকেনটি নিবন্ধন করার পর, আপনার ব্যাকএন্ড পরিষেবাগুলো এটিকে বৈধ হিসেবে গ্রহণ করবে।

এই টোকেনটি একটি বৈধ ডিভাইস ছাড়াই আপনার ব্যাকএন্ড পরিষেবাগুলিতে অ্যাক্সেস দেয়, তাই এটিকে ব্যক্তিগত রাখা অত্যন্ত গুরুত্বপূর্ণ। এটিকে কোনো পাবলিক রিপোজিটরিতে কমিট করবেন না বা আপনার অ্যাপের প্রোডাকশন বিল্ডে অন্তর্ভুক্ত করবেন না। যদি কোনো নিবন্ধিত টোকেন কখনো অরক্ষিত হয়ে পড়ে, তাহলে Firebase কনসোলে থাকা ‘Manage debug tokens’ ব্যবহার করে অবিলম্বে সেটি মুছে ফেলুন।

ওয়েব

localhost থেকে আপনার অ্যাপ চালানোর সময় (উদাহরণস্বরূপ, লোকাল ডেভেলপমেন্টের সময়) ডিবাগ প্রোভাইডারটি যেভাবে ব্যবহার করবেন, তা এখানে দেওয়া হলো:

1. web/index.html ফাইলে, self.FIREBASE_APPCHECK_DEBUG_TOKEN কে true সেট করে ডিবাগ মোড চালু করুন:

   <body>
     <script>
       self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
     </script>
   
     ...
   
   </body>
   

2. আপনার ওয়েব অ্যাপটি স্থানীয়ভাবে চালান এবং ব্রাউজারের ডেভেলপার টুলস খুলুন। ডিবাগ কনসোলে আপনি একটি ডিবাগ টোকেন দেখতে পাবেন। উদাহরণস্বরূপ:

   AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
   You will need to safelist it in the Firebase console for it to work.
   

   এই টোকেনটি আপনার ব্রাউজারে স্থানীয়ভাবে সংরক্ষিত থাকে এবং একই মেশিনে একই ব্রাউজারে যখনই আপনি আপনার অ্যাপ ব্যবহার করবেন, তখনই এটি ব্যবহৃত হবে। আপনি যদি টোকেনটি অন্য কোনো ব্রাউজারে বা অন্য কোনো মেশিনে ব্যবহার করতে চান, তাহলে true এর পরিবর্তে ` self.FIREBASE_APPCHECK_DEBUG_TOKEN কে টোকেন স্ট্রিং-এ সেট করুন।

3. App Check সাথে আপনার ডিবাগ টোকেন নিবন্ধন করুন:

   1. Firebase কনসোলে, Security > App Check > Apps ট্যাবে যান।

   2. আপনার অ্যাপটি খুঁজুন, তিন-বিন্দুযুক্ত ওভারফ্লো মেনুতে ( more_vert ) ক্লিক করুন এবং তারপরে 'ম্যানেজ ডিবাগ টোকেনস' নির্বাচন করুন।

   3. আপনার ডিবাগ টোকেন নিবন্ধন করতে স্ক্রিনে দেওয়া নির্দেশাবলী অনুসরণ করুন।

   

App Check এ টোকেনটি নিবন্ধন করার পর, আপনার ব্যাকএন্ড পরিষেবাগুলো এটিকে বৈধ হিসেবে গ্রহণ করবে।

এই টোকেনটি একটি বৈধ ডিভাইস ছাড়াই আপনার ব্যাকএন্ড পরিষেবাগুলিতে অ্যাক্সেস দেয়, তাই এটিকে ব্যক্তিগত রাখা অত্যন্ত গুরুত্বপূর্ণ। এটিকে কোনো পাবলিক রিপোজিটরিতে কমিট করবেন না বা আপনার অ্যাপের প্রোডাকশন বিল্ডে অন্তর্ভুক্ত করবেন না। যদি কোনো নিবন্ধিত টোকেন কখনো অরক্ষিত হয়ে পড়ে, তাহলে Firebase কনসোলে থাকা ‘Manage debug tokens’ ব্যবহার করে অবিলম্বে সেটি মুছে ফেলুন।