Blocca un dominio email in WooCommerce: regole jolly di Checkout Guard

Checkout Guard 1.0.2 ti consente di bloccare un dominio email in WooCommerce con una regola jolly. Una singola voce come *@example.com o 192.168.1.* ora blocca ogni indirizzo su un dominio o ogni IP in un intervallo. I proprietari di negozi che inseguono frodi ripetute possono smettere di mantenere manualmente elenchi di corrispondenza esatta.

La modifica è piccola sullo schermo e grande in pratica. Nessuna nuova pagina di impostazioni, nessun nuovo campo, nessuna migrazione. Gli stessi quattro campi che usi già accettano un carattere in più, e quel carattere cambia ciò che una singola regola può coprire. Di seguito trattiamo cosa fa l'asterisco e come gli intervalli IP differiscono dai pattern di email e nomi. Elenchiamo anche i valori che Checkout Guard rifiuterà di salvare e l'unica cosa da controllare prima di aggiornare.

Indice dei contenuti

• Blocca un dominio email in WooCommerce con una regola
• Cosa fa effettivamente l'asterisco
• Gli intervalli IP funzionano per segmento, non per pattern
• I valori che Checkout Guard rifiuta di salvare
• Aggiungere la tua prima regola jolly
• Jolly tramite l'API REST
• Un'unica cosa da controllare prima di aggiornare
• Domande Frequenti

Blocca un dominio email in WooCommerce con una regola

Fino a questa release, ogni valore in una regola di Checkout Guard veniva confrontato come una stringa esatta. La distinzione tra maiuscole e minuscole non era importante per nomi ed email, ma nient'altro era flessibile. Se venti ordini arrivavano da venti indirizzi con lo stesso dominio usa e getta dominio, aggiungevi venti voci. Poi ventuno quando si presentava il successivo indirizzo. Mantenere quell'elenco aggiornato è la metà noiosa di qualsiasi piano per prevenire ordini falsi in WooCommerce.

Ciò va bene quando il problema è una persona. È completamente sbagliato quando il problema è un dominio o un blocco di rete. È così che di solito appare l'abuso una volta che smette di essere un singolo cliente arrabbiato e inizia ad essere uno script. I caratteri jolly consentono a una regola di descrivere l'intero schema invece di enumerare le istanze. Essere in grado di bloccare un dominio email in WooCommerce con una sola voce è ciò che lo rende pratico per fermare ordini di spam in WooCommerce una volta che il volume aumenta.

Cosa fa effettivamente l'asterisco

Nei campi nome, cognome ed email, * sta per zero o più caratteri e può apparire ovunque nel valore:

• *@example.com blocca ogni indirizzo di quel dominio
• jo* corrisponde a jo, john e johnny
• sm*th corrisponde a smith e smyth
• *son corrisponde a Jackson e Wilson

La corrispondenza rimane insensibile alle maiuscole/minuscole, esattamente come prima. È anche ancorata ad entrambe le estremità, che è il dettaglio che la maggior parte delle persone sbaglia quando immagina come funziona. john* corrisponde a johnny, ma non corrisponde a ajohn. Lo schema deve tenere conto dell'intero valore, non solo di una sua parte.

Ogni carattere diverso dall'asterisco viene trattato letteralmente. Il punto in *@example.com è un vero punto, non un token di espressione regolare, quindi uno schema non può corrispondere accidentalmente a più di quanto si intendesse. Quando blocchi un dominio email in WooCommerce in questo modo, viene interessato solo quel dominio.

I nomi mantengono il contratto che hanno sempre avuto. Una voce che blocca in base al nome richiede sia il nome che il cognome compilati, ed entrambi devono corrispondere. Ciascuno di questi può avere il proprio carattere jolly, quindi john* più smith* fermerà Johnny Smithson e lascerà Johnny Jones. Tra i tipi di campo la logica è ancora un OR: una voce blocca un ordine quando entrambi i nomi corrispondono, o l'email corrisponde, o l'IP corrisponde.

Gli intervalli IP funzionano per segmento, non per pattern

I caratteri jolly IP sono deliberatamente più restrittivi di quelli per email e nomi. Un IP con carattere jolly deve essere IPv4 in forma segmentata: esattamente quattro segmenti separati da punti. Ciascuno è o un numero normale da 0 a 255 o un singolo *, con almeno un numero reale da qualche parte.

Quindi 192.168.1.*, 192.168.*.1 e 192.*.*.1 sono tutti validi. Questi non lo sono:

• *.*.*.*, perché nessun segmento è un numero reale
• 19*.168.1.1, perché un segmento deve essere composto interamente da cifre o interamente da caratteri jolly, mai un mix
• 1.2.3.*.5, perché sono cinque segmenti
• 2001:db8::*, perché i caratteri jolly IPv6 non sono supportati

La notazione CIDR è fuori dall'ambito di questa release. Gli indirizzi IPv4 e IPv6 esatti funzionano ancora come prima. L'IP del client viene risolto tramite l'helper di geolocalizzazione di WooCommerce, che tiene già conto delle intestazioni proxy e inoltrate comuni che si ottengono dietro una CDN.

I valori che Checkout Guard rifiuta di salvare

Una regola che corrisponde a tutti non è una regola di blocco, è un'interruzione. Checkout Guard rifiuta due forme esplicitamente, nella finestra di dialogo dell'amministratore e di nuovo sull'API REST.

Il primo è un carattere jolly nudo. Se la rimozione degli asterischi, degli spazi bianchi e dei caratteri separatori da un valore non lascia nulla, il valore viene rifiutato. Ciò copre *, **, * *, e anche quelli più subdoli come *@*, *.* e *@*.*, ognuno dei quali corrisponderebbe a ogni candidato nel suo campo. Un valore come *@example.com sopravvive allo stesso test perché rimane examplecom, quindi è un modello piuttosto che un tuttofare.

Il secondo è l'ampiezza. Un singolo valore può utilizzare al massimo cinque asterischi. Sei o più vengono rifiutati al momento del salvataggio. C'è anche una seconda protezione al momento della corrispondenza. Se una regola più ampia di cinque caratteri jolly finisce per essere memorizzata, il sistema di corrispondenza la salta e scrive nel registro di debug piuttosto che compilare un'espressione aperta ad ogni checkout.

Entrambi i controlli esistono sul server e sono rispecchiati nella finestra di dialogo dell'amministratore in modo da ottenere l'errore in linea anziché dopo un viaggio di andata e ritorno. Il server è l'autorità. Se i due dovessero mai divergere, la scrittura fallisce in modo pulito anziché memorizzare qualcosa di errato.

Aggiungere la tua prima regola jolly

Per bloccare un dominio email in WooCommerce, vai su WooCommerce → Checkout Guard e apri la scheda Voci bloccate, quindi aggiungi una voce. La finestra di dialogo è la stessa che hai usato finora, con nuovo testo di suggerimento sotto ogni campo:

1. Nome e Cognome mostrano Usa * come carattere jolly, ad esempio jo* e Usa * come carattere jolly, ad esempio sm*th.
2. Indirizzo email mostra Usa * come carattere jolly, ad esempio *@example.com.
3. Indirizzo IP spiega la regola più restrittiva: un singolo indirizzo IPv4 o IPv6 per una corrispondenza esatta, o un modello di segmento IPv4 con caratteri jolly come 192.168.1.*. Ti ricorda anche che gli indirizzi IP sono dati personali, che il Considerando 30 del GDPR classifica come identificatori online, quindi conservali in linea con i tuoi obblighi di privacy.
4. Salva la voce.

L'applicazione non si è mossa. La regola si applica al checkout con shortcode classico e al checkout a blocchi tramite Store API, poiché entrambi i percorsi passano attraverso lo stesso matcher. Un acquirente bloccato vede il messaggio che hai scritto nell'impostazione Messaggio di negazione del checkout, il carrello viene svuotato e non viene tentato alcun pagamento. Se non hai mai toccato quell'impostazione, quella predefinita dice: “Spiacenti, al momento non è possibile effettuare un ordine, si prega di contattare il supporto.”

Cosa abbiamo visto: i proprietari di negozi che ottengono il massimo da questo sono quelli che scrivono il pattern in modo restrittivo e la nota in modo ampio. Bloccare *@somedisposabledomain.com è una buona mossa. Bloccare *@gmail.com perché tre ordini non validi hanno utilizzato Gmail è il modo in cui perdi silenziosamente un mese di vendite legittime, e nulla nel plugin ti fermerà, perché quella regola è tecnicamente valida. I caratteri jolly premiano la precisione, quindi controlla cosa copre un pattern prima che vada online.

Jolly tramite l'API REST

L'API REST di Checkout Guard sotto lo spazio dei nomi cgfw/v1 accetta anche valori jolly, su singole creazioni, aggiornamenti e l'endpoint batch. Ciò è importante se si desidera bloccare un dominio email in WooCommerce da un servizio di punteggio frodi o da un'automazione di helpdesk. Ogni route richiede la capacità manage_woocommerce e i chiamanti automatici dovrebbero autenticarsi con una password applicazione WordPress piuttosto che con un cookie, secondo la documentazione sulle password applicazione di WordPress.

