API Key Akismet: Come Ottenere, Configurare e Verificare
La API key di Akismet è l’elemento fondamentale che permette al plugin di comunicare con i server di Automattic per analizzare i commenti e le sottomissioni dei form. Senza una chiave API valida, Akismet non può funzionare. In questa guida completa vedremo passo dopo passo come ottenere la chiave, come configurarla correttamente nel tuo sito WordPress e come verificare che tutto funzioni a dovere.
Cos’è la API Key di Akismet
La API key (Application Programming Interface key) è una stringa alfanumerica univoca che identifica il tuo account Akismet. Funziona come una “password” che il plugin utilizza per autenticarsi presso i server di Akismet ogni volta che deve verificare un commento. Ogni chiave è legata a un account WordPress.com e può essere utilizzata su più siti contemporaneamente (a seconda del piano scelto).
La chiave API non va confusa con una password di accesso: non permette di accedere alla dashboard di WordPress, ma abilita esclusivamente la comunicazione tra il plugin e l’infrastruttura cloud di Akismet.
Come Ottenere una API Key Gratuita
Akismet offre un piano gratuito per i siti personali non commerciali. Ecco come ottenere la chiave:
- Vai su akismet.com/account/
- Se hai già un account WordPress.com, clicca su Sign in. Altrimenti, crea un nuovo account cliccando su Sign up
- Dopo il login, vedrai la pagina dei piani. Seleziona il piano Personal
- Nella pagina di pagamento, troverai un cursore per il prezzo. Trascinalo completamente a sinistra fino a raggiungere 0 €/anno
- Compila il form con il tuo nome e l’URL del tuo sito personale
- Conferma che il sito non ha pubblicità, non vende prodotti/servizi e non è un sito aziendale
- Clicca su Continue with Personal subscription
- Riceverai la API key via email e la vedrai anche nella pagina del tuo account
Nota importante: Il piano gratuito è riservato esclusivamente a blog e siti personali senza finalità commerciali. Se il tuo sito ha banner pubblicitari, vende prodotti o servizi, o appartiene a un’azienda, sei tenuto a scegliere un piano a pagamento.
Piani a Pagamento: Plus, Enterprise e Beyond
Per i siti commerciali, Akismet offre diversi piani a pagamento:
- Plus (circa 8,33 €/mese): Per un singolo sito commerciale. Include supporto prioritario e nessun limite di chiamate API
- Enterprise (circa 41,67 €/mese): Per siti ad alto traffico o network di siti. Include SLA garantiti e supporto dedicato
- Enterprise Plus: Soluzione personalizzata per grandi organizzazioni con esigenze specifiche
In tutti i piani a pagamento, la API key viene generata immediatamente dopo il completamento del pagamento.
Come Inserire la API Key in WordPress
Una volta ottenuta la chiave, ci sono diversi metodi per inserirla nel tuo sito WordPress:
Metodo 1: Tramite l’interfaccia di amministrazione
Questo è il metodo più semplice e consigliato per la maggior parte degli utenti:
- Accedi alla dashboard di WordPress
- Vai su Impostazioni → Akismet Anti-Spam
- Nel campo API Key, incolla la chiave ottenuta
- Clicca su Verifica con chiave
- Se la chiave è valida, vedrai un messaggio di conferma verde
Metodo 2: Tramite wp-config.php
Per gli sviluppatori e i gestori di più siti, è possibile definire la chiave API direttamente nel file wp-config.php:
define(WPCOM_API_KEY, la-tua-api-key-qui);
Questa costante deve essere inserita prima della riga /* That’s all, stop editing! */. Quando la chiave è definita in questo modo, il campo nell’interfaccia di amministrazione viene disabilitato e mostra la chiave come “definita nel file di configurazione”.
Questo metodo è particolarmente utile in diversi scenari:
- Deployment automatizzato: La chiave viene gestita come parte della configurazione del sito
- Multisite: Una singola chiave può essere condivisa tra tutti i siti della rete
- Sicurezza: La chiave non è modificabile dall’interfaccia web, riducendo il rischio di manomissioni
- Version control: La chiave può essere gestita tramite variabili d’ambiente nei sistemi CI/CD
Metodo 3: Tramite WP-CLI
Se hai accesso alla riga di comando del server, puoi configurare la chiave API tramite WP-CLI:
wp option update wordpress_api_key la-tua-api-key-qui
Per verificare la chiave attualmente configurata:
wp option get wordpress_api_key
Come Verificare la API Key
Dopo aver inserito la chiave, è fondamentale verificare che funzioni correttamente. Ecco come farlo:
Dalla dashboard WordPress: Vai su Impostazioni → Akismet Anti-Spam. Se la chiave è valida, vedrai un segno di spunta verde accanto al campo API Key, insieme al tipo di piano associato.
Tramite l’API REST di Akismet: Puoi verificare la chiave programmaticamente inviando una richiesta HTTP:
curl -X POST https://rest.akismet.com/1.1/verify-key -d "key=la-tua-api-key&blog=https://tuosito.com"
La risposta sarà valid se la chiave è corretta, oppure invalid con un messaggio di errore descrittivo.
Tramite WP-CLI:
wp eval "echo Akismet::verify_key(get_option(wordpress_api_key));"
Problemi Comuni con la API Key
Ecco i problemi più frequenti relativi alla API key di Akismet e come risolverli:
Errore “Invalid API key”: La chiave inserita non è valida. Verifica di averla copiata correttamente, senza spazi iniziali o finali. Se l’errore persiste, genera una nuova chiave dal tuo account su akismet.com.
Errore “Could not connect to Akismet”: Il tuo server non riesce a comunicare con i server di Akismet. Questo può essere causato da un firewall che blocca le connessioni in uscita, da una configurazione DNS errata o da un problema temporaneo dei server di Akismet.
La chiave non viene salvata: Alcuni plugin di sicurezza o configurazioni di sicurezza del server possono impedire il salvataggio delle opzioni di WordPress. Verifica i log degli errori e prova a disattivare temporaneamente i plugin di sicurezza.
Piano scaduto: Se il tuo piano a pagamento è scaduto, la chiave API continuerà a funzionare ma con limitazioni. Rinnova il piano dal tuo account su akismet.com.
Chiave già in uso su troppi siti: Il piano Personal gratuito è limitato a un singolo sito. Se provi a utilizzare la stessa chiave su più siti, potresti ricevere un avviso. Per proteggere più siti, scegli un piano Plus o Enterprise.
Sicurezza della API Key
La API key di Akismet deve essere trattata come un dato sensibile. Ecco alcune raccomandazioni:
- Non condividere la chiave pubblicamente: Non pubblicarla su forum, repository GitHub pubblici o email non crittografate
- Non inserirla nel codice sorgente: Se utilizzi un sistema di version control come Git, usa variabili d’ambiente o file di configurazione esclusi dal repository (
.gitignore) - Ruota la chiave periodicamente: Puoi generare una nuova chiave dal tuo account su akismet.com se sospetti che quella attuale sia stata compromessa
- Limita l’accesso alla dashboard: Solo gli amministratori del sito dovrebbero poter vedere e modificare la chiave API
Gestire la API Key su Più Siti
Se gestisci diversi siti WordPress, esistono strategie per semplificare la gestione della API key:
- Una chiave per tutti i siti: Con un piano adeguato, puoi utilizzare la stessa chiave su tutti i tuoi siti. Questo semplifica la gestione ma non permette di distinguere le statistiche per sito nel pannello di Akismet
- Una chiave per sito: Creare un account separato per ogni sito offre statistiche indipendenti ma complica la gestione
- Gestione centralizzata: Strumenti come MainWP o ManageWP permettono di gestire le chiavi API di tutti i tuoi siti da un’unica dashboard
Quando Rigenerare la API Key
Ci sono situazioni in cui è consigliabile generare una nuova chiave API:
- Se la chiave attuale è stata esposta pubblicamente (ad esempio in un commit Git)
- Se noti attività anomale nelle statistiche di Akismet
- Se il sito è stato compromesso e ripristinato da un backup
- Se hai cambiato provider di hosting e vuoi ricominciare con una configurazione pulita
Per rigenerare la chiave, accedi al tuo account su akismet.com, vai nella sezione delle impostazioni dell’account e clicca su Regenerate API Key. La vecchia chiave verrà immediatamente invalidata.
Conclusione
La API key è il cuore pulsante di Akismet: senza di essa, il plugin è completamente inattivo. Ottenere e configurare la chiave è un processo rapido, ma è importante farlo correttamente per garantire una protezione anti-spam efficace. Ricorda di verificare periodicamente il funzionamento della chiave e di trattarla come un dato riservato.
Per assistenza nella configurazione di Akismet o per qualsiasi problema relativo alla API key, contatta il team di G Tech Group. I nostri specialisti WordPress sono pronti ad aiutarti.
Continua a Leggere
Questa guida fa parte della nostra serie completa su WordPress. Scopri anche:
- Guide Elementor – Impara a costruire pagine professionali con il page builder più popolare
- Guide WP Rocket – Ottimizza le prestazioni e la velocità del tuo sito
- Guide SEOPress – Migliora il posizionamento sui motori di ricerca
- Guide UpdraftPlus – Proteggi i tuoi dati con backup automatici
Per ulteriori guide, tutorial e approfondimenti sul mondo WordPress, visita il blog di G Tech Group. Se desideri un supporto professionale per il tuo progetto web, contattaci: il nostro team è pronto ad affiancarti in ogni fase.
Migliora il Tuo Sito WordPress
Scopri le nostre guide complete sugli altri plugin essenziali per WordPress: