Esiti migliorati nei dispositivi Android 13 e versioni successive

Di recente abbiamo annunciato di aver rafforzato gli esiti dell'API Play Integrity per renderli più rapidi, più resilienti agli attacchi e più privati per gli utenti, oltre ad altri miglioramenti della sicurezza.

Riepilogo delle modifiche

Più avanti in questo documento puoi trovare un riepilogo dettagliato delle modifiche e delle domande frequenti. Le modifiche ai verdetti di maggio 2025 sono state le seguenti:

Cosa Che cosa è cambiato Impatto stimato* Quali dispositivi
Modifiche che interessano tutti gli sviluppatori che effettuano richieste API Play Integrity
Risposta dell'esito del dispositivo: meets-device-integrity È necessario un esito positivo dell'Avvio verificato supportato dalla crittografia hardware Impatto minimo perché l'API Play Integrity utilizza già indicatori sicuri con crittografia hardware su dispositivi Android 13 o versioni successive (~0,4%) Android 13 e versioni successive
Risposta di integrità dell'app: esito del riconoscimento dell'app Nessuna variazione Impatto minimo, che rispecchierà la variazione del verdetto del dispositivo (~0,4%) Android 13 e versioni successive
Risposta dei dettagli dell'account: esito della licenza di Play L'app richiedente deve essere installata o aggiornata da Google Play Lieve diminuzione delle risposte con licenza (~2,5%) Android 6 e versioni successive
Modifiche che interessano solo gli sviluppatori di Play Console e gli sviluppatori di Play SDK Console che utilizzano funzionalità facoltative
Risposta dell'esito del dispositivo: meets-basic-integrity È richiesta l'attestazione di chiavi della piattaforma Android, ma lo stato di avvio può essere verificato o non verificato Lieve diminuzione delle risposte di base (~0,4%) Android 13 e versioni successive
Risposta dell'esito del dispositivo: meets-strong-integrity Deve aver ricevuto un aggiornamento della sicurezza nell'ultimo anno Diminuzione delle risposte forti (~14,5%) Android 13 e versioni successive
Tutti gli indicatori facoltativi (ad eccezione degli attributi del dispositivo)** L'app richiedente deve essere installata o aggiornata da Google Play Diminuzione della percentuale di risposte che includono indicatori facoltativi (~7%) Android 13 e versioni successive

*Tutte le percentuali di impatto stimato menzionate in precedenza si basavano su medie e app diverse potrebbero aver registrato variazioni minori o maggiori a seconda delle installazioni attive.

**Gli indicatori facoltativi (ad eccezione degli attributi del dispositivo) sono: meets-basic-integrity, meets-strong-integrity, attività recente del dispositivo, richiamo del dispositivo (beta), stato di Play Protect e rischio di accesso alle app.

Domande frequenti

Panoramica

Che cos'è l'API Play Integrity?

L'API Play Integrity ti aiuta a valutare l'affidabilità dell'ambiente dell'app dell'utente ottenendo informazioni sul dispositivo, sull'app e sull'utente, in modo da poter rilevare e rispondere a potenziali abusi e attacchi.

Quali indicatori fornisce l'API Play Integrity?

L'API Play Integrity include l'identità dell'app richiedente, se l'app richiedente è stata installata da Google Play e se il dispositivo è un dispositivo Android certificato originale. Questi indicatori vengono forniti per impostazione predefinita. Puoi leggere questi indicatori sul server di backend della tua app e decidere se e come l'app deve rispondere. Gli sviluppatori di Google Play possono attivare la ricezione di indicatori aggiuntivi nelle installazioni di Play per visualizzare ancora più informazioni.

Che cos'è l'attestazione di chiavi della piattaforma Android?

L'attestazione di chiavi della piattaforma Android consente alle app di verificare lo stato del dispositivo e ottenere un segnale forte di integrità dell'avvio supportata dall'hardware. Dipende da una chiave fornita da Google nel keystore con crittografia hardware del dispositivo. L'API Play Integrity utilizza già l'attestazione di chiavi per ottenere indicatori di sicurezza basati sull'hardware su alcuni dispositivi e ora li integrerà in modo più approfondito su tutti i dispositivi con Android 13 o versioni successive.

Modifiche del verdetto

Quali modifiche sono state apportate agli esiti dell'API Play Integrity sui dispositivi Android 13 o versioni successive?

