Rilevare comportamenti illeciti ripetuti utilizzando il richiamo del dispositivo (beta)

Questa pagina descrive come utilizzare il richiamo del dispositivo per archiviare e recuperare dati personalizzati con dispositivi specifici. Puoi richiamare in modo affidabile i dati personalizzati in un secondo momento quando la tua app viene installata sullo stesso dispositivo, anche dopo il ripristino del dispositivo. In questo modo puoi rilevare e impedire il riutilizzo di un dispositivo in base a un'azione o un comportamento che specifichi, preservando al contempo la privacy dell'utente.

Come funziona il richiamo del dispositivo?

Il richiamo del dispositivo consente alle app di memorizzare e richiamare dati personalizzati associati a un dispositivo specifico in modo da preservare la privacy dell'utente. I dati vengono archiviati sui server di Google, consentendo all'app di richiamare in modo affidabile i dati personalizzati anche dopo la reinstallazione dell'app o il ripristino del dispositivo. Ad esempio, potresti utilizzare la funzionalità per richiamare i dispositivi su cui hai trovato prove di gravi abusi, i dispositivi che hanno già utilizzato articoli di valore elevato (come una prova senza costi) o i dispositivi che vengono utilizzati ripetutamente per creare nuovi account per scopi illeciti. Il richiamo del dispositivo preserva la privacy dell'utente perché l'app richiedente può recuperare solo i dati limitati che ha associato ai dispositivi, senza accedere a identificatori di dispositivi o utenti. Dopo aver attivato il richiamo del dispositivo, puoi:

  • Leggi i dati per dispositivo: puoi leggere tre valori o bit personalizzati per ogni dispositivo quando ottieni un esito di integrità. Puoi definire il significato di questi valori. Ad esempio, puoi trattarli come tre flag separati o combinarli per rappresentare otto etichette personalizzate.
  • Modifica i dati per dispositivo: dopo aver ottenuto un token di integrità, puoi utilizzarlo per effettuare una chiamata lato server al server di Google Play per modificare uno o più valori. Hai fino a 14 giorni di tempo per utilizzare il token. In questo modo, puoi modificare un valore se, ad esempio, l'abuso diventa evidente solo nel periodo di due settimane successivo alla prima esecuzione di un controllo di integrità. Quando modifichi un valore, vengono memorizzati anche il mese e l'anno in cui è stata apportata la modifica.

Prerequisiti e considerazioni per il richiamo del dispositivo

Il richiamo del dispositivo può essere utilizzato solo per archiviare e richiamare informazioni per proteggere la sicurezza dell'app e mitigare abusi, attività fraudolente e accessi non autorizzati. Non puoi utilizzare il richiamo del dispositivo per eseguire il fingerprinting o il monitoraggio di singoli utenti o dispositivi e non puoi utilizzarlo per tenere traccia di caratteristiche sensibili degli utenti o dei dispositivi, come genere, età o dati sulla posizione.

Il richiamo del dispositivo prevede i seguenti prerequisiti:

  • Il richiamo del dispositivo può essere utilizzato su smartphone, tablet, pieghevoli, TV, Auto e Wear OS. Su Wear, il richiamo del dispositivo è disponibile solo sui dispositivi con Wear OS 5 o versioni successive. Il richiamo del dispositivo non è supportato sugli emulatori.
  • Il richiamo del dispositivo richiede che sul dispositivo siano installate e attivate le versioni recenti di Google Play Store e Google Play Services.
  • Il richiamo del dispositivo richiede che l'account utente disponga di una licenza Play, altrimenti l'esito non verrà valutato.

