Account defense ti aiuta a rilevare e prevenire attività fraudolente sugli account nelle applicazioni mobile. Account defense monitora i pattern delle attività utente e crea un modello comportamentale specifico per il sito per aiutarti a identificare l'abuso delle credenziali e proteggere gli account utente da attacchi automatici.
Fraud Defense ti aiuta a proteggere azioni critiche, come l'accesso e il pagamento. Tuttavia, esistono molte forme sottili di abuso dell'account che possono essere rilevate osservando il comportamento di un utente specifico su un'applicazione mobile per un periodo di tempo. Account defense, una funzionalità di Fraud Defense, aiuta a identificare questi tipi di comportamenti illeciti impercettibili creando un modello specifico per il sito per la tua applicazione mobile, in modo da rilevare una tendenza di comportamento sospetto o una variazione dell'attività. Utilizzando il modello specifico per il sito, Account defense ti aiuta a rilevare quanto segue:
- Attività sospette
- Account con comportamenti simili
- Richieste provenienti da dispositivi contrassegnati come attendibili per utenti specifici
In base all'analisi di Account defense e del modello specifico per il sito, puoi intraprendere le seguenti azioni:
- Limitare o disattivare gli account fraudolenti.
- Previeni i tentativi di takeover dell'account.
- Mitigare i takeover dell'account riusciti.
- Concedi l'accesso solo alle richieste provenienti da account utente legittimi.
- Riduci le difficoltà per gli utenti che accedono da uno dei loro dispositivi attendibili.
Prima di iniziare
- Account defense per le applicazioni mobile è accessibile dopo aver attivato un controllo di sicurezza automatico aggiungendo un account di fatturazione al progetto. Aggiungi un account di fatturazione al progetto per eseguire l'onboarding della tua applicazione mobile in questa funzionalità.
- Prepara il tuo ambiente per Google Cloud Fraud Defense.
- Crea una chiave basata sul punteggio.
Configura l'applicazione mobile per Account defense
Account defense richiede una comprensione completa delle attività dell'account per consentire un rilevamento efficace. Per iniziare a fornire attività relative all'account ad Account defense e per creare e migliorare il modello specifico del tuo sito, segui questi passaggi:
Integra Fraud Defense con la tua applicazione mobile.
- Per le app per Android, consulta Integra Fraud Defense con le app per Android.
- Per le app per iOS, consulta Integra Fraud Defense con le app per iOS.
- Report sulle azioni utente critiche.
- Valuta gli eventi utente critici.
- Annota gli eventi utente per ottimizzare il modello specifico del sito.
Report sulle azioni utente critiche
Per rilevare pattern di attività sospette e creare un modello migliore dei pattern di attività tipici sul tuo sito, Account defense ha bisogno di informazioni sulle azioni utente critiche.
Per ogni azione della tua app protetta con Fraud Defense, chiama il metodo execute() con RecaptchaAction. Per saperne di più su execute() e RecaptchaAction, consulta quanto segue:
- Android:
execute()eRecaptchaAction. - iOS:
execute()eRecaptchaAction.
La libreria reCAPTCHA fornisce un insieme di azioni integrate e, se necessario, puoi creare azioni personalizzate.
La tabella seguente elenca i nomi delle azioni che puoi utilizzare per segnalare le azioni utente critiche.
| Nome azione | Evento avviato dall'utente o azione utente |
|---|---|
LOGIN |
Accedi all'applicazione mobile. |
SIGNUP |
Registrati nell'applicazione mobile. |
Valuta gli eventi utente critici
Quando chiami execute() in un'azione utente, viene generato un token. Per gli eventi utente critici, come accessi riusciti e non riusciti, registrazioni e azioni degli utenti che hanno eseguito l'accesso, crea un test per valutare i risultati della chiamata execute(). La valutazione fornisce un verdetto sul rischio, che puoi utilizzare per prendere una decisione su come gestire le attività potenzialmente fraudolente. Alcune delle azioni che puoi intraprendere sono il blocco delle richieste sospette, la verifica degli accessi rischiosi e l'indagine sugli account di interesse.
Account defense richiede di fornire un identificatore dell'account stabile per eseguire la valutazione e attribuire l'attività utente, ad esempio richieste di accesso, richieste di accesso e richieste di registrazione, a un account specifico. In questo modo, Account defense può elaborare i pattern di attività utente per creare un modello di attività per ogni account e rilevare meglio il traffico anomalo e abusivo.
Scegli un identificatore dell'account stabile accountId che non venga modificato spesso dall'utente e forniscilo alla valutazione nel metodo projects.assessments.create. Questo identificatore stabile dell'account deve avere lo stesso valore per tutti gli eventi correlati allo stesso utente. Puoi fornire i seguenti dati come identificatore dell'account:
Identificatori degli utenti
Se ogni account può essere associato in modo univoco a un nome utente, un indirizzo email o un numero di telefono stabile, puoi utilizzarlo come accountId. Quando fornisci questi identificatori
cross-site (identificatori che possono essere riutilizzati su più siti), Fraud Defense utilizza queste
informazioni per migliorare la protezione dei tuoi account utente in base a modelli cross-site,
contrassegnando gli identificatori di account illeciti e utilizzando la conoscenza dei pattern di abuso cross-site correlati
a questi identificatori.
In alternativa, se hai un ID utente interno associato in modo univoco a ogni account, puoi fornirlo come accountId.
Sottoposti ad hashing o criptati
Se non hai un ID utente interno associato in modo univoco a ogni account, puoi convertire qualsiasi identificatore stabile in un identificatore di account opaco e specifico per il sito. Questo identificatore è ancora necessario per consentire ad Account Defender di Fraud Defense di comprendere i pattern di attività utente e rilevare comportamenti anomali, ma non viene condiviso con altri siti.
Scegli un identificatore dell'account stabile e rendilo opaco prima di inviarlo a Fraud Defense utilizzando la crittografia o l'hashing:
crittografia (consigliata): cripta l'identificatore dell'account utilizzando un metodo di crittografia deterministico che produce un testo cifrato stabile. Per istruzioni dettagliate, consulta Cripta i dati in modo deterministico. Quando scegli la crittografia simmetrica anziché l'hashing, non devi mantenere una mappatura tra i tuoi identificatori dell'utente e i corrispondenti identificatori utente opachi. Decripta gli identificatori opachi restituiti da Fraud Defense per convertirli nell'identificatore dell'utente.
Hashing: ti consigliamo di eseguire l'hashing dell'identificatore dell'account utilizzando il metodo SHA256-HMAC con un salt personalizzato di tua scelta. Poiché gli hash sono unidirezionali, devi mantenere una mappatura tra gli hash generati e gli identificatori utente in modo da poter mappare l'identificatore dell'account con hash restituito agli account originali.
Oltre a fornire un identificatore dell'account stabile per tutte le richieste relative all'account, puoi fornire identificatori dell'account aggiuntivi, potenzialmente non stabili, per alcune richieste specifiche.
Gli identificatori dell'account specifici per il contesto forniti in aggiunta a accountId aiutano Account defense ad analizzare meglio l'attività utente e a rilevare i tentativi di takeover dell'account per proteggere gli account utente. Quando fornisci identificatori aggiuntivi, Google Cloud Fraud Defense utilizza queste informazioni per migliorare la protezione dei tuoi account utente in base a modelli cross-site, segnalando gli identificatori di account illeciti e utilizzando la conoscenza dei pattern di abuso cross-site correlati a questi identificatori. Ad esempio, puoi fornire:
Il nome utente, l'indirizzo email o il numero di telefono utilizzato come handle di accesso per le richieste di accesso
L'indirizzo email o il numero di telefono verificato per una richiesta di autenticazione a più fattori
Un indirizzo email o un numero di telefono (principale o secondario) fornito dall'utente durante una richiesta di aggiornamento dell'account
Gli indirizzi email e i numeri di telefono forniti dall'utente durante una richiesta di registrazione
Aggiungi l'identificatore dell'account stabile scelto al parametro accountId nel metodo
projects.assessments.create per tutte le richieste relative all'account. Facoltativamente,
fornisci identificatori dell'account aggiuntivi per le richieste pertinenti utilizzando il campo userIds
nella valutazione.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: il tuo ID progetto Google Cloud
- TOKEN: token restituito dalla chiamata
execute() - KEY_ID: la chiave reCAPTCHA associata all'app
- ACCOUNT_ID: l'identificativo che è associato in modo univoco all'account utente per un account utente alla tua app
- EMAIL_ADDRESS: (Facoltativo) Un indirizzo email associato a questa richiesta, se presente
- PHONE_NUMBER: (Facoltativo) Un numero di telefono associato a questa richiesta, se presente
- USERNAME: (Facoltativo) Un nome utente associato a questa richiesta, se presente
Metodo HTTP e URL:
POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments
Corpo JSON della richiesta:
{
"event": {
"token": "TOKEN",
"siteKey": "KEY_ID",
"userInfo": {
"accountId": "ACCOUNT_ID",
"userIds": [
{
"email": "EMAIL_ADDRESS"
},
{
"phoneNumber": "PHONE_NUMBER"
},
{
"username": "USERNAME"
}
]
}
}
}
Per inviare la richiesta, scegli una di queste opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments"
PowerShell
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
{
"tokenProperties": {
"valid": true,
"androidPackageName": "com.example.app" or "iosBundleId": "com.example.app",
"action": "login",
"createTime": "2019-03-28T12:24:17.894Z"
},
"riskAnalysis": {
"score": 0.6,
},
"event": {
"token": "TOKEN",
"siteKey": "KEY",
"userInfo": {
"accountId": "ACCOUNT_ID"
}
},
"name": "projects/PROJECT_NUMBER/assessments/b6ac310000000000",
"accountDefenderAssessment": {
"labels": ["SUSPICIOUS_LOGIN_ACTIVITY"]
}
}
Esempio di codice
Java
Per eseguire l'autenticazione in Fraud Defense, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Interpreta l'esito del rischio degli eventi utente critici
Quando crei un test con Account defense abilitato, Account defense restituisce accountDefenderAssessment come parte della risposta del test.
Il valore di accountDefenderAssessment ti aiuta a valutare se l'attività utente è legittima o fraudolenta. Inoltre, restituisce un ID valutazione che devi utilizzare per annotare gli eventi utente.
Di seguito è riportato un esempio di risposta JSON:
{ "tokenProperties": { "valid": true, "androidPackageName": "com.example.app" or "iosBundleId": "com.example.app", "action": "login", "createTime": "2019-03-28T12:24:17.894Z" }, "riskAnalysis": { "score": 0.6, }, "event": { "token": "TOKEN", "siteKey": "KEY_ID", "expectedAction": "USER_ACTION" }, "name": "projects/PROJECT_ID/assessments/b6ac310000000000X", "accountDefenderAssessment": { labels: ["SUSPICIOUS_LOGIN_ACTIVITY"] } }
Il campo accountDefenderAssessment può contenere uno qualsiasi dei seguenti valori:
| Valore | Descrizione |
|---|---|
SUSPICIOUS_LOGIN_ACTIVITY |
Indica che la richiesta rappresenta un rischio elevato di credential stuffing o takeover dell'account. |
SUSPICIOUS_ACCOUNT_CREATION |
Indica che la richiesta rappresenta un rischio elevato di creazione di account illeciti. |
PROFILE_MATCH |
Indica che gli attributi dell'utente corrispondono agli attributi visualizzati in precedenza per questo utente specifico. Questo valore indica che l'utente utilizza un dispositivo attendibile che è stato utilizzato in precedenza per accedere alla tua applicazione mobile.
|
Annota gli eventi per ottimizzare il modello specifico per il sito
Per fornire ulteriori informazioni ad Account defense e migliorare il modello di rilevamento specifico del sito, devi annotare gli eventi che hai valutato creando valutazioni.
Per annotare una valutazione, invia una richiesta al metodo projects.assessments.annotate con l'ID valutazione. Nel corpo della richiesta, includi le etichette che forniscono informazioni aggiuntive su un evento descritto nella valutazione.
Per annotare un test:
-
Determina le informazioni e le etichette da aggiungere nel corpo JSON della richiesta in base al tuo caso d'uso.
La tabella seguente elenca le etichette e i valori che puoi utilizzare per annotare gli eventi:
Etichetta Descrizione Esempio di richiesta reasonsObbligatorio. Un'etichetta per supportare le tue valutazioni. Fornisci i dettagli dell'evento in tempo reale nell'etichetta
reasonsentro pochi secondi o minuti dall'evento, perché influiscono sul rilevamento in tempo reale.Per l'elenco dei valori possibili, consulta i valori dei motivi.
Esempio: per rilevare i takeover dell'account, annota se la password inserita era corretta con i valori
CORRECT_PASSWORDoINCORRECT_PASSWORD. Se hai eseguito il deployment della tua MFA, puoi aggiungere i seguenti valori:INITIATED_TWO_FACTORePASSED_TWO_FACTORoFAILED_TWO_FACTOR.{ "reasons": ["INCORRECT_PASSWORD"] }annotationFacoltativo. Un'etichetta per indicare la legittimità delle valutazioni. Fornisci informazioni sugli eventi di accesso e registrazione per convalidare o correggere le tue analisi del rischio nell'etichetta
annotation.Valori possibili:
LEGITIMATEoFRAUDULENT.Puoi inviare queste informazioni in qualsiasi momento o nell'ambito di un job batch. Tuttavia, ti consigliamo di inviare queste informazioni entro pochi secondi o minuti dall'evento, perché influiscono sul rilevamento in tempo reale.
{ "annotation": "LEGITIMATE" }accountIdFacoltativo. Un'etichetta per associare un ID account a un evento.
Se hai creato un test senza un ID account, utilizza questa etichetta per fornire l'ID account di un evento ogni volta che è disponibile.
{ "accountId": "ACCOUNT_ID" } Crea una richiesta di annotazione con le etichette appropriate.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- ASSESSMENT_ID: il valore del campo
namerestituito dalla chiamataprojects.assessments.create. - ANNOTATION: (Facoltativo) Un'etichetta per indicare se la valutazione è legittima o fraudolenta.
- REASONS: (Facoltativo) Motivi a sostegno della tua annotazione. Per l'elenco dei valori possibili, consulta Valori dei motivi.
- ACCOUNT_ID: facoltativo. L'identificatore associato in modo univoco all'account utente nella tua app.
Per saperne di più, consulta Etichette per le annotazioni.
Metodo HTTP e URL:
POST https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate
Corpo JSON della richiesta:
{ "annotation": ANNOTATION, "reasons": REASONS, "accountId": ACCOUNT_ID }Per inviare la richiesta, scegli una di queste opzioni:
curl
Salva il corpo della richiesta in un file denominato
request.json, quindi esegui il comando seguente:curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate"PowerShell
Salva il corpo della richiesta in un file denominato
request.json, quindi esegui il comando seguente:$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate" | Select-Object -Expand ContentDovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.
- ASSESSMENT_ID: il valore del campo
Esempio di codice
Java
Per eseguire l'autenticazione in Fraud Defense, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Utilizza e interpreta lo scoring del rischio di takeover dell'account
La funzionalità di scoring del rischio di takeover dell'account (ATO) aggiunge un punteggio di rischio numerico e spiegazioni leggibili alla valutazione di Account defense. Questi insight ti aiutano a comprendere la valutazione e a prendere decisioni o intraprendere azioni successive.
Ottieni lo scoring del rischio
Per ricevere lo scoring del rischio e i motivi della spiegabilità, invia una richiesta CreateAssessment e includi event.userInfo.accountId nella richiesta.
Leggi il punteggio di rischio e i dettagli
Lo scoring del rischio e i motivi della spiegabilità si trovano nell'oggetto accountDefenderAssessment.accountTakeoverVerdict nella risposta della valutazione.
- Scoring del rischio:
accountDefenderAssessment.accountTakeoverVerdict.risk - Motivi del rischio:
accountDefenderAssessment.accountTakeoverVerdict.riskReasons - Motivi di attendibilità:
accountDefenderAssessment.accountTakeoverVerdict.trustReasons
Il seguente snippet mostra un esempio dei campi in una risposta di valutazione:
"accountDefenderAssessment": { "labels": ["PROFILE_MATCH"], "accountTakeoverVerdict": { "risk": 0.249, "riskReasons": [{"reason": "CLIENT_ACCESSED_MANY_ACCOUNTS"}], "trustReasons": [{"reason": "PROFILE_MATCH"}, {"reason": "ACCOUNT_HISTORY_REPUTABLE"}] } }
Interpreta il punteggio di rischio di ATO
Quando utilizzi lo scoring del rischio, stabilisci una soglia per determinare quando intraprendere azioni di protezione.
Utilizza lo scoring del rischio ATO come alternativa all'etichetta SUSPICIOUS_LOGIN_ACTIVITY.
Non utilizzare sia lo scoring del rischio sia l'etichetta per attivare l'applicazione sulla stessa valutazione. Puoi configurare la logica di applicazione in base al superamento della soglia dello scoring del rischio o alla presenza dell'etichetta. In genere, lo scoring del rischio offre una valutazione più granulare.
Prima di utilizzare lo scoring del rischio per l'applicazione, ti consigliamo di valutarne il rendimento con una soglia appropriata sul traffico della tua piattaforma.
Per agire in base allo scoring del rischio, implementa un controllo nel tuo backend come mostrato nello snippet seguente:
if (assessment.accountDefenderAssessment.accountTakeoverVerdict.risk > YOUR_CHOSEN_THRESHOLD) {
// Treat as suspicious
// Implement protective actions
}
Soglie standard dello scoring del rischio
La tabella seguente fornisce le soglie standard dello scoring del rischio e i relativi tassi di falsi positivi (FPR) previsti. Scegli una soglia in base al tuo FPR accettabile. Il rendimento può variare, quindi potresti dover modificare la soglia in base al rendimento osservato.
| Tolleranza di rischio | Soglia consigliata | Percentuale massima di falsi positivi |
|---|---|---|
| Bassa | 0,5 | 4% |
| Media | 0,7 | 1% |
| Alta | 0,9 | 0,25% |
Interpreta i motivi della spiegabilità
I motivi della spiegabilità forniscono insight sui fattori che influenzano lo scoring del rischio. Utilizza questi motivi per perfezionare il tuo processo decisionale.
- Motivi di rischio: indicano i fattori associati a un rischio più elevato di takeover dell'account.
- Motivi di affidabilità: indica i fattori che suggeriscono la legittimità.
Per ogni punteggio di rischio possono essere visualizzati sia i motivi di rischio sia quelli di attendibilità.
| Motivo | Tipo | Interpretazione |
|---|---|---|
PROFILE_MATCH |
Attendibile | La richiesta corrisponde a un profilo attendibile associato a questo account. Equivale all'etichetta AccountDefenderLabel.PROFILE_MATCH. |
ACCOUNT_HISTORY_REPUTABLE |
Attendibile | L'attività storica dell'account è affidabile. È improbabile che l'account sia stato compromesso in passato. |
CLIENT_HISTORICAL_BOT_ACTIVITY |
Rischio | In passato è stato osservato che il client inviava traffico simile a quello di un bot a questo sito. Questo motivo incorpora la reputazione storica e indica che è noto che il client utilizza bot, anche se la richiesta corrente viene effettuata da un essere umano. |
ACCOUNT_IN_LARGE_RELATED_GROUP |
Rischio | L'account fa parte di un ampio gruppo di account correlati, il che indica che potrebbe far parte di una rete fraudolenta. Gli account correlati vengono identificati in base a pattern di traffico e caratteristiche delle richieste simili. |
CLIENT_ACCESSED_MANY_ACCOUNTS |
Rischio | È stato osservato che il client accede a molti account su questo sito. |
DISPOSABLE_EMAIL_DOMAIN |
Rischio | L'indirizzo email fornito appartiene a un provider noto o sospetto di domini email temporanei e usa e getta (monouso). |
Modifica la soglia di rischio di takeover dell'account
Dopo aver valutato lo scoring del rischio di takeover dell'account sul tuo traffico, potresti dover modificare la soglia per ottenere il tasso di falsi positivi (FPR) e il richiamo accettabili. Puoi ottimizzare la soglia in base alle prestazioni osservate o calcolare valori intermedi per scegliere come target un FPR specifico.
Modifica la soglia
Se il tasso di falsi positivi osservato è troppo elevato, aumenta la soglia. Se il richiamo osservato è troppo basso e puoi tollerare un FPR più elevato, diminuisci la soglia.
Calcola i valori intermedi
Per stimare il tasso di falsi positivi per una soglia compresa tra i valori standard, utilizza l'interpolazione lineare. L'esempio seguente mostra come calcolare il tasso di falsi positivi per una soglia di 0,85:
FPR(T: 0.85) = (FPR(T: 0.8) + FPR(T: 0.9)) / 2 = (0.5% + 0.25%) / 2 = 0.375%
Per trovare una soglia per un FPR specifico, esegui l'interpolazione tra i valori standard. L'esempio seguente mostra come trovare la soglia per un FPR del 5%:
Threshold = 0.4 + (0.5 − 0.4) × (8% − 5%) / (8% − 4%) Threshold = 0.4 + 0.1 × (3 / 4) Threshold = 0.4 + 0.075 = 0.475
Si stima che una soglia di 0,475 produca un FPR del 5%.
Passaggi successivi
- Per scoprire di più sulle altre funzionalità di protezione degli account, consulta Funzionalità di protezione degli account utente.