Monitora le metriche reCAPTCHA

Questo documento descrive le metriche reCAPTCHA generate da Identity Platform in seguito all'integrazione di Identity Platform con l'API reCAPTCHA Enterprise e come visualizzarle con Cloud Monitoring.

Metriche reCAPTCHA

Dopo aver configurato l'integrazione di Identity Platform con l'API reCAPTCHA Enterprise e, facoltativamente, abilitato reCAPTCHA SMS Defense, puoi monitorare le metriche reCAPTCHA emesse dal tuo progetto per assicurarti che i flussi di autenticazione siano protetti. Se il provisioning della chiave reCAPTCHA non va a buon fine o se non sono stati creati i service account richiesti, l'autenticazione reCAPTCHA non va a buon fine.

Se hai attivato la protezione dai bot reCAPTCHA in modalità di controllo per i flussi di autenticazione email-password, il monitoraggio delle metriche reCAPTCHA ti aiuta a determinare se puoi attivare l'applicazione forzata. Prima di attivare l'applicazione, devi tenere conto dei seguenti fattori:

  • Se la maggior parte delle richieste recenti ha token validi e il rapporto tra PASSED e gli esiti FAILED_AUDIT o FAILED_ENFORCE è accettabile per il tuo business case, valuta la possibilità di attivare l'applicazione forzata.
  • Se la maggior parte delle richieste recenti proviene probabilmente da client obsoleti, valuta la possibilità di attendere che più utenti aggiornino l'app prima di attivare l'applicazione. L'applicazione dell'integrazione di Identity Platform con l'API reCAPTCHA Enterprise interrompe le versioni precedenti dell'app che non sono integrate con reCAPTCHA.

Per assicurarti che le funzionalità di integrazione funzionino come previsto, puoi esaminare le seguenti metriche che il tuo progetto invia a Cloud Monitoring.

identitytoolkit.googleapis.com/recaptcha/verdict_count

Questa metrica monitora i diversi esiti restituiti da reCAPTCHA. Se è presente un token, viene generato un esito. Puoi filtrare in base ai seguenti esiti:

  • PASSED: indica che una determinata richiesta è consentita quando l'applicazione è abilitata.
  • FAILED_AUDIT: indica che una determinata richiesta di autenticazione con email e password verrà rifiutata quando è abilitata la modalità di controllo reCAPTCHA.
  • FAILED_ENFORCE: indica che una determinata richiesta viene rifiutata quando l'applicazione forzata di reCAPTCHA è abilitata.
  • CLIENT_TYPE_MISSING: indica che una determinata richiesta non ha un tipo di client quando è abilitata l'applicazione di reCAPTCHA. Questo errore si verifica in genere se una richiesta è stata inviata utilizzando una versione dell'SDK client obsoleta che non supporta reCAPTCHA.
  • KEYS_MISSING: indica che una determinata richiesta non può essere verificata perché Identity Platform non può recuperare chiavi reCAPTCHA valide quando l'applicazione di reCAPTCHA è abilitata.

Per modificare gli intervalli di punteggio in modo da cambiare il rapporto tra verdetti superati e non superati, consulta Abilita la protezione dai bot di reCAPTCHA.

identitytoolkit.googleapis.com/recaptcha/token_count

Questa metrica monitora il numero e lo stato dei token reCAPTCHA ricevuti dal backend di Identity Platform. Puoi filtrare in base ai seguenti stati:

  • VALID: indica che il token reCAPTCHA trasmesso è valido.
  • EXPIRED: indica che il token reCAPTCHA passato è scaduto. Un token scaduto potrebbe indicare problemi di rete del client o un uso improprio.
  • DUPLICATE: indica che il token reCAPTCHA passato è un duplicato. Un token duplicato potrebbe indicare problemi di rete del client o un abuso.
  • INVALID: indica che il token reCAPTCHA trasmesso non è valido. Un token non valido potrebbe indicare un abuso.
  • MISSING: indica che il token reCAPTCHA non esiste nella richiesta specificata. La mancanza di token potrebbe indicare un'app client obsoleta.
  • UNCHECKED: indica che il token reCAPTCHA non è stato controllato a causa di esiti CLIENT_TYPE_MISSING o KEYS_MISSING.

Se l'app è stata implementata correttamente per gli utenti, vedrai il traffico con token validi. Il numero di token validi è probabilmente proporzionale al numero di utenti che utilizzano la tua app aggiornata.

identitytoolkit.googleapis.com/recaptcha/risk_scores

Questa metrica monitora la distribuzione dei punteggi reCAPTCHA. In questo modo puoi definire gli intervalli di punteggio ottimali per la configurazione della protezione dai bot.

identitytoolkit.googleapis.com/recaptcha/sms_tf_risk_scores

Questa metrica monitora la distribuzione dello scoring del rischio della difesa SMS reCAPTCHA per un progetto Identity Platform specifico. In questo modo puoi definire gli intervalli di punteggio ottimali per la configurazione di reCAPTCHA SMS defense.

Visualizza le metriche reCAPTCHA

Per visualizzare le metriche reCAPTCHA con Cloud Monitoring, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Esplora metriche.

    Vai a Esplora metriche

  2. In Seleziona una metrica, inserisci Tenant di Identity Toolkit. Se utilizzi la multitenancy, puoi visualizzare le metriche per ogni tenant, nonché per il progetto principale, lasciando vuoto tenant_name.

Passaggi successivi