Panoramica dei criteri firewall reCAPTCHA

Questo documento fornisce una panoramica dei criteri firewall reCAPTCHA.

Un criterio firewall reCAPTCHA è un insieme di regole che corrispondono agli attributi della condizione per proteggere il tuo sito da spam e comportamenti illeciti. Ogni regola viene valutata per il traffico in entrata. Le regole vengono valutate nello stesso ordine in cui vengono aggiunte nel criterio.

Componenti dei criteri firewall reCAPTCHA

Una regola del criterio firewall reCAPTCHA è composta dai seguenti componenti:

path: un percorso dell'URL a cui si applica la regola del criterio firewall. Ad esempio, /login.
condition: una condizione del criterio. Una condizione del criterio è un'espressione CEL (Common Expression Language) che deve risolversi in un valore booleano. Ad esempio, recaptcha.score >= 0.5.
action: un'azione che il fornitore di servizi WAF deve eseguire quando la condizione del criterio è soddisfatta. Per ulteriori informazioni, consulta la sezione sulle azioni previste dalle norme.

Quando una richiesta in entrata corrisponde a una condizione del criterio per il percorso specificato, il fornitore di servizi WAF consente, blocca o reindirizza la richiesta in base all'azione specificata. La regola predefinita è consentire l'accesso.

Un criterio firewall reCAPTCHA di esempio

Il seguente criterio firewall reCAPTCHA di esempio contiene una regola che viene applicata all'azione login. Blocca l'accesso se il punteggio è inferiore a 0,5.

     policy {
          path: login.php
          condition: recaptcha.score < 0.5
          action: block
        }

Attributi delle condizioni dei criteri firewall reCAPTCHA

La seguente tabella elenca gli attributi dei token reCAPTCHA che puoi utilizzare per definire le condizioni nei criteri firewall di reCAPTCHA.

Nome dell'attributo	Tipo di dati	Descrizione
`recaptcha.token.valid`	boolean	Indica se il token ricevuto è valido. Un token è valido se non è nel formato corretto o è scaduto, anche se il punteggio è basso.
`recaptcha.token.action`	string	Il nome dell'azione fornito al momento della generazione del token. Il campo viene compilato solo per i token di azione. Questo è il parametro `action` che viene passato a `grecaptcha.enterprise.execute()` quando viene creato il token. Per ulteriori informazioni, consulta la sezione Nomi delle azioni.
`recaptcha.score`	float	Il punteggio di un token reCAPTCHA. Un punteggio valido va da 0,0 a 1,0. Il punteggio 1,0 indica che l'interazione presenta un rischio basso ed è probabilmente legittima, mentre 0,0 indica che l'interazione presenta un rischio elevato e potrebbe essere fraudolenta. Per maggiori informazioni, consulta Interpretare i punteggi.
`recaptcha.assessment_type`	integer	Il tipo di valutazione effettuato. `assessment_type` è impostato in base alla chiave reCAPTCHA per WAF passata con la richiesta. Per confrontare il valore di `recaptcha.assessment_type` nell'espressione CEL, utilizza una delle seguenti costanti: `AssessmentType.ACTION` `AssessmentType.SESSION` `AssessmentType.CHALLENGEPAGE` `AssessmentType.EXPRESS` Ad esempio, per confrontare una valutazione con token di azione, utilizza `AssessmentType.ACTION`.
`http.ip`	string	L'indirizzo IP della richiesta in entrata.
`http.path`	string	Il percorso dell'URI della richiesta.
`http.domain`	string	Il dominio dell'URI richiesto.

Azioni del criterio firewall reCAPTCHA

La seguente tabella elenca le varie azioni dei criteri che puoi specificare nelle regole dei criteri firewall reCAPTCHA:

Azione del criterio	Descrizione	Risultato dell'azione
`allow`	Consente l'accesso alla pagina richiesta.	La richiesta dell'utente in entrata non viene interrotta per il tuo backend.
`block`	Nega l'accesso alla pagina richiesta.	Viene restituito all'utente un errore HTTP 403 (non consentito).
`redirect`	Reindirizza la richiesta dell'utente in arrivo alla pagina di verifica reCAPTCHA.	La pagina di verifica reCAPTCHA valuta la richiesta dell'utente e allega un cookie in base alla valutazione. In seguito, la richiesta dell'utente viene nuovamente reindirizzata alla pagina originale.
`substitute`	Pubblica una pagina diversa da quella richiesta a seguito di una richiesta fraudolenta di un utente.	Il percorso richiesto viene sostituito con un percorso diverso quando invii la richiesta al tuo backend. L'utente continua a vedere l'URL originale.
`set_header`	Imposta un'intestazione personalizzata e consente alla richiesta dell'utente in entrata di proseguire con il backend. Il backend può quindi attivare una protezione personalizzata.	Alla richiesta dell'utente è allegata un'intestazione. Il backend utilizza questa intestazione per attivare un'analisi o una protezione personalizzata.