Questo documento descrive le differenze nella terminologia e nella gestione delle chiavi tra la Console di amministrazione reCAPTCHA legacy e la console Google Cloud . Spiega anche come recuperare le chiavi del sito e le chiavi segrete reCAPTCHA richieste da plug-in di terze parti come le integrazioni WordPress.
Mappare la terminologia precedente alla console Google Cloud
Molti plug-in del sistema di gestione dei contenuti (CMS) fanno riferimento ai tipi di reCAPTCHA utilizzando convenzioni di denominazione legacy, come v2 Checkbox, v2 Invisible e v3.La console Google Cloud utilizza descrittori basati sulla piattaforma anziché numeri di versione.
La tabella seguente mappa la terminologia precedente alla terminologia della console Google Cloud :
| Terminologia della Console di amministrazione | Google Cloud Terminologia della console | Meccanismo di verifica |
|---|---|---|
| In base al punteggio (v3) | Sito web • punteggio | Verifica semplice basata sul punteggio. |
| Verifica (v2) | Sito web • Casella di controllo | Richiede all'utente di fare clic su una verifica "Non sono un robot". |
| N/D | Sito web • verifica basata su policy | Verifica configurata in base alla soglia definita dall'utente. |
| N/D | iOS | Chiave mobile iOS senza verifica. |
| N/D | Android | Chiave mobile Android senza challenge. |
| Invisibile (v2) | Sito web • Invisibile con fallback della verifica* | Potrebbe mostrare verifiche captcha dopo l'analisi del rischio. |
Verifica il tipo di chiave nella console Google Cloud
Per verificare il tipo di una chiave nella console Google Cloud :
Nella console Google Cloud , vai alla pagina Fraud Defense.
Seleziona la scheda Chiavi.
Passa dalla visualizzazione Schede alla visualizzazione Tabella.
Individua la colonna Dettagli piattaforma per visualizzare i descrittori come
Website • score.
In alternativa, nella visualizzazione predefinita Schede, fai clic su Dettagli chiave per una chiave specifica, quindi seleziona Modifica chiave. Il campo Tipo mostra la configurazione.
Trovare la chiave del sito e la chiave segreta
I plug-in di terze parti spesso richiedono una chiave di sito e una chiave segreta per l'integrazione di reCAPTCHA.
- Chiave del sito: nella console Google Cloud , l'ID chiave corrisponde alla chiave del sito.
- Chiave segreta: la console Google Cloud non mostra la chiave segreta per impostazione predefinita perché l'autenticazione Google Cloud in genere utilizza chiavi API o ruoli IAM. Tuttavia, puoi recuperare la chiave segreta precedente per i plug-in che la richiedono.
Recupera la chiave segreta nella console Google Cloud
Per recuperare la chiave segreta:
Nella console Google Cloud , vai alla pagina Fraud Defense.
Seleziona la scheda Chiavi.
Nella sezione Chiavi reCAPTCHA, vai alla chiave per cui ti serve la chiave segreta.
- Se visualizzi la pagina in modalità Schede, fai clic su Dettagli chiave nella scheda della chiave. L'ID chiave viene visualizzato nella parte superiore della pagina.
- Se ti trovi nella visualizzazione Tabella, l'ID chiave è visibile nella tabella. Fai clic sulla chiave per andare alla relativa pagina dei dettagli.
L'ID chiave visualizzato nella parte superiore della pagina è la tua chiave del sito.
Vai alla scheda Integrazione.
A seconda dello stato della chiave:
- Se la chiave è configurata per l'utilizzo legacy, fai clic su Usa chiave precedente.
- Se la chiave non è integrata con un servizio precedente, fai clic su Integra con un servizio o un plug-in di terze parti.
Viene visualizzata una finestra di dialogo con la chiave segreta. Copia questo valore in modo sicuro. Considera questo secret come dati sensibili.
Integrare utilizzando i test
Il metodo CreateAssessment fornisce un'analisi dettagliata del rischio e codici motivo
e consente l'accesso alle funzionalità avanzate di Fraud Defense. Puoi chiamare il metodo CreateAssessment utilizzando le librerie client reCAPTCHA o l'API REST.
Per saperne di più, consulta Creare un test per il tuo sito web.
Metodo SiteVerify legacy
Sebbene il metodo CreateAssessment sia consigliato per le integrazioni nuove e personalizzate grazie alle sue funzionalità avanzate, alcuni sistemi esistenti o plug-in di terze parti potrebbero ancora fare affidamento sul metodo legacy SiteVerify. Questo metodo richiede l'utilizzo di una "chiave segreta" per la verifica.
Se devi eseguire l'integrazione con un sistema che richiede specificamente l'API SiteVerify legacy, puoi trovare istruzioni dettagliate nella documentazione di siteverify.