Ora puoi configurare Protezione bot di Kinsta e recuperare dati analitici dettagliati sul traffico dei bot tramite l’API di Kinsta.

Abbiamo aggiunto 13 nuovi endpoint che permettono di controllare e modificare i livelli di protezione, bloccare i crawler AI, gestire le impostazioni di automazione di WordPress e creare regole di eccezione personalizzate. Puoi anche recuperare dati analitici che mostrano come viene classificato il traffico, come vengono gestite le richieste e quali fonti generano la maggior parte dell’attività.

Queste novità ti permettono di integrare la protezione dai bot nei tuoi strumenti di gestione del sito, nei sistemi di monitoraggio e nei flussi di lavoro automatizzati.

Controlla e modifica i livelli di Protezione bot

Due nuovi endpoint ti permettono di recuperare e modificare il livello di Protezione bot per un ambiente WordPress.

L’endpoint Get bot protection level restituisce la configurazione attuale dell’ambiente:

curl --request GET \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/level \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Ad esempio, la risposta qui sotto mostra che l’ambiente è configurato per bloccare il traffico automatizzato:

{
  "bot_protection": {
    "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "level": "block-automations"
  }
}

Puoi usare il nuovo endpoint Set bot protection level per passare da uno all’altro dei quattro livelli supportati:

  • block-malicious-traffic blocca il traffico dannoso noto come parte della protezione di base di Kinsta.
  • block-automations blocca il traffico automatizzato e dannoso.
  • challenge-bots sottopone a verifica anche i potenziali bot e il traffico non classificato.
  • challenge-everyone applica le verifiche a tutto il traffico non verificato, compresi i visitatori che potrebbero essere umani.

Ad esempio, se un sito subisce un aumento di scraping o di richieste automatizzate sospette, puoi passare al livello “Verifica bot”:

curl --request PUT \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/level \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "level": "challenge-bots"
  }'

L’API restituisce una risposta 202 con un ID operazione:

{
  "message": "Setting a bot protection level in progress. Use the operation_id to check the status.",
  "status": 202,
  "operation_id": "environment:set-bot-protection-level-54fb80af-576c-4fdc-ba4f-b596c83f15a1"
}

Puoi utilizzare l’operation_id restituito per monitorare la richiesta fino al completamento della modifica.

Livelli di protezione più elevati possono influire sulle richieste automatizzate legittime e, al livello più restrittivo, creare difficoltà per i visitatori. Verifica come il livello selezionato influisce sul traffico normale del tuo sito prima di applicarlo su scala più ampia.

Blocca o sblocca i crawler AI

L’API fornisce anche due endpoint per gestire l’impostazione “Blocca crawler AI”. Puoi usare l’endpoint Get AI crawler block status per verificare se il blocco è abilitato:

curl --request GET \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/ai-crawlers \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

La risposta include il campo ai_crawlers_blocking, che indica se l’impostazione è enabled o disabled.

Per modificare l’impostazione, invia una richiesta PUT allo stesso percorso:

curl --request PUT \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/ai-crawlers \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "status": "enabled"
  }'

Impostando status su enabled si bloccano i crawler AI, compresi quelli verificati che raccolgono contenuti dal sito web per l’addestramento dell’AI e scopi correlati. Usa disabled per disattivare questa restrizione specifica.

L’impostazione “Blocca crawler AI” di Kinsta non blocca i crawler tradizionali dei motori di ricerca come Googlebot e Bingbot, i crawler di ricerca AI come OAI-SearchBot, né gli agenti AI avviati dagli utenti come ChatGPT-User. Tuttavia, le richieste provenienti da queste fonti potrebbero comunque essere sottoposte a controlli più rigorosi in caso di comportamenti eccessivi.

Questo ti offre un controllo separato sulla raccolta automatizzata di contenuti tramite AI senza modificare il livello di protezione generale del tuo sito.

Consulta la documentazione API su come bloccare o sbloccare i crawler AI per i dettagli completi sulle richieste e le risposte.

Controlla le automazioni di WordPress

Alcune funzionalità e integrazioni di WordPress si basano su richieste automatizzate al tuo sito. Queste possono includere servizi esterni che accedono all’API REST di WordPress, plugin che scambiano dati con servizi di terze parti o piattaforme di automazione che inviano webhook.

Due nuovi endpoint ti permettono di verificare e controllare se le tipiche automazioni di WordPress sono consentite dalla protezione bot.

L’endpoint Get WP automations allow status restituisce l’impostazione corrente:

{
  "bot_protection": {
    "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "wp_automations": "enabled"
  }
}

Puoi quindi utilizzare l’endpoint Allow or block WP automations per modificarla. Ad esempio, la seguente richiesta abilita le automazioni tipiche di WordPress:

curl --request PUT \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/wp-automations \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "status": "enabled"
  }'

La richiesta restituisce un ID operazione che puoi usare per tenere traccia della modifica. Questa impostazione utilizza una lista di autorizzazioni gestita da Kinsta che include endpoint e servizi WordPress comuni. Può essere utile quando una protezione dai bot più rigorosa interferisce con un’integrazione esterna o un processo automatizzato da cui dipende il tuo sito.

Le richieste provenienti dal container del sito stesso o dall’infrastruttura interna gestita da Kinsta sono già consentite, quindi le normali attività interne di WordPress non sono influenzate da questa impostazione.

Aggiungi, recupera e rimuovi le eccezioni a Protezione bot

A volte servono regole più specifiche rispetto a quelle offerte da un livello di protezione generale. Ad esempio, potresti voler consentire le richieste provenienti da un servizio di monitoraggio affidabile, continuando però a bloccare il resto del traffico automatizzato.

Tre nuovi endpoint permettono di gestire le eccezioni a Protezione bot per i singoli ambienti WordPress.

