बचा हुआ डेटा

इस पेज पर, इंटिग्रिटी से जुड़े फ़ैसलों से जुड़ी समस्याओं को हल करने का तरीका बताया गया है.

इंटिग्रिटी टोकन का अनुरोध मिलने पर, आपके पास उपयोगकर्ता को Google Play का डायलॉग बॉक्स दिखाने का विकल्प होता है. अगर इंटिग्रिटी से जुड़े फ़ैसले में एक या उससे ज़्यादा समस्याएं हैं, तो डायलॉग दिखाया जा सकता है. यह डायलॉग आपके ऐप्लिकेशन में सबसे ऊपर दिखता है. साथ ही, उपयोगकर्ताओं को समस्या की वजह हल करने के लिए कहा जाता है. डायलॉग बॉक्स बंद होने के बाद, Integrity API से एक और अनुरोध करके पुष्टि की जा सकती है कि समस्या ठीक हो गई है या नहीं.

ध्यान दें: इंटिग्रिटी टोकन का कॉन्टेंट चाहे जैसा भी हो, उपयोगकर्ताओं को सभी तरह के इंटिग्रिटी डायलॉग दिखाए जा सकते हैं. कौनसा डायलॉग दिखाया जाना चाहिए, यह तय करने के लिए आपको अपने सर्वर पर इंटिग्रिटी टोकन के कॉन्टेंट की जांच करनी चाहिए.

इंटिग्रिटी डायलॉग

GET_LICENSED (टाइप कोड 1)

नतीजे से जुड़ी समस्या

जब appLicensingVerdict == "UNLICENSED". इसका मतलब है कि उपयोगकर्ता खाते के पास लाइसेंस नहीं है. दूसरे शब्दों में, उन्होंने Google Play से ऐप्लिकेशन को इंस्टॉल या खरीदा नहीं है.

समस्या हल करना

उपयोगकर्ता को Google Play से आपका ऐप्लिकेशन डाउनलोड करने के लिए कहने के लिए, GET_LICENSED डायलॉग बॉक्स दिखाया जा सकता है. अगर उपयोगकर्ता स्वीकार करता है, तो उपयोगकर्ता खाते को लाइसेंस मिल जाता है (appLicensingVerdict == "LICENSED"). ऐप्लिकेशन को उपयोगकर्ता की Google Play लाइब्रेरी में जोड़ दिया जाता है और Google Play आपकी ओर से ऐप्लिकेशन के अपडेट डिलीवर कर सकता है.

यूज़र एक्सपीरियंस (यूएक्स) का उदाहरण

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 बटन पर टैप करता है, तो डिवाइस पर ऐसे सभी ऐप्लिकेशन बंद हो जाते हैं.

यूज़र एक्सपीरियंस (यूएक्स) का उदाहरण

इंटिग्रिटी डायलॉग का अनुरोध करना

जब क्लाइंट, इंटिग्रिटी टोकन के लिए अनुरोध करता है, तो StandardIntegrityToken (स्टैंडर्ड एपीआई) और IntegrityTokenResponse (क्लासिक एपीआई) में बताए गए तरीके का इस्तेमाल किया जा सकता है: showDialog(Activity activity, int integrityDialogTypeCode).

ध्यान दें: इंटिग्रिटी डायलॉग का इस्तेमाल करने के लिए, आपके पास Integrity API की Android लाइब्रेरी का 1.3.0 या इसके बाद का वर्शन होना चाहिए. फ़िलहाल, Unity प्लग इन के साथ इसका इस्तेमाल नहीं किया जा सकता.

यहां बताया गया है कि GET_LICENSED डायलॉग दिखाने के लिए, Play Integrity API का इस्तेमाल कैसे किया जा सकता है:

1. अपने ऐप्लिकेशन से इंटिग्रिटी टोकन का अनुरोध करें और टोकन को अपने सर्वर पर भेजें. इसके लिए, स्टैंडर्ड या क्लासिक अनुरोध का इस्तेमाल किया जा सकता है.

   Kotlin

   // 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())  

   Java

   // 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());  

   Unity

   // 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" है, तो अपने ऐप्लिकेशन क्लाइंट को जवाब दें और लाइसेंस देने वाला डायलॉग दिखाने का अनुरोध करें:

   Kotlin

   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
   }

   Java

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

   Unity

   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 को कॉल करें:

   Kotlin

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

   Java

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

   Unity

   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. (ज़रूरी नहीं) कोई और डायलॉग दिखाने के लिए, किसी दूसरे टोकन का अनुरोध करें. स्टैंडर्ड अनुरोध करने पर, आपको नया फ़ैसला पाने के लिए, टोकन देने वाली कंपनी को फिर से वॉर्म अप करना होगा.