Method: getRecaptchaConfig

Recupera i parametri necessari per l'analisi reCAPTCHA.

Richiesta HTTP

GET https://identitytoolkit.googleapis.com/v2/recaptchaConfig

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
tenantId

string

L'ID di un tenant.

clientType

enum (ClientType)

reCAPTCHA Enterprise utilizza chiavi di sito separate per tipi di client diversi. Specifica il tipo di client per ottenere la chiave corrispondente.

version

enum (RecaptchaVersion)

La versione di reCAPTCHA.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Configurazione per reCAPTCHA

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "recaptchaEnforcementState": [
    {
      object (RecaptchaEnforcementState)
    }
  ],
  "recaptchaKey": string,
  "useSmsBotScore": boolean,
  "useSmsTollFraudProtection": boolean
}
Campi
recaptchaEnforcementState[]

object (RecaptchaEnforcementState)

Lo stato di applicazione forzata di reCAPTCHA per i provider per i quali GCIP supporta la protezione reCAPTCHA.

recaptchaKey

string

Il nome della risorsa della chiave reCAPTCHA Enterprise, ad esempio "projects/{project}/keys/{key}". Questo valore viene restituito solo quando lo stato di applicazione di reCAPTCHA è AUDIT o ENFORCE su almeno uno dei provider reCAPTCHA.

useSmsBotScore

boolean

Indica se utilizzare il punteggio del bot rCE per il fornitore di telefonia reCAPTCHA.

useSmsTollFraudProtection

boolean

Indica se utilizzare il punteggio di rischio della protezione antifrode tariffaria SMS di reCAPTCHA per il fornitore di telefoni di reCAPTCHA.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/identitytoolkit
  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la sezione Authentication Overview.

RecaptchaEnforcementState

Stati di applicazione per la protezione reCAPTCHA.

Rappresentazione JSON
{
  "provider": enum (RecaptchaProvider),
  "enforcementState": enum (EnforcementState)
}
Campi
provider

enum (RecaptchaProvider)

Il fornitore che dispone della protezione reCAPTCHA.

enforcementState

enum (EnforcementState)

Lo stato di applicazione forzata di reCAPTCHA per il provider.

RecaptchaProvider

I fornitori GCIP che supportano la protezione reCAPTCHA.

Enum
RECAPTCHA_PROVIDER_UNSPECIFIED Provider reCAPTCHA non specificato
EMAIL_PASSWORD_PROVIDER Fornitore della password email
PHONE_PROVIDER Fornitore di autenticazione telefonica

EnforcementState

Stati di applicazione della protezione reCAPTCHA per ciascun provider.

Enum
ENFORCEMENT_STATE_UNSPECIFIED Lo stato dell'applicazione forzata non è stato impostato.
OFF Non applicato.
AUDIT La valutazione reCAPTCHA viene creata, ma il risultato non viene utilizzato per l'applicazione.
ENFORCE Viene creata la valutazione reCAPTCHA e il risultato viene utilizzato per l'applicazione.