Questa pagina descrive come utilizzare la funzionalità di difesa delle password di reCAPTCHA per rilevare le divulgazioni di password e le credenziali compromesse per impedire le violazioni di account (ATO) e gli attacchi di credential stuffing. Con reCAPTCHA, puoi eseguire audit regolari delle credenziali utente (password) nell'ambito di qualsiasi test per assicurarti che non siano state divulgate o violate. Per eseguire queste valutazioni, Google utilizza la funzionalità Controllo password.
Prima di iniziare
Make sure that billing is enabled for your Google Cloud project.
Per utilizzare la funzionalità Password Defense, reCAPTCHA richiede che la fatturazione sia collegata e abilitata nel progetto. Puoi attivare la fatturazione utilizzando una carta di credito o un ID fatturazione progetto esistente. Google Cloud Se hai bisogno di assistenza per la fatturazione, contatta l'assistenza per la fatturazione Cloud.
Controllare la presenza di credenziali violate e divulgate
Puoi verificare se un insieme di credenziali è stato compromesso utilizzando funzioni crittografiche o il container Docker.
Il container Docker è un client open source che implementa il calcolo multi-parte sicuro necessario per preservare la privacy dell'utente finale e cercare in modo sicuro le violazioni delle password. Per maggiori informazioni, consulta il repository GitHub. Il container Docker astrae la complessità dell'implementazione degli algoritmi crittografici e semplifica il processo di installazione. Ti consente inoltre di ospitare l'app container nella tua infrastruttura.
Funzione crittografica
Per verificare se un insieme di credenziali è stato compromesso, utilizza Password Defense quando crei valutazioni per azioni come accessi, modifiche della password e reimpostazioni della password.
Per verificare la divulgazione di password e le violazioni delle credenziali, completa i seguenti passaggi:
- Genera parametri di richiesta.
- Crea una valutazione per rilevare la divulgazione delle password.
- Verifica le credenziali divulgate da un'analisi.
- Interpreta il verdetto e intervieni.
Genera parametri di richiesta
Calcola i parametri di richiesta necessari utilizzando le funzioni crittografiche richieste dal protocollo di massima privacy. reCAPTCHA fornisce librerie Java e TypeScript per facilitare la generazione di questi campi:
Per creare verifiche del controllo delle password, crea un oggetto
PasswordCheckVerifier
.PasswordCheckVerifier verifier = new PasswordCheckVerifier();
Per avviare una verifica, chiama il numero
PasswordCheckVerifier#createVerification
. Questo metodo utilizza il nome utente e la password per calcolare i parametri per eseguire il controllo della password.PasswordCheckVerification verification = verifier.createVerification("username", "password").get();
Crea una valutazione utilizzando i parametri di verifica.
byte[] lookupHashPrefix = verification.getLookupHashPrefix(); byte[] encryptedUserCredentialsHash = verification.getEncryptedUserCredentialsHash();
Gli array di byte
lookupHashPrefix
eencryptedUserCredentialsHash
contengono i parametri necessari per avviare un controllo della passwordAssessment
.
Crea una valutazione per rilevare la divulgazione delle password
Utilizza il
metodo
projects.assessments.create
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: il tuo ID progetto Google Cloud
- LOOKUP_HASH_PREFIX: prefisso dell'hash SHA-256 del nome utente
- ENCRYPTED_USER_CREDENTIALS_HASH: hash Scrypt delle credenziali utente criptate
Metodo HTTP e URL:
POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/assessments
Corpo JSON della richiesta:
{ "private_password_leak_verification": { "lookup_hash_prefix": "LOOKUP_HASH_PREFIX", "encrypted_user_credentials_hash": "ENCRYPTED_USER_CREDENTIALS_HASH" } }
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:
{ "name": "projects/698047609967/assessments/fb22000000000000", "score": 0, "reasons": [], "privatePasswordLeakVerification": { "lookupHashPrefix": "zoxZwA==", "encryptedUserCredentialsHash": "AyRihRcKaGLj/FA/r2uqQY/fzfTaDb/nEcIUMeD3Tygp", "reencryptedUserCredentialsHash": "Aw65yEbLM39ww1ridDEfx5VhkWo11tzn/R1B88Qqwr/+" "encryptedLeakMatchPrefixes": [ "n/n5fvPD6rmQPFyb4xk=", "IVQqzXsbZenaibID6OI=", ..., "INeMMndrfnlf6osCVvs=", "MkIpxt2x4mtyBnRODu0=", "AqUyAUWzi+v7Kx03e6o="] } }
Verifica le credenziali divulgate da un'analisi
Dalla risposta al test estrai i campi
reEncryptedUserCredentials
e encryptedLeakMatchPrefixes
e passali all'oggetto
di verifica per determinare se le credenziali sono state compromesse o meno.
PasswordCheckResult result = verifier.verify(verification,
result.getReEncryptedUserCredentials(),
result.getEncryptedLeakMatchPrefixes()
).get();
System.out.println("Credentials leaked: " + result.areCredentialsLeaked());
Esempio di codice
Node.js (TypeScript)
Per scoprire come implementare il rilevamento delle fughe di password utilizzando Node.js (TypeScript), consulta l'esempio di codice TypeScript su GitHub.
Java
Per eseguire l'autenticazione in reCAPTCHA, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Container Docker
Per verificare se le credenziali sono state compromesse, invia in modo sicuro la coppia di credenziali nome utente e password al container utilizzando una connessione localhost o configurando HTTPS sul container. Il container cripta quindi queste credenziali prima di effettuare una richiesta API a reCAPTCHA e verifica il risultato ri-criptato localmente.
Per inviare richieste al container Docker, completa i seguenti passaggi:
- Configura Docker.
- Prepara un ambiente per il container Docker.
- Crea ed esegui il container.
- Invia richieste HTTP al container.
- Interpreta il verdetto e intervieni.
Preparati a eseguire il container Docker
Scegli una strategia di autenticazione.
Il container supporta l'impostazione delle credenziali predefinite dell'applicazione o può accettare una chiave API per l'autenticazione.
Configura il contenitore PLD in modo che venga eseguito con HTTPS o in modalità demo solo localhost.
Poiché il container accetta credenziali sensibili dell'utente finale (nomi utente e password), deve essere eseguito con HTTPS o in modalità demo solo localhost. Per indicazioni sulla configurazione HTTPS, consulta README su GitHub.
I seguenti passaggi utilizzano l'autenticazione con chiave API ed eseguono il client in modalità demo solo localhost.
Crea ed esegui il container Docker
Clona il repository:
git clone github.com/GoogleCloudPlatform/reCAPTCHA-PLD
Crea il container:
docker build . -t pld-local
Avvia il container:
docker run --network host \ -e RECAPTCHA_PROJECT_ID=PROJECT_ID \ -e GOOGLE_CLOUD_API_KEY=API_KEY \ pld-local
Il container viene avviato e inizia a gestire le richieste sulla porta 8080 di localhost.
Inviare richieste localhost
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- LEAKED_USERNAME: il nome utente della coppia di credenziali compromesse.
- LEAKED_PASSWORD: la password della coppia di credenziali compromesse.
Metodo HTTP e URL:
POST http://localhost:8080/createAssessment/
Corpo JSON della richiesta:
{ "username":"LEAKED_USERNAME", "password":"LEAKED_PASSWORD" }
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 "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"http://localhost:8080/createAssessment/"
PowerShell
Salva il corpo della richiesta in un file denominato request.json
,
quindi esegui il comando seguente:
$headers = @{ }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "http://localhost:8080/createAssessment/" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
{ "leakedStatus":"LEAKED" } OR { "leakedStatus":"NO_STATUS" }
Interpreta il verdetto e intervieni
La risposta alla valutazione mostra se le credenziali sono state compromesse e ti fornisce informazioni che puoi utilizzare per intraprendere le azioni appropriate per proteggere i tuoi utenti.
La seguente tabella elenca le azioni consigliate che puoi intraprendere quando viene rilevata una password compromessa:
Password divulgata rilevata | Azioni per proteggere l'utente |
---|---|
Durante l'accesso |
|
Durante la creazione dell'account o il ripristino della password |
|
Se non utilizzi già un provider MFA sul tuo sito, puoi utilizzare la funzionalità MFA di reCAPTCHA.
Passaggi successivi
- Scopri come utilizzare l'autenticazione a più fattori (MFA)
- Scopri come proteggere gli account utente utilizzando Account Defender di reCAPTCHA