Risoluzione dei problemi di connessione

La maggior parte dei problemi di connessione deriva dalla configurazione del server o da un firewall. Ecco i casi più frequenti e le relative soluzioni.

401 / sito protetto

Un sito fortemente protetto può bloccare la connessione necessaria per l'autorizzazione e restituire un errore 401 nella pagina di autorizzazione. Assicurarsi che il flusso di accesso (componente utenti) rimanga accessibile per consentire il passaggio OAuth.

Blocco ModSec/WAF

Alcuni firewall applicativi (WAF, ModSecurity) bloccano lo user agent del client e restituiscono 403 su /api/…/mcp. La soluzione consiste nell'escludere il percorso del server MCP dalle regole interessate.

Download ID troncato

Non è legato all'accesso, ma è un problema frequente: un Download ID inserito solo parzialmente impedisce l'aggiornamento delle estensioni a pagamento. Verificare che sia incollato per intero nelle impostazioni degli aggiornamenti di Joomla.

Checklist

• sito servito in HTTPS con un certificato valido;
• riscrittura degli URL attiva;
• documenti .well-known accessibili;
• plugin Senso MCP attivati;
• percorso del server MCP non bloccato dal WAF.