Il richiamo del dispositivo presenta le seguenti considerazioni relative alle tempistiche:

  • Dopo aver verificato un token di integrità, hai fino a 14 giorni di tempo per utilizzarlo per archiviare i dati di richiamo del dispositivo personalizzati.
  • Il richiamo del dispositivo include i timestamp, in modo da poter considerare i dati modificati di recente come prioritari rispetto a quelli modificati molto tempo fa. Valuta la possibilità di ignorare o reimpostare i dati dopo un periodo di tempo sufficientemente lungo per tenere conto del fatto che i dispositivi possono cambiare proprietario o essere ricondizionati e rivenduti.
  • I bit di richiamo di un dispositivo verranno archiviati per 3 anni dall'ultimo accesso in lettura o scrittura.
  • Se devi eliminare tutti i dati associati a un dispositivo, la tua app può reimpostare tutti e tre i valori su false su quel dispositivo. In questo modo, i timestamp verranno reimpostati automaticamente.

Per gli sviluppatori con più app e per gli sviluppatori che trasferiscono app, il richiamo del dispositivo funziona come segue:

  • Tutte le app nel tuo account sviluppatore Google Play hanno accesso agli stessi tre valori per dispositivo. In altre parole, se una delle tue app modifica uno dei valori, tutte le tue app leggeranno il valore modificato quando vengono installate sullo stesso dispositivo.
  • Se un'app viene trasferita da un account sviluppatore a un altro, il richiamo del dispositivo rifletterà i dati per dispositivo del nuovo account sviluppatore, non quelli del vecchio account sviluppatore.

Attiva il richiamo del dispositivo

Quando è tutto pronto, attiva il richiamo del dispositivo in Play Console:

  1. Accedi a Play Console.
  2. Seleziona l'app che utilizzerà il richiamo del dispositivo.
  3. Vai a Protetto con Play dal menu a sinistra.
  4. Accanto all'API Play Integrity, fai clic su Gestisci.
  5. Nella sezione Risposte della pagina, fai clic su Modifica risposte.
  6. Attiva il richiamo del dispositivo.
  7. Fai clic su Salva modifiche.

Quando attivi o disattivi il richiamo del dispositivo, tutte le risposte di test dell'API Play Integrity che hai configurato in Play Console verranno eliminate e dovrai crearle di nuovo.

Leggi i valori di richiamo del dispositivo

Il richiamo del dispositivo funziona sia con le richieste API Play Integrity classiche sia con quelle standard. Nelle richieste standard, il richiamo del dispositivo viene aggiornato nella chiamata di warmup. In altre parole, dopo aver modificato i dati per dispositivo, dovrai eseguire un altro warm up per visualizzare il valore aggiornato. Una volta attivato il richiamo del dispositivo, potrai leggere i valori di richiamo del dispositivo negli esiti sull'integrità.

Modifica i valori di richiamo del dispositivo

Puoi modificare i valori di richiamo del dispositivo effettuando una chiamata API da server a server simile alla decodifica dell'esito di integrità. L'impostazione di un bit su true aggiornerà anche la data di scrittura (anche se era già true). L'impostazione di un bit su false reimposta la data di scrittura su vuota. I bit non specificati in una richiesta rimarranno invariati. Esiste un piccolo ritardo di propagazione tra la scrittura dei bit e la possibilità di leggerli nel verdetto. Questo ritardo può durare fino a 30 secondi, anche se in genere è molto più breve. Le richieste di scrittura del richiamo del dispositivo devono essere meno frequenti delle richieste di token di integrità. Non vengono conteggiate ai fini della quota di richieste di token di integrità, ma sono soggette a limiti di frequenza separati.

playintegrity.googleapis.com/v1/PACKAGE_NAME/deviceRecall:write -d \
'{
  "integrityToken": "INTEGRITY_TOKEN",
  "newValues": {
    "bitFirst": true,
    "bitThird": false
  }
}'
newValues.BitFirst = true // ForceSendFields optional for value true
newValues.BitSecond = false // ForceSendFields required for value false
newValues.BitThird = nil // do not set ForceSendFields for unspecified bits
newValues.ForceSendFields = []string{"BitSecond"}