תיקון שגיאות

בדף הזה מוסבר איך לטפל בבעיות שקשורות להחלטות לגבי תקינות.

כשמתבצע בקשה לאסימון תקינות, יש לכם אפשרות להציג למשתמש תיבת דו-שיח של Google Play. יכול להיות שתיבת הדו-שיח תופיע אם יש בעיה אחת או יותר לקביעת התקינות. תיבת הדו-שיח תוצג בחלק העליון של האפליקציה, ותציע למשתמשים לפתור את הבעיה. אחרי שהתיבת הדו-שיח תיסגר, תוכלו לשלוח בקשה נוספת ל-Integrity API כדי לוודא שהבעיה נפתרה.

תיבות דו-שיח של בדיקות תקינות

GET_LICENSED (סוג קוד 1)

בעיה בתוצאה

כאשר appLicensingVerdict == "UNLICENSED". המשמעות היא שלחשבון המשתמש אין רישיון. במילים אחרות, הם לא התקינו או קנו את האפליקציה מ-Google Play.

תיקון

אפשר להציג את תיבת הדו-שיח GET_LICENSED כדי לבקש מהמשתמש להוריד את האפליקציה מ-Google Play. אם המשתמש יאשר, חשבון המשתמש יקבל רישיון (appLicensingVerdict == "LICENSED"). האפליקציה תתווסף לספרייה של המשתמש ב-Google Play, ו-Google Play תוכל לשלוח עדכוני אפליקציה בשמכם.

דוגמה לחוויית משתמש

CLOSE_UNKNOWN_ACCESS_RISK (קוד סוג 2)

בעיה בתוצאה

אם השדה environmentDetails.appAccessRiskVerdict.appsDetected מכיל את הערך "UNKNOWN_CAPTURING" או "UNKNOWN_CONTROLLING", סימן שיש אפליקציות לא מוכרות שפועלות במכשיר ויכולות לצלם את המסך או לשלוט במכשיר.

תיקון

אתם יכולים להציג את תיבת הדו-שיח CLOSE_UNKNOWN_ACCESS_RISK כדי לבקש מהמשתמש לסגור את כל האפליקציות הלא מוכרות שעשויות לצלם את המסך או לשלוט במכשיר. אם המשתמש מקייש על הלחצן Close all, כל האפליקציות האלה נסגרות.

דוגמה לחוויית משתמש

CLOSE_ALL_ACCESS_RISK (קוד סוג 3)

בעיה בהכרעה

אם הערך של environmentDetails.appAccessRiskVerdict.appsDetected מכיל את הערכים "KNOWN_CAPTURING", ‏ "KNOWN_CONTROLLING",‏ "UNKNOWN_CAPTURING" או "UNKNOWN_CONTROLLING", פירוש הדבר שיש אפליקציות שפועלות במכשיר שיכולות לצלם את המסך או לשלוט במכשיר.

תיקון

אתם יכולים להציג את תיבת הדו-שיח CLOSE_ALL_ACCESS_RISK כדי לבקש מהמשתמש לסגור את כל האפליקציות שיכולות לצלם את המסך או לשלוט במכשיר. אם המשתמש יקיש על הלחצן Close all, כל האפליקציות האלה ייסגרו במכשיר.

דוגמה לחוויית משתמש

בקשה לתיבת דו-שיח של תקינות

כשהלקוח מבקש אסימון תקינות, אפשר להשתמש בשיטה שמציעים ב-StandardIntegrityToken (Standard API) וב-IntegrityTokenResponse (Classic API): showDialog(Activity activity, int integrityDialogTypeCode).

בשלבים הבאים מוסבר איך משתמשים ב-Play Integrity API כדי להציג את תיבת הדו-שיח GET_LICENSED:

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. (אופציונלי) מבקשים אסימון נוסף כדי להציג תיבת דו-שיח נוספת. אם שולחים בקשות רגילות, צריך לחמם שוב את ספק האסימונים כדי לקבל החלטה חדשה.