L'API Play Integrity ora richiede indicatori di sicurezza basati sull'hardware per tutti gli esiti relativi all'integrità:

  • L'esito del riconoscimento del dispositivo meets-device-integrity indica che il dispositivo su cui è in esecuzione l'app è un dispositivo Android originale e certificato. Questo verdetto richiede che il bootloader del dispositivo sia bloccato e che il sistema operativo Android caricato sia un'immagine del produttore del dispositivo certificata.
  • L'esito del riconoscimento del dispositivo meets-strong-integrity indica un dispositivo Android originale e certificato con un aggiornamento della sicurezza recente. Questo verdetto richiederà meets-device-integrity e aggiornamenti della sicurezza nell'ultimo anno per tutte le partizioni del dispositivo, tra cui una patch della partizione del sistema operativo Android e una patch della partizione del fornitore. Questa condizione potrebbe cambiare in futuro.
  • L'esito del riconoscimento del dispositivo meets-basic-integrity indica che il controllo è avvenuto su un dispositivo fisico Android. Il bootloader del dispositivo può essere bloccato o sbloccato e lo stato di avvio può essere verificato o non verificato. Potrebbe non essere certificato, nel qual caso Google non può fornire alcuna garanzia di sicurezza, privacy o compatibilità delle app e non può garantire che il dispositivo non agisca come proxy, ad esempio per un'istanza virtuale di Android. Ciò significa anche che i dispositivi rooted sono idonei a restituire meets-basic-integrity, purché sia presente l'attestazione di chiavi.

Queste modifiche non influiscono sull'API Play Integrity su Play Giochi su PC, che continuerà a restituire meets-virtual-integrity.

Perché gli esiti dell'API Play Integrity sono stati modificati sui dispositivi Android 13 o versioni successive?

L'API Play Integrity utilizzava parzialmente indicatori di sicurezza basati sull'hardware su Android 12 e versioni precedenti. Richiedendo la crittografia hardware su Android 13 e versioni successive, gli esiti dell'API Play Integrity sono più resilienti contro gli utenti malintenzionati, più efficienti per le app e più privati per gli utenti. Gli sviluppatori possono aspettarsi i seguenti miglioramenti sui dispositivi con Android 13 o versioni successive:

  • Riduzione di circa il 90% dei segnali del dispositivo che devono essere raccolti e valutati per generare l'esito predefinito sui server di Google. Gli indicatori facoltativi continueranno a richiedere la raccolta di indicatori aggiuntivi.
  • Miglioramento della latenza del verdetto fino all'80% per le richieste standard nel caso peggiore e fino all'80% per tutte le richieste classiche per ottenere il verdetto predefinito. Gli indicatori facoltativi possono aumentare la latenza.
  • Livello di affidabilità e supporto coerente per tutti i fattori di forma Android con attestazione di chiavi, inclusi dispositivi mobili, tablet, pieghevoli, TV, Auto, Wear OS e ChromeOS.
  • Una maggiore differenziazione tra ogni etichetta del dispositivo nell'esito del riconoscimento del dispositivo: meets-strong-integrity, meets-device-integrity e meets-basic-integrity.

L'esito dell'API Play Integrity su Play Giochi su PC non verrà modificato e sarà lo stesso su Android 12 e versioni precedenti e su Android 13 e versioni successive.

Come faccio ad aggiornare la logica di backend della mia app per gli esiti di integrità in modo da tenere conto della versione dell'SDK Android?

Se vuoi utilizzare una logica diversa sul server di backend della tua app in base alla versione dell'SDK Android, puoi utilizzare il nuovo campo degli attributi del dispositivo nell'esito. Ecco un esempio:

Kotlin

val deviceIntegrity =
  JSONObject(payload).getJSONObject("deviceIntegrity")
val sdkVersion =
  if (deviceIntegrity.has("deviceAttributes")) {
    deviceIntegrity.getJSONObject("deviceAttributes").getInt("sdkVersion")
  } else {
    0
  }

if (sdkVersion >= 30) {
  // Provide Android R+ specific experience to the user.
}

Java

JSONObject deviceIntegrity =
  new JSONObject(payload).getJSONObject("deviceIntegrity");
int sdkVersion =
  deviceIntegrity.has("deviceAttributes")
    ? deviceIntegrity.getJSONArray("deviceAttributes").getInt("sdkVersion")
    : 0;

if (sdkVersion >= 30) {
  // Provide Android R+ specific experience to the user.
}

Come posso utilizzare la vecchia definizione dell'etichetta meets-strong-integrity in tutte le versioni dell'SDK Android?

Puoi farlo aggiornando la logica di backend della tua app in modo che utilizzi meets-strong-integrity se si tratta di un dispositivo con Android 13 o versioni precedenti e meets-device-integrity se si tratta di un dispositivo con Android 13 o versioni successive utilizzando il nuovo campo degli attributi del dispositivo nell'esito che contiene la versione dell'SDK Android. Ecco un esempio:

Kotlin

val deviceRecognitionVerdict =
  if (deviceIntegrity.has("deviceRecognitionVerdict")) {
    deviceIntegrity.getJSONArray("deviceRecognitionVerdict").toString()
  } else {
    ""
  }

val deviceIntegrityToCheckFor =
  sdkVersion < 33 ? "MEETS_STRONG_INTEGRITY" : "MEETS_DEVICE_INTEGRITY";

if (deviceRecognitionVerdict.contains(deviceIntegrityToCheckFor)) {
  // Looks good!
}

Java

JSONObject deviceIntegrity =
  new JSONObject(payload).getJSONObject("deviceIntegrity");
String deviceRecognitionVerdict =
  deviceIntegrity.has("deviceRecognitionVerdict")
    ? deviceIntegrity.getJSONArray("deviceRecognitionVerdict").toString()
    : "";

String deviceIntegrityToCheckFor =
  sdkVersion < 33 ? "MEETS_STRONG_INTEGRITY" : "MEETS_DEVICE_INTEGRITY";

if (deviceRecognitionVerdict.contains(deviceIntegrityToCheckFor)) {
  // Looks good!
}

Poiché si tratta anche di un indicatore supportato dall'hardware, il campo degli attributi del dispositivo è più affidabile sui dispositivi con Android 13 e versioni successive.

Quali altre modifiche sono state apportate al verdetto?

