প্রতিকার

এই পৃষ্ঠাটি বর্ণনা করে যে কীভাবে সততার রায়ের সাথে সমস্যাগুলি পরিচালনা করা যায়৷

যখন একটি অখণ্ডতা টোকেন অনুরোধ করা হয়, আপনার কাছে ব্যবহারকারীর কাছে একটি Google Play ডায়ালগ প্রদর্শন করার বিকল্প থাকে৷ অখণ্ডতার রায়ের সাথে এক বা একাধিক সমস্যা থাকলে আপনি ডায়ালগটি প্রদর্শন করতে পারেন। ডায়ালগটি আপনার অ্যাপের উপরে প্রদর্শিত হয় এবং ব্যবহারকারীদের সমস্যার কারণ সমাধান করার জন্য অনুরোধ করে। একবার ডায়ালগটি বন্ধ হয়ে গেলে, আপনি যাচাই করতে পারেন যে ইন্টিগ্রিটি API-কে অন্য একটি অনুরোধের মাধ্যমে সমস্যাটি স্থির করা হয়েছে৷

দ্রষ্টব্য: অখণ্ডতা টোকেনের বিষয়বস্তু নির্বিশেষে সমস্ত অখণ্ডতার ডায়ালগ ব্যবহারকারীদের দেখানো যেতে পারে। কোন ডায়ালগ দেখানো হবে তা নির্ধারণ করতে আপনার সার্ভারে থাকা অখণ্ডতা টোকেনের বিষয়বস্তু পরীক্ষা করা উচিত।

সততা ডায়ালগ

GET_LICENSED (টাইপ কোড 1)

রায় ইস্যু

যখন appLicensingVerdict == "UNLICENSED" । এর মানে ব্যবহারকারীর অ্যাকাউন্টটি লাইসেন্সবিহীন। অন্য কথায়, তারা Google Play থেকে অ্যাপটি ইনস্টল বা কিনেনি।

প্রতিকার

আপনি ব্যবহারকারীকে Google Play থেকে আপনার অ্যাপ পেতে অনুরোধ জানাতে GET_LICENSED ডায়ালগ দেখাতে পারেন। ব্যবহারকারী গ্রহণ করলে, ব্যবহারকারীর অ্যাকাউন্ট লাইসেন্সপ্রাপ্ত হয়ে যায় ( appLicensingVerdict == "LICENSED" )। অ্যাপটি ব্যবহারকারীর Google Play লাইব্রেরিতে যোগ করা হয়েছে এবং Google Play আপনার পক্ষ থেকে অ্যাপ আপডেট সরবরাহ করতে পারে।

উদাহরণ UX

CLOSE_UNKNOWN_ACCESS_RISK (টাইপ কোড 2)

রায় ইস্যু

যখন environmentDetails.appAccessRiskVerdict.appsDetected "UNKNOWN_CAPTURING" বা "UNKNOWN_CONTROLLING" থাকে, তখন এর মানে ডিভাইসে অজানা অ্যাপ চলছে যা স্ক্রিন ক্যাপচার করতে বা ডিভাইস নিয়ন্ত্রণ করতে পারে।

প্রতিকার

আপনি CLOSE_UNKNOWN_ACCESS_RISK ডায়ালগ দেখাতে পারেন যাতে ব্যবহারকারীকে সমস্ত অজানা অ্যাপ বন্ধ করতে বলা হয় যা স্ক্রীন ক্যাপচার করতে পারে বা ডিভাইস নিয়ন্ত্রণ করতে পারে। ব্যবহারকারী যদি Close all বোতামে ট্যাপ করে তাহলে এই ধরনের সব অ্যাপ বন্ধ হয়ে যাবে।

উদাহরণ UX

CLOSE_ALL_ACCESS_RISK (টাইপ কোড 3)

রায় ইস্যু

যখন environmentDetails.appAccessRiskVerdict.appsDetected "KNOWN_CAPTURING" , "KNOWN_CONTROLLING" , "UNKNOWN_CAPTURING" বা "UNKNOWN_CONTROLLING" এর যে কোনো একটি থাকে, এর মানে হল ডিভাইসে এমন অ্যাপ চলছে যা নিয়ন্ত্রণকারী ডিভাইস বা ক্যাপচারিং স্ক্রীনে চলছে।

প্রতিকার

আপনি CLOSE_ALL_ACCESS_RISK ডায়ালগ দেখাতে পারেন যাতে ব্যবহারকারীকে সমস্ত অ্যাপ বন্ধ করার অনুরোধ জানানো হয় যা স্ক্রীন ক্যাপচার করতে পারে বা ডিভাইস নিয়ন্ত্রণ করতে পারে। ব্যবহারকারী যদি Close all বোতামে ট্যাপ করেন, তাহলে এই ধরনের সমস্ত অ্যাপ ডিভাইসে বন্ধ হয়ে যাবে।

উদাহরণ UX

একটি অখণ্ডতা ডায়ালগ অনুরোধ

যখন ক্লায়েন্ট একটি অখণ্ডতা টোকেন অনুরোধ করে, আপনি স্ট্যান্ডার্ডইনটেগ্রিটি টোকেন (স্ট্যান্ডার্ড API) এবং ইন্টিগ্রিটি টোকেন রেসপন্স (ক্লাসিক API) এ দেওয়া পদ্ধতিটি ব্যবহার করতে পারেন: showDialog(Activity activity, int integrityDialogTypeCode) ।

দ্রষ্টব্য: অখণ্ডতা ডায়ালগগুলি ব্যবহার করতে, আপনাকে অবশ্যই ইন্টিগ্রিটি API অ্যান্ড্রয়েড লাইব্রেরি সংস্করণ 1.3.0 বা উচ্চতর ব্যবহার করতে হবে৷ এটি এখনও ইউনিটি প্লাগইন দ্বারা সমর্থিত নয়৷

GET_LICENSED ডায়ালগ দেখাতে আপনি কীভাবে Play Integrity API ব্যবহার করতে পারেন তা নিম্নোক্ত ধাপগুলি রূপরেখা দেয়:

1. আপনার অ্যাপ থেকে একটি অখণ্ডতা টোকেন অনুরোধ করুন, এবং আপনার সার্ভারে টোকেন পাঠান। আপনি স্ট্যান্ডার্ড বা ক্লাসিক অনুরোধ ব্যবহার করতে পারেন।

   কোটলিন

   // Request an integrity token
   val tokenResponse: StandardIntegrityToken = requestIntegrityToken()
   // Send token to app server and get response on what to do next
   val yourServerResponse: YourServerResponse = sendToServer(tokenResponse.token())  

   জাভা

   // Request an integrity token
   StandardIntegrityToken tokenResponse = requestIntegrityToken();
   // Send token to app server and get response on what to do next
   YourServerResponse yourServerResponse = sendToServer(tokenResponse.token());  

   ঐক্য

   // Request an integrity token
   StandardIntegrityToken tokenResponse = RequestIntegrityToken();
   // Send token to app server and get response on what to do next
   YourServerResponse yourServerResponse = sendToServer(tokenResponse.Token); 

   নেটিভ

   /// Request an integrity token
   StandardIntegrityToken* response = requestIntegrityToken();
   /// Send token to app server and get response on what to do next
   YourServerResponse yourServerResponse = sendToServer(StandardIntegrityToken_getToken(response));

2. আপনার সার্ভারে, অখণ্ডতা টোকেন ডিক্রিপ্ট করুন এবং appLicensingVerdict ক্ষেত্রটি পরীক্ষা করুন। এটি এই মত কিছু দেখতে পারে:

   // Licensing issue
   {
     ...
     accountDetails: {
         appLicensingVerdict: "UNLICENSED"
     }
   }

3. যদি টোকেনে appLicensingVerdict: "UNLICENSED" , আপনার অ্যাপ ক্লায়েন্টকে উত্তর দিন, অনুরোধ করে এটি লাইসেন্সিং ডায়ালগ দেখান:

   কোটলিন

   private fun getDialogTypeCode(integrityToken: String): Int{
     // Get licensing verdict from decrypted and verified integritytoken
     val licensingVerdict: String = getLicensingVerdictFromDecryptedToken(integrityToken)
   
     return if (licensingVerdict == "UNLICENSED") {
             1 // GET_LICENSED
         } else 0
   }

   জাভা

   private int getDialogTypeCode(String integrityToken) {
     // Get licensing verdict from decrypted and verified integrityToken
     String licensingVerdict = getLicensingVerdictFromDecryptedToken(integrityToken);
   
     if (licensingVerdict.equals("UNLICENSED")) {
       return 1; // GET_LICENSED
     }
     return 0;
   }

   ঐক্য

   private int GetDialogTypeCode(string IntegrityToken) {
     // Get licensing verdict from decrypted and verified integrityToken
     string licensingVerdict = GetLicensingVerdictFromDecryptedToken(IntegrityToken);
   
     if (licensingVerdict == "UNLICENSED") {
       return 1; // GET_LICENSED
     }
     return 0;
   } 

   নেটিভ

   private int getDialogTypeCode(string integrity_token) {
     /// Get licensing verdict from decrypted and verified integrityToken
     string licensing_verdict = getLicensingVerdictFromDecryptedToken(integrity_token);
   
     if (licensing_verdict == "UNLICENSED") {
       return 1; // GET_LICENSED
     }
     return 0;
   }

4. আপনার অ্যাপে, আপনার সার্ভার থেকে পুনরুদ্ধার করা অনুরোধকৃত কোড সহ showDialog কল করুন:

   কোটলিন

   // Show dialog as indicated by the server
   val showDialogType: Int? = yourServerResponse.integrityDialogTypeCode()
   if (showDialogType != null) {
     // Call showDialog with type code, the dialog will be shown on top of the
     // provided activity and complete when the dialog is closed.
     val integrityDialogResponseCode: Task<Int> =
     tokenResponse.showDialog(activity, showDialogType)
     // Handle response code, call the Integrity API again to confirm that
     // verdicts have been resolved.
   } 

   জাভা

   // Show dialog as indicated by the server
   @Nullable Integer showDialogType = yourServerResponse.integrityDialogTypeCode();
   if (showDialogType != null) {
     // Call showDialog with type code, the dialog will be shown on top of the
     // provided activity and complete when the dialog is closed.
     Task<Integer> integrityDialogResponseCode =
         tokenResponse.showDialog(activity, showDialogType);
     // Handle response code, call the Integrity API again to confirm that
     // verdicts have been resolved.
   }

   ঐক্য

   IEnumerator ShowDialogCoroutine() {
     int showDialogType = yourServerResponse.IntegrityDialogTypeCode();
   
     // Call showDialog with type code, the dialog will be shown on top of the
     // provided activity and complete when the dialog is closed.
     var showDialogTask = tokenResponse.ShowDialog(showDialogType);
   
     // Wait for PlayAsyncOperation to complete.
     yield return showDialogTask;
   
     // Handle response code, call the Integrity API again to confirm that
     // verdicts have been resolved.
   } 

   নেটিভ

   // Show dialog as indicated by the server
   int show_dialog_type = yourServerResponse.integrityDialogTypeCode();
   if (show_dialog_type != 0) {
     /// Call showDialog with type code, the dialog will be shown on top of the
     /// provided activity and complete when the dialog is closed.
     StandardIntegrityErrorCode error_code =
         IntegrityTokenResponse_showDialog(response, activity, show_dialog_type);
   
     /// Proceed to polling iff error_code == STANDARD_INTEGRITY_NO_ERROR
     if (error_code != STANDARD_INTEGRITY_NO_ERROR)
     {
         /// Remember to call the *_destroy() functions.
         return;
     }
   
     /// Use polling to wait for the async operation to complete.
     /// Note, the polling shouldn't block the thread where the IntegrityManager
     /// is running.
   
     IntegrityDialogResponseCode* response_code;
     error_code = StandardIntegrityToken_getDialogResponseCode(response, response_code);
   
     if (error_code != STANDARD_INTEGRITY_NO_ERROR)
     {
         /// Remember to call the *_destroy() functions.
         return;
     }
   
     /// Handle response code, call the Integrity API again to confirm that
     /// verdicts have been resolved.
   }

5. ডায়ালগটি প্রদত্ত কার্যকলাপের উপরে প্রদর্শিত হয়। যখন ব্যবহারকারী ডায়ালগটি বন্ধ করে দেয়, টাস্কটি একটি প্রতিক্রিয়া কোড দিয়ে সম্পূর্ণ হয়।

6. (ঐচ্ছিক) অন্য কোনো ডায়ালগ প্রদর্শনের জন্য অন্য টোকেনের অনুরোধ করুন। আপনি যদি স্ট্যান্ডার্ড অনুরোধ করেন, তাহলে নতুন রায় পাওয়ার জন্য আপনাকে টোকেন প্রদানকারীকে আবার গরম করতে হবে।