Due comportamenti vale la pena conoscere prima di collegare qualsiasi cosa:

POST /check, l'endpoint che risponde “questo cliente verrebbe bloccato”, rimane rigoroso. Un candidato al controllo è un valore cliente reale e mai un pattern, quindi un asterisco in qualsiasi campo lì restituisce un 400. Le ricerche delle regole vanno nell'altro verso: GET /entries?email=*@example.com trova quella regola memorizzata esatta, perché le ricerche confrontano letteralmente e non espandono mai un carattere jolly. Per lo stesso motivo, una regola jolly e una regola letterale con caratteri identici sono sempre due voci distinte, quindi la deduplicazione non può unirle silenziosamente.

Nelle creazioni batch, un elemento con un carattere jolly nudo viene saltato e conteggiato nel totale skipped della risposta invece di fallire l'intera richiesta. Ciò corrisponde a come venivano già gestiti gli IP malformati.

Un'unica cosa da controllare prima di aggiornare

C'è un singolo caso limite, e vale due minuti del tuo tempo. Una voce salvata prima di questa release che contiene un asterisco letterale in un campo nome verrà ora letta come un pattern invece che come quel carattere. Nessuna migrazione viene eseguita, perché indovinare l'intento sarebbe peggio del cambiamento stesso.

Se la tua lista di blocco è corta, scorri. Se è lunga, estraila da GET /entries e cerca gli asterischi. Quasi nessuno ha un cliente con un asterisco nel proprio cognome, ma quasi nessuno non è la stessa cosa di nessuno.

Le regole senza asterisco non vengono assolutamente toccate. Il confronto per queste è byte per byte come era prima, quindi la stragrande maggioranza delle liste di blocco esistenti si comporta in modo identico dopo l'aggiornamento.

Ora puoi bloccare un dominio email in WooCommerce con una regola jolly, in Checkout Guard 1.0.2. Stai ancora decidendo se una lista di blocco è lo strumento giusto per la tua situazione? Le nostre guide su come bloccare un cliente su WooCommerce e cosa fa un plugin per la lista di blocco di WooCommerce sono il punto di partenza.

Domande Frequenti

Posso bloccare un dominio email in WooCommerce?

Sì. Per bloccare un dominio email in WooCommerce, aggiungi una regola di Checkout Guard con il valore email *@example.com e ogni indirizzo di quel dominio viene bloccato al checkout. La corrispondenza non fa distinzione tra maiuscole e minuscole e copre sia i checkout degli ospiti che quelli dei clienti registrati.

Le mie regole di blocco esistenti funzionano ancora dopo l'aggiornamento?

Sì. Qualsiasi regola che non contenga un asterisco viene confrontata esattamente come prima. L'unica eccezione è una regola preesistente con un asterisco letterale in un campo nome, che ora verrà trattata come un pattern jolly.

Posso usare un jolly per bloccare un intervallo di IP?

Puoi bloccare un intervallo IPv4 per segmento, ad esempio 192.168.1.* o 192.*.*.1. Ciascuno dei quattro segmenti deve essere un numero da 0 a 255 o un singolo asterisco, e almeno un segmento deve essere un numero. La notazione CIDR e i caratteri jolly IPv6 non sono supportati.

Perché la mia regola jolly è stata rifiutata?

Due valori vengono rifiutati. Un carattere jolly nudo come *, *@* o *.* viene rifiutato perché corrisponderebbe a ogni cliente. Un valore che utilizza più di cinque asterischi viene rifiutato per lo stesso motivo. Aggiungi almeno un carattere letterale e mantieni il pattern sotto i sei caratteri jolly.

Il blocco jolly funziona sul checkout bloccato?

Sì. Il checkout con shortcode classico e il checkout bloccato utilizzano entrambi lo stesso codice di corrispondenza, quindi una regola jolly si comporta in modo identico su entrambi. L'acquirente bloccato vede il tuo messaggio di rifiuto personalizzato e non viene tentato alcun pagamento.

Posso aggiungere regole jolly da un sistema esterno?

Sì. L'API REST di Checkout Guard accetta valori jolly nelle operazioni di creazione, aggiornamento e creazione batch, autenticata con una password applicativa da un utente con la capacità manage_woocommerce. L'endpoint POST /check è l'eccezione e rifiuta i caratteri jolly, poiché testa valori di clienti reali piuttosto che pattern.