Bu sayfada, bütünlük kararlarıyla ilgili sorunların nasıl giderileceği açıklanmaktadır.
Bütünlük jetonu istendikten sonra kullanıcıya Google Play iletişim kutusu gösterebilirsiniz. Bütünlük değerlendirmesiyle ilgili bir veya daha fazla sorun olduğunda ya da Integrity API isteği sırasında bir istisna oluştuğunda iletişim kutusunu gösterebilirsiniz. İletişim kapatıldıktan sonra başka bir bütünlük jetonu isteği göndererek sorunun düzeltildiğini doğrulayabilirsiniz. Standart istekler gönderiyorsanız yeni bir karar almak için jeton sağlayıcıyı tekrar hazırlamanız gerekir.
Karar sorununu düzeltmek için bütünlük iletişim kutusu isteme
İstemci bir bütünlük jetonu istediğinde StandardIntegrityToken (Standart API) ve IntegrityTokenResponse (Klasik API) tarafından sunulan yöntemi kullanabilirsiniz:
showDialog(Activity activity, int integrityDialogTypeCode).
Aşağıdaki adımlarda, GET_LICENSED iletişim kutusu kodunu kullanarak düzeltme iletişim kutusu göstermek için Play Integrity API'yi nasıl kullanabileceğiniz açıklanmaktadır.
Uygulamanızın isteyebileceği diğer iletişim kutusu kodları bu bölümden sonra listelenir.
Uygulamanızdan bütünlük jetonu isteyin ve jetonu sunucunuza gönderin. Standart veya klasik isteği kullanabilirsiniz.
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);Unreal Engine
// Request an integrity token StandardIntegrityToken* Response = RequestIntegrityToken(); // Send token to app server and get response on what to do next YourServerResponse YourServerResponse = SendToServer(Response->Token);Yerel
/// 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));Sunucunuzda bütünlük jetonunun şifresini çözün ve
appLicensingVerdictalanını kontrol edin. Şöyle bir şey olabilir:// Licensing issue { ... "accountDetails": { "appLicensingVerdict": "UNLICENSED" } }Jeton
appLicensingVerdict: "UNLICENSED"içeriyorsa uygulama istemcinize yanıt vererek lisanslama iletişim kutusunu göstermesini isteyin: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; }Unreal Engine
private int GetDialogTypeCode(FString IntegrityToken) { // Get licensing verdict from decrypted and verified integrityToken FString LicensingVerdict = GetLicensingVerdictFromDecryptedToken(IntegrityToken); if (LicensingVerdict == "UNLICENSED") { return 1; // GET_LICENSED } return 0; }Yerel
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; }Uygulamanızda, sunucunuzdan alınan istenen kodla
showDialogyöntemini çağırın:Kotlin
// Show dialog as indicated by the server val showDialogType: Int? = yourServerResponse.integrityDialogTypeCode() if (showDialogType == null) { return } // Create dialog request val dialogRequest = StandardIntegrityDialogRequest.builder() .setActivity(activity) .setTypeCode(showDialogType) .setStandardIntegrityResponse(StandardIntegrityResponse.TokenResponse(token)) .build() // Call showDialog, the dialog will be shown on top of the provided activity // and the task will complete when the dialog is closed. val result: Task<Int> = standardIntegrityManager.showDialog(dialogRequest) // Handle response code, call the Integrity API again to confirm that the // verdict issue has been resolved.Java
// Show dialog as indicated by the server @Nullable Integer showDialogType = yourServerResponse.integrityDialogTypeCode(); if (showDialogType == null) { return; } // Create dialog request StandardIntegrityDialogRequest dialogRequest = StandardIntegrityDialogRequest.builder() .setActivity(getActivity()) .setTypeCode(showDialogTypeCode) .setStandardIntegrityResponse(new StandardIntegrityResponse.TokenResponse(token)) .build(); // Call showDialog, the dialog will be shown on top of the provided activity // and the task will complete when the dialog is closed. Task<Integer> result = standardIntegrityManager.showDialog(dialogRequest); // Handle response code, call the Integrity API again to confirm that the // verdict issue has been resolved.Unity
// Initialize the V2 manager. Requires Play Integrity Unity Plugin v2.0.0 or // higher. var standardIntegrityManager = new StandardIntegrityManagerV2(); IEnumerator ShowDialogCoroutine() { int showDialogType = yourServerResponse.IntegrityDialogTypeCode(); PlayAsyncOperation<IntegrityDialogResponseCode, StandardIntegrityError> showDialogTask; using (var activity = UnityPlayerHelper.GetCurrentActivity()) { // Create a dialog request var dialogRequest = new StandardIntegrityDialogRequest(tokenResponse, activity, showDialogType); // Call showDialog with the request, the dialog will be shown on top of the // provided activity and complete when the dialog is closed. showDialogTask = standardIntegrityManager.ShowDialog(dialogRequest); } // Wait for PlayAsyncOperation to complete. yield return showDialogTask; // Handle response code, call the Integrity API again to confirm that the // verdict issue been resolved. }Unreal Engine
// .h void MyClass::OnShowDialogCompleted( EStandardIntegrityErrorCode Error, EIntegrityDialogResponseCode Response) { // Handle response code, call the Integrity API again to confirm that the // verdict issue has been resolved. } // .cpp void MyClass::RequestIntegrityToken() { UStandardIntegrityToken* Response = ... int TypeCode = YourServerResponse.integrityDialogTypeCode(); // Create a delegate to bind the callback function. FShowDialogStandardOperationCompletedDelegate Delegate; // Bind the completion handler (OnShowDialogCompleted) to the delegate. Delegate.BindDynamic(this, &MyClass::OnShowDialogCompleted); // Call ShowDialog with TypeCode which completes when the dialog is closed. Response->ShowDialog(TypeCode, Delegate); }Yerel
// Show dialog as indicated by the server int show_dialog_type = yourServerResponse.integrityDialogTypeCode(); if(show_dialog_type == 0){ return; } /// Create dialog request StandardIntegrityDialogRequest* dialog_request; StandardIntegrityDialogRequest_create(&dialog_request); StandardIntegrityDialogRequest_setTypeCode(dialog_request, show_dialog_type); StandardIntegrityDialogRequest_setActivity(dialog_request, activity); StandardIntegrityDialogRequest_setStandardIntegrityToken(dialog_request, token_response); /// Call showDialog with the dialog request. The dialog will be shown on top /// of the provided activity and complete when the dialog is closed by the /// user. StandardIntegrityDialogResponse* dialog_response; StandardIntegrityErrorCode error_code = StandardIntegrityManager_showDialog(dialog_request, &dialog_response); /// Use polling to wait for the async operation to complete. Note, the polling /// shouldn't block the thread where the StandardIntegrityManager is running. IntegrityDialogResponseCode response_code = INTEGRITY_DIALOG_RESPONSE_UNKNOWN; while (error_code == STANDARD_INTEGRITY_NO_ERROR) { error_code = StandardIntegrityDialogResponse_getResponseCode(dialog_response, &response_code); if(response_code != INTEGRITY_DIALOG_RESPONSE_UNKNOWN){ break; } } /// Free memory StandardIntegrityDialogRequest_destroy(dialog_request); StandardIntegrityDialogResponse_destroy(dialog_response); /// Handle response code, call the Integrity API again to confirm that the /// verdict issues have been resolved.İletişim kutusu, sağlanan etkinliğin üst kısmında gösterilir. Kullanıcı iletişim kutusunu kapattığında görev, bir yanıt kodu ile tamamlanır.
(İsteğe bağlı) Başka iletişim kutuları görüntülemek için başka bir jeton isteyin. Standart isteklerde bulunuyorsanız yeni bir değerlendirme almak için jeton sağlayıcıyı tekrar hazırlamanız gerekir.
İstemci tarafı istisnasını düzeltmek için bütünlük iletişim kutusu isteğinde bulunma
Bir Integrity API isteği StandardIntegrityException (Standart API) veya IntegrityServiceException (Klasik API) ile başarısız olursa ve istisna düzeltilebilirse hatayı düzeltmek için GET_INTEGRITY veya GET_STRONG_INTEGRITY iletişim kutularını kullanabilirsiniz.
Aşağıdaki adımlarda, Integrity API tarafından bildirilen ve düzeltilebilir bir istemci tarafı hatasını düzeltmek için GET_INTEGRITY iletişim kutusunu nasıl kullanabileceğiniz açıklanmaktadır.
Integrity API isteğinden döndürülen istisnanın düzeltilebilir olup olmadığını kontrol edin.
Kotlin
private fun isExceptionRemediable(exception: ExecutionException): Boolean { val cause = exception.cause if (cause is StandardIntegrityException && cause.isRemediable) { return true } return false }Java
private boolean isExceptionRemediable(ExecutionException exception) { Throwable cause = exception.getCause(); if (cause instanceof StandardIntegrityException integrityException && integrityException.isRemediable()) { return true; } return false; }Unity
private bool IsExceptionRemediable(StandardIntegrityError error) { // Check if the operation resulted in a remediable error if (error != null && error.ErrorCode != StandardIntegrityErrorCode.NoError && error.IsRemediable) { return true; } return false; }Yerel
bool IsErrorRemediable(StandardIntegrityToken* token) { /// Check if the error associated with the token is remediable bool isRemediable = false; if(StandardIntegrityToken_getIsRemediable(response, &isRemediable) == STANDARD_INTEGRITY_NO_ERROR){ return isRemediable; } return false; }İstisna düzeltilebiliyorsa döndürülen istisnayı kullanarak
GET_INTEGRITYiletişim kutusunu isteyin. İletişim kutusu, sağlanan etkinliğin üzerinde gösterilir ve döndürülen görev, kullanıcı iletişim kutusunu kapattıktan sonra bir yanıt kodu ile tamamlanır.Kotlin
private fun showDialog(exception: StandardIntegrityException) { // Create a dialog request val standardIntegrityDialogRequest = StandardIntegrityDialogRequest.builder() .setActivity(activity) .setType(IntegrityDialogTypeCode.GET_INTEGRITY) .setStandardIntegrityResponse(ExceptionDetails(exception)) .build() // Request dialog val responseCode: Task<Int> = standardIntegrityManager.showDialog(standardIntegrityDialogRequest) }Java
private void showDialog(StandardIntegrityException exception) { // Create a dialog request StandardIntegrityDialogRequest standardIntegrityDialogRequest = StandardIntegrityDialogRequest.builder() .setActivity(this.activity) .setType(IntegrityDialogTypeCode.GET_INTEGRITY) .setStandardIntegrityResponse(new ExceptionDetails(exception)) .build(); // Request dialog Task<Integer> responseCode = standardIntegrityManager.showDialog(standardIntegrityDialogRequest); }Unity
// Initialize the V2 manager. Requires Play Integrity Unity Plugin v2.0.0 or // higher. var standardIntegrityManager = new StandardIntegrityManagerV2(); IEnumerator ShowDialogToFixError(StandardIntegrityError error) { PlayAsyncOperation<IntegrityDialogResponseCode, StandardIntegrityError> showDialogTask; using (var activity = UnityPlayerHelper.GetCurrentActivity()) { // Create a dialog request using the error var dialogRequest = new StandardIntegrityDialogRequest(error, activity, GET_INTEGRITY_DIALOG); // Request dialog showDialogTask = standardIntegrityManager.ShowDialog(dialogRequest); } // Wait for PlayAsyncOperation to complete. yield return showDialogTask; }Yerel
private void showDialogToFixError(StandardIntegrityToken* token) { /// If the token request failed, and the underlying error is not fixable /// then return early if(isErrorRemediable(token)) { return; } /// Create dialog request StandardIntegrityDialogRequest* dialog_request; StandardIntegrityDialogRequest_create(&dialog_request); StandardIntegrityDialogRequest_setTypeCode(dialog_request, kGetIntegrityDialogTypeCode); StandardIntegrityDialogRequest_setActivity(dialog_request, activity); StandardIntegrityDialogRequest_setStandardIntegrityToken(dialog_request, token_response); /// Call showDialog with the dialog request. The dialog will be shown on /// top of the provided activity and complete when the dialog is closed by /// the user. StandardIntegrityDialogResponse* dialog_response; StandardIntegrityErrorCode error_code = StandardIntegrityManager_showDialog(dialog_request, &dialog_response); /// Use polling to wait for the async operation to complete. /// Note, the polling shouldn't block the thread where the /// StandardIntegrityManager is running. IntegrityDialogResponseCode response_code = INTEGRITY_DIALOG_RESPONSE_UNKNOWN; while (error_code == STANDARD_INTEGRITY_NO_ERROR) { error_code = StandardIntegrityDialogResponse_getResponseCode(response, &response_code); if(response_code != INTEGRITY_DIALOG_RESPONSE_UNKNOWN){ break; } } /// Free memory StandardIntegrityDialogRequest_destroy(dialog_request); StandardIntegrityDialogResponse_destroy(dialog_response); }Döndürülen yanıt kodu başarılı olduğunu gösteriyorsa bütünlük jetonu için bir sonraki istek herhangi bir istisna olmadan başarılı olur. Standart istekler gönderiyorsanız yeni bir karar almak için jeton sağlayıcıyı tekrar hazırlamanız gerekir.
Bütünlük iletişim kutusu kodları
GET_LICENSED (Tür Kodu 1)
Karar sorunu
Bu iletişim kutusu iki sorun için uygundur:
- Yetkisiz erişim:
appLicensingVerdict: "UNLICENSED". Bu, kullanıcı hesabının uygulamanız için yararlanma hakkına sahip olmadığı anlamına gelir. Bu durum, kullanıcı uygulamayı başka bir kaynaktan yüklediyse veya Google Play dışında bir uygulama mağazasından edindiyse ortaya çıkabilir. - Kurcalanmış uygulama:
appRecognitionVerdict: "UNRECOGNIZED_VERSION". Bu, uygulamanızın ikili programının değiştirildiği veya Google Play tarafından tanınan bir sürüm olmadığı anlamına gelir.
Düzeltme
Kullanıcıdan orijinal uygulamayı Google Play'den edinmesini istemek için GET_LICENSED iletişim kutusunu gösterebilirsiniz. Bu tek iletişim kutusu her iki senaryoyu da ele alır:
- Lisanssız kullanıcılar için Play lisansı verir. Bu sayede kullanıcı, Google Play'den uygulama güncellemeleri alabilir.
- Uygulama sürümü kurcalanmış olan kullanıcıları, değiştirilmemiş uygulamayı Google Play'den yüklemeye yönlendirir.
Kullanıcı iletişim kutusunu tamamladığında sonraki bütünlük kontrolleri appLicensingVerdict: "LICENSED" ve appRecognitionVerdict: "PLAY_RECOGNIZED" değerini döndürür.
Örnek kullanıcı deneyimi
CLOSE_UNKNOWN_ACCESS_RISK (Tür Kodu 2)
Karar sorunu
environmentDetails.appAccessRiskVerdict.appsDetected, "UNKNOWN_CAPTURING" veya "UNKNOWN_CONTROLLING" içeriyorsa cihazda ekranı kaydedebilecek ya da cihazı kontrol edebilecek başka uygulamalar (Google Play tarafından yüklenmemiş veya cihaz üreticisi tarafından sistem bölümüne önceden yüklenmemiş) çalışıyor demektir.
Düzeltme
Kullanıcıdan ekranı kaydediyor veya cihazı kontrol ediyor olabilecek tüm bilinmeyen uygulamaları kapatmasını istemek için CLOSE_UNKNOWN_ACCESS_RISK iletişim kutusunu gösterebilirsiniz.
Kullanıcı Close all düğmesine dokunursa bu tür uygulamaların tümü kapatılır.
Örnek kullanıcı deneyimi
CLOSE_ALL_ACCESS_RISK (Tür Kodu 3)
Karar sorunu
environmentDetails.appAccessRiskVerdict.appsDetected; "KNOWN_CAPTURING", "KNOWN_CONTROLLING", "UNKNOWN_CAPTURING" veya "UNKNOWN_CONTROLLING" değerlerinden herhangi birini içeriyorsa cihazda ekranı kaydedebilecek veya cihazı kontrol edebilecek uygulamalar çalışıyor demektir.
Düzeltme
Kullanıcıdan ekranı kaydediyor veya cihazı kontrol ediyor olabilecek tüm uygulamaları kapatmasını istemek için CLOSE_ALL_ACCESS_RISK iletişim kutusunu gösterebilirsiniz. Kullanıcı Close all düğmesine dokunursa bu tür tüm uygulamalar cihazda kapatılır.
Örnek kullanıcı deneyimi
GET_INTEGRITY (Tür Kodu 4)
Karar sorunu
Bu iletişim kutusu, aşağıdaki sorunlardan herhangi biri için uygundur:
Zayıf cihaz bütünlüğü:
deviceRecognitionVerdict,MEETS_DEVICE_INTEGRITYdeğerini içermediğinde cihaz, orijinal ve sertifikalı bir Android cihaz olmayabilir. Örneğin, cihazın bootloader'ının kilidi açılmışsa veya yüklü Android OS'i sertifikalı bir üretici görüntüsü değilse bu durum yaşanabilir.Yetkisiz erişim:
appLicensingVerdict: "UNLICENSED". Bu, kullanıcı hesabının uygulamanız için yararlanma hakkına sahip olmadığı anlamına gelir. Bu durum, kullanıcı uygulamayı başka bir kaynaktan yüklediyse veya Google Play dışında bir uygulama mağazasından edindiyse ortaya çıkabilir.Kurcalanmış uygulama:
appRecognitionVerdict: "UNRECOGNIZED_VERSION". Bu, uygulamanızın ikili programının değiştirildiği veya Google Play tarafından tanınan bir sürüm olmadığı anlamına gelir.İstemci tarafı istisnalar: Integrity API isteği sırasında düzeltilebilir bir istisna oluştuğunda. Düzeltilebilir istisnalar,
PLAY_SERVICES_VERSION_OUTDATED,NETWORK_ERROR,PLAY_SERVICES_NOT_FOUNDgibi hata kodları içeren Integrity API istisnalarıdır. Bir istisnanın iletişim kutusu tarafından düzeltilip düzeltilemeyeceğini kontrol etmek içinexception.isRemediable()yöntemini kullanabilirsiniz.
Düzeltme
GET_INTEGRITY iletişim kutusu, birden fazla düzeltme adımını tek bir sürekli akışta işleyerek kullanıcının deneyimini kolaylaştırmak için tasarlanmıştır. Bu sayede kullanıcı, farklı sorunları düzeltmek için birden fazla ayrı iletişim kutusuyla etkileşimde bulunmak zorunda kalmaz.
İletişim kutusunu istediğinizde, hedeflenen karar sorunlarından hangilerinin mevcut olduğunu otomatik olarak algılar ve uygun düzeltme adımlarını sağlar. Bu sayede tek bir iletişim isteğiyle aynı anda birden fazla sorunu çözebilirsiniz. Örneğin:
- Cihaz bütünlüğü: Cihaz bütünlüğüyle ilgili bir sorun tespit edilirse iletişim kutusu, kullanıcıyı cihazın güvenlik durumunu iyileştirerek
MEETS_DEVICE_INTEGRITYdeğerlendirmesi için gereken şartları karşılamaya yönlendirir. - Uygulama bütünlüğü: Yetkisiz erişim veya uygulama üzerinde oynama gibi sorunlar tespit edilirse iletişim kutusu, kullanıcıları bu sorunları düzeltmek için uygulamayı Google Play Store'dan indirmeye yönlendirir.
- İstemci tarafı istisnalar: İletişim kutusu, Integrity API istisnasına neden olan temel sorunları kontrol eder ve çözmeye çalışır. Örneğin, kullanıcıdan Google Play Hizmetleri'nin eski bir sürümünü güncellemesini isteyebilir.
Örnek kullanıcı deneyimi
GET_STRONG_INTEGRITY (Tür Kodu 5)
Karar sorunu
Bu iletişim kutusu, GET_INTEGRITY'nin ele aldığı tüm sorunları düzeltmek için tasarlanmıştır. Ayrıca, cihazın MEETS_STRONG_INTEGRITY kararı almasını engelleyen sorunları ve Google Play Protect kararı sorunlarını düzeltme özelliğine de sahiptir.
Düzeltme
GET_STRONG_INTEGRITY, birden fazla düzeltme adımını tek bir sürekli akışta işleyerek kullanıcı deneyimini kolaylaştırmak için tasarlanmıştır. İletişim kutusu, aşağıdakiler de dahil olmak üzere bütünlük sorunları için geçerli bir adresi otomatik olarak kontrol eder:
- Cihaz bütünlüğü: Cihaz bütünlüğüyle ilgili bir sorun tespit edilirse iletişim kutusu, kullanıcıyı cihazın güvenlik durumunu iyileştirerek
MEETS_STRONG_INTEGRITYdeğerlendirmesi için gereken şartları karşılamaya yönlendirir. Play Protect durumu:
playProtectVerdictbir sorun olduğunu gösteriyorsa iletişim kutusu, kullanıcıyı sorunu düzeltmeye yönlendirir:- Play Protect devre dışıysa (
playProtectVerdict == POSSIBLE_RISK) iletişim kutusu, kullanıcıdan Play Protect'i etkinleştirmesini ve cihazdaki tüm uygulamaları taramasını ister. - Zararlı uygulamalar (
playProtectVerdict == MEDIUM_RISKveyaHIGH_RISK) tespit edilirse iletişim kutusu, kullanıcıyı Google Play Protect'i kullanarak bu uygulamaları kaldırmaya yönlendirir.
- Play Protect devre dışıysa (
Uygulama bütünlüğü: Yetkisiz erişim veya uygulamada değişiklik yapma gibi sorunlar tespit edilirse iletişim kutusu, kullanıcıdan sorunu düzeltmek için uygulamayı Google Play Store'dan edinmesini ister.
İstemci tarafı istisnaları: İletişim kutusu, Integrity API istisnasına neden olan temel sorunları da çözmeye çalışır. Örneğin, Google Play Hizmetleri devre dışı bırakılmışsa kullanıcıdan bu hizmetleri etkinleştirmesini isteyebilir. Düzeltilebilir istisnalar,
PLAY_SERVICES_VERSION_OUTDATED,NETWORK_ERRORveyaPLAY_SERVICES_NOT_FOUNDgibi hata kodları içeren Integrity API istisnalarıdır. Bir hatanın iletişim kutusu tarafından düzeltilip düzeltilemeyeceğini kontrol etmek içinexception.isRemediable()yöntemini kullanabilirsiniz.
Örnek kullanıcı deneyimi