Puoi creare un’eccezione utilizzando l’endpoint Add bot protection exception rule. Ogni regola ha tre campi obbligatori:

  • type identifica cosa confrontare: ip, path, user_agent o country.
  • action determina cosa succede al traffico corrispondente: skip, challenge o block.
  • value contiene l’indirizzo IP, il percorso, l’user agent o il paese da abbinare.

Ad esempio, la seguente richiesta aggiunge un’eccezione che permette alle richieste provenienti da un indirizzo IP affidabile di bypassare le regole di Protezione bot:

curl --request POST \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/exception-rules \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "ip",
    "action": "skip",
    "value": "192.0.2.1"
  }'

L’API restituisce un ID operazione quando accetta la richiesta. Per controllare le eccezioni configurate, usa l’endpoint Get bot protection exception rules:

curl --request GET \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/exception-rules \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

La risposta elenca le regole, inclusi i loro ID, i valori corrispondenti e le azioni:

{
  "bot_protection": {
    "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "exception_rules": [
      {
        "id": "ip:skip:192.0.2.1",
        "type": "ip",
        "action": "skip",
        "value": "192.0.2.1"
      }
    ],
    "has_custom_waf_rules": false
  }
}

Puoi usare l’ID della regola con il nuovo endpoint Remove bot protection exception rule:

curl --request DELETE \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/exception-rules \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "exception_rule_id": "ip:skip:192.0.2.1"
  }'

Le eccezioni si applicano ai singoli ambienti, quindi una regola creata per un ambiente di staging non si applica automaticamente all’ambiente di produzione.

L’azione skip aggira le regole di Protezione bot, ma non sovrascrive la sicurezza della piattaforma sottostante di Kinsta né la protezione dalle vulnerabilità.

Analizza il traffico dei bot tramite l’API

Oltre ai nove endpoint per la gestione di Protezione bot, abbiamo aggiunto quattro endpoint alla sezione Statistiche.

Questi forniscono dati sulle richieste che raggiungono il tuo sito, su come Kinsta classifica quel traffico e su cosa succede a quelle richieste dopo che la protezione dai bot le ha valutate.

Scopri come la protezione dai bot gestisce il traffico in entrata

Il nuovo endpoint Get bot traffic flow restituisce i totali delle richieste per classificazione del traffico e risultato della protezione.

Puoi usarlo per vedere quante richieste sono state classificate come “probabilmente persone”, “probabilmente bot”, “crawler AI” o altri tipi di traffico, e quante sono state consentite, sottoposte a verifica o bloccate.

Ad esempio, la seguente richiesta recupera i dati degli ultimi 30 giorni:

curl --request GET \
  --url 'https://api.kinsta.com/v2/sites/environments/{env_id}/analytics/bot-protection/traffic-flow?company_id={company_id}&time_span=30_days' \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

La risposta contiene tre sezioni principali all’interno di traffic_flow: traffic_types, results e flows. L’oggetto flows collega ogni classificazione del traffico ai relativi esiti di protezione.

Questo ti permette di vedere cosa è successo al traffico, invece di limitarti a guardare solo il conteggio complessivo delle richieste bloccate.

Tieni traccia del traffico bot e dei risultati di protezione nel tempo

Due endpoint aggiuntivi forniscono analisi delle serie temporali:

Entrambi restituiscono dati orari quando time_span è impostato su 24_hours e dati giornalieri per periodi più lunghi.

Ad esempio, l’endpoint requests-over-time restituisce i dati in questo formato:

{
  "analytics": {
    "requests_over_time": [
      {
        "traffic_type": "likely_humans",
        "label": "Likely humans",
        "total": 10572,
        "timeline": [
          {
            "date": "2026-09-14T00:00:00.000Z",
            "requests": 5286
          }
        ]
      }
    ]
  }
}

Questi dati possono aiutarti a indagare su aumenti insoliti del traffico e a verificare se le modifiche alle impostazioni di Protezione bot influenzano il numero di richieste sottoposte a verifica o bloccate.

Identifica le principali fonti di traffico dei bot

Il nuovo endpoint Get bot traffic top breakdown fornisce maggiori dettagli sulle fonti alla base di ciascuna classificazione del traffico. Restituisce i percorsi, gli user agent, i paesi e gli indirizzi IP più richiesti, insieme al numero di richieste corrispondenti.

Ad esempio, se il tuo sito registra un improvviso aumento di richieste automatizzate, puoi verificare se tali richieste si concentrano su /wp-login.php, su un particolare percorso API o provengono da indirizzi IP specifici.

L’endpoint restituisce le informazioni sotto analytics.top_requests_breakdown, con array separati top_paths, top_user_agents, top_countries e top_ips per ogni categoria di traffico.

Tutti e quattro i nuovi endpoint di analisi supportano 24_hours, 7_days, 30_days e 60_days, con 7_days come impostazione predefinita. Puoi anche usare i parametri opzionali from e to per richiedere un intervallo di date personalizzato. Ogni richiesta richiede un parametro di query company_id.

Integra Protezione bot nei tuoi flussi di lavoro di gestione del sito

Con questi endpoint, puoi includere le impostazioni di Protezione bot insieme alle altre attività gestite tramite l’API di Kinsta.

Ad esempio, uno strumento di monitoraggio può recuperare le analisi del traffico dei bot durante un picco di traffico, mentre un sistema di gestione interno può verificare il livello di protezione attuale di un ambiente e applicare un’impostazione diversa quando necessario. Puoi anche gestire le eccezioni per i servizi affidabili senza dover configurare manualmente ogni ambiente.

Trovi i formati completi di richiesta e risposta nella guida di riferimento dell’API sulla protezione bot di WordPress e nella documentazione sulle statistiche dell’API di Kinsta.