Investiamo continuamente per rendere più affidabili gli indicatori esistenti nell'API Play Integrity e lanciamo periodicamente nuove funzionalità per aiutare gli sviluppatori ad affrontare le minacce emergenti e i nuovi casi d'uso. Altri miglioramenti che abbiamo apportato ai verdetti includono:

  • Risposta con licenza Play: per restituire una risposta con licenza Play, l'API Play Integrity ora richiede sempre che l'app richiedente sia installata o aggiornata da Google Play. In questo modo vengono risolti alcuni casi limite e la risposta è più facile da interpretare per gli sviluppatori.
  • Disponibilità degli indicatori facoltativi: tutti gli indicatori facoltativi disponibili per gli sviluppatori che utilizzano Google Play Console o Play SDK Console (ad eccezione degli attributi del dispositivo) ora richiedono l'installazione o l'aggiornamento dell'app richiedente da Google Play su Android 13 o versioni successive. Sono inclusi meets-strong-integrity, meets-basic-integrity, l'attività del dispositivo recente, il richiamo del dispositivo (beta), l'esito del rischio di accesso all'app e l'esito di Play Protect. Abbiamo standardizzato tutte le altre richieste dell'API Play Integrity per ricevere il controllo del dispositivo (solo con l'etichetta meets-device-integrity), il controllo del programma di installazione, il controllo dell'integrità dell'app e gli attributi del dispositivo (se attivati).
  • Modifiche agli esiti per dispositivi specifici: l'API Play Integrity sta modificando automaticamente gli esiti dei dispositivi in più scenari per proteggere le app prima in tutte le versioni dell'SDK Android, ad esempio quando ci sono prove di attività eccessiva o compromissione delle chiavi. Ciò include la possibilità per Play di utilizzare altri indicatori per generare esiti temporanei dei dispositivi per gli utenti quando non sono disponibili indicatori supportati da hardware. Consigliamo agli sviluppatori di utilizzare le finestre di dialogo di correzione in-app di Google Play o di indirizzare gli utenti all'app Play Store per risolvere i problemi relativi all'esito di integrità. Con il tempo, queste finestre di dialogo gestiranno più scenari e includeranno indicazioni specifiche per gli utenti, indicando loro cosa devono correggere in base al loro dispositivo o account specifico.

Come faccio a segnalare problemi relativi agli esiti di integrità?

Per segnalare problemi relativi alle risposte dell'API Play Integrity, indipendentemente dal fatto che il problema riguardi gli esiti storici o quelli nuovi, segui le istruzioni riportate nella pagina di assistenza.

Disponibilità

Cosa richiede l'API Play Integrity per funzionare?

L'API Play Integrity richiede che il Google Play Store e Google Play Services siano installati su un dispositivo, inclusi i dispositivi Android e Google Play Giochi per PC. Le richieste classiche richiedono Android 4.4 (livello API 19) o versioni successive, mentre le richieste standard richiedono Android 5.0 (livello API 21) o versioni successive. Sui dispositivi con Android 13 (livello API 33) e versioni successive, l'API Play Integrity ora avrà lo stesso livello di affidabilità e supporto su tutti i fattori di forma Android con attestazione di chiavi, inclusi dispositivi mobili, tablet, pieghevoli, TV, Auto, Wear OS e ChromeOS.

Perché l'API Play Integrity ha esiti diversi per dispositivi diversi?

L'API Play Integrity fornisce più esiti relativi ai dispositivi per soddisfare le esigenze degli sviluppatori con diversi casi d'uso e tolleranze al rischio e per consentire una strategia di applicazione forzata a più livelli. Ad esempio, quando l'app e il dispositivo sono più attendibili, uno sviluppatore potrebbe semplificare i passaggi di verifica dell'utente, mentre quando un dispositivo è sconosciuto, lo sviluppatore potrebbe richiedere un'ulteriore verifica dell'utente prima di eseguire azioni protette o sensibili. Questo può essere un modo efficace per ridurre abusi e attacchi.

Che cos'è un dispositivo Android certificato?

Un dispositivo Android certificato (noto anche come dispositivo Android con certificazione Play Protect) è un dispositivo che esegue un software prevedibile che ha superato centinaia di test di compatibilità di Google, rispetta il modello di autorizzazioni e sicurezza di Android e viene fornito con la suite di funzionalità antimalware di Google Play Protect. Quando l'API Play Integrity è in grado di verificare che un dispositivo è un dispositivo Android originale e certificato, restituisce la risposta meets-device-integrity nell'esito del riconoscimento del dispositivo.

Che cos'è un dispositivo meets-basic-integrity?

L'API Play Integrity restituisce anche una risposta facoltativa nell'esito relativo al dispositivo, meets-basic-integrity. Se un dispositivo restituisce solo l'esito meets-basic-integrity senza meets-device-integrity o meets-strong-integrity, significa che il sistema operativo Android non può essere verificato, ma è presente l'attestazione di chiavi. Ciò indica che il controllo è stato eseguito su un dispositivo fisico con tecnologia Android, ma Google non può fornire garanzie in merito alla sicurezza, alla privacy o alla compatibilità delle app del dispositivo e non può garantire che il dispositivo non agisca come proxy, ad esempio per un'istanza virtuale di Android. A seconda dei casi d'uso e delle tolleranze al rischio, gli sviluppatori possono decidere come vogliono che la loro app venga eseguita su questi dispositivi.

Qualsiasi sviluppatore può utilizzare l'API Play Integrity?

Sì, qualsiasi sviluppatore Android può effettuare richieste API Play Integrity per ricevere gli esiti di integrità predefiniti. L'utilizzo è limitato a 10.000 richieste al giorno, indipendentemente dal canale di distribuzione. Gli sviluppatori che pubblicano le loro app su Google Play oltre che su eventuali altri canali di distribuzione possono anche richiedere di aumentare la loro quota giornaliera.

Qualsiasi sviluppatore può utilizzare l'attestazione di chiavi della piattaforma Android?

Sì, qualsiasi sviluppatore Android può utilizzare l'attestazione di chiavi della piattaforma Android per ottenere un record di attestazione di chiavi, che può verificare con il certificato pubblico della chiave root di attestazione di Google. L'API Play Integrity offre agli sviluppatori i vantaggi dell'attestazione di chiavi e funzionalità aggiuntive senza la complessità di dover integrare l'attestazione di chiavi in autonomia.

Applicazione

In che modo gli sviluppatori utilizzano gli esiti dell'API Play Integrity?

Spetta agli sviluppatori decidere se e come utilizzare gli esiti dell'API Play Integrity. Alcuni sviluppatori raccolgono gli indicatori per l'analisi interna anti-abuso, mentre altri prendono decisioni sul comportamento della loro app in base all'esito. Ad esempio, gli sviluppatori potrebbero decidere di richiedere che i dispositivi meno attendibili eseguano ulteriori passaggi di verifica dell'utente durante la creazione di un account oppure potrebbero decidere che i dispositivi meno attendibili debbano giocare insieme sullo stesso server multiplayer.

L'API Play Integrity blocca utenti o dispositivi?

No, l'API Play Integrity non blocca l'accesso ad alcuna funzionalità. Si tratta di un servizio facoltativo per gli sviluppatori che fornisce indicatori e gli sviluppatori scelgono come agire in base a questi indicatori.

Cosa devono fare gli utenti se il loro dispositivo non supera i controlli dell'API Play Integrity?

Gli utenti possono andare all'app Play Store sul proprio dispositivo, aprire il menu Impostazioni, selezionare Informazioni e poi cercare in Certificazione Play Protect. Se si verifica un problema con la certificazione Play Protect del dispositivo, gli utenti possono premere un pulsante per provare a risolverlo. In questo modo, lo stato di certificazione del dispositivo verrà aggiornato e verranno fornite indicazioni specifiche su cosa deve essere corretto.