Errore CORS: bloccato dalla policy CORS
CORS è una regola applicata dal browser, non dalla tua API: una pagina può leggere risposte da un’altra origine solo se questa lo consente tramite gli header Access-Control-Allow-*. Per questo l’API spesso funziona con curl o Postman ma non nel browser. Rispondi alle domande per capire quale header manca. La correzione è quasi sempre sul server, non nel frontend.
Individua la causa
Tutte le cause e le soluzioni
Non è un errore CORS: la richiesta non ha raggiunto un server
- Controlla URL, DNS, certificato TLS, contenuti misti (API http chiamata da pagina https), blocchi pubblicitari o VPN. Un errore di rete può apparire come errore CORS.
- Prova l’URL direttamente nella barra degli indirizzi o con curl.
Il preflight viene rifiutato dall’autenticazione
- Il browser invia il preflight OPTIONS senza header Authorization e senza cookie. Se gateway o middleware richiedono un token per ogni metodo, il preflight riceve 401 o 403 e la chiamata reale non parte.
- Consenti OPTIONS prima dell’autenticazione oppure gestisci CORS in un livello precedente.
- In WSO2 API Manager e nella maggior parte dei gateway abilita la configurazione CORS integrata per l’API, senza autenticare OPTIONS.
Il metodo OPTIONS non è gestito
- La route o il framework restituisce 404 o 405 per OPTIONS. Aggiungi un gestore o abilita il middleware CORS, che risponde automaticamente ai preflight.
- Anche un reverse proxy o API gateway può bloccare OPTIONS: consentilo.
Un header della richiesta non è consentito
- Header come Authorization o Content-Type diverso dai formati form e text/plain rendono la richiesta «non semplice» e attivano il preflight. Il server deve elencarli in
Access-Control-Allow-Headers. - Aggiungi i nomi esatti degli header inviati (senza distinzione tra maiuscole e minuscole), ad esempio
Authorization, Content-Type. - Un header personalizzato aggiunto da una libreria (per esempio un ID di traccia o correlazione) può sorprendere: controlla Access-Control-Request-Headers del preflight.
Il metodo HTTP non è consentito
- Inserisci i metodi usati in
Access-Control-Allow-Methods(GET, POST, PUT, PATCH, DELETE, OPTIONS). GET, HEAD e POST non richiedono preflight solo se gli header sono semplici.
La risposta non contiene header CORS
- Add
Access-Control-Allow-Origincon l’origine esatta del frontend (schema, host e porta, senza percorso) oppure su * per dati pubblici senza credenziali. - Gli header devono comparire sulla risposta effettiva e anche sugli errori (401, 404, 500): senza CORS l’errore del server nasconde lo stato reale e appare come errore CORS.
- Verifica che gateway, CDN o proxy non rimuovano gli header né memorizzino risposte destinate a un’altra origine.
L’origine wildcard non può essere usata con credenziali
- Se la richiesta include credenziali,
Access-Control-Allow-Origin: *il browser rifiuta la risposta. Restituisci l’origine specifica da una allow-list (non copiare alla cieca Origin della richiesta) e aggiungiAccess-Control-Allow-Credentials: true. - La stessa regola vale per * in Allow-Headers e Allow-Methods nelle richieste con credenziali.
Manca Access-Control-Allow-Credentials
- Per richieste con cookie o autenticazione HTTP, la risposta deve contenere
Access-Control-Allow-Credentials: true, e l’origine deve essere specifica.
La cache mescola risposte per origini diverse
- Se il server restituisce valori Access-Control-Allow-Origin diversi in base all’origine, deve aggiungere
Vary: Origin, altrimenti la cache può servire una risposta destinata a un’altra origine e il browser la rifiuta in modo intermittente. - Controlla le regole di cache della CDN e del gateway per le risposte con header CORS.
Domande frequenti
Perché l’API funziona con Postman o curl ma non nel browser?
Postman e curl non applicano i controlli CORS. Il browser li applica per proteggere gli utenti, quindi l’API deve inviare gli header Access-Control corretti per i client web.
Posso correggere CORS nel codice frontend?
No. Gli header devono essere inviati dal server o dal gateway. Come soluzione temporanea si può usare un proxy sul proprio dominio; una richiesta no-cors restituisce invece una risposta opaca, che il codice non può leggere.
Access-Control-Allow-Origin: * è sicuro?
È comune per dati pubblici in sola lettura senza credenziali. Se usi cookie o token, imposta una lista consentita di origini esatte.
Informazioni sulla pagina
Le risposte non vengono inviate: le domande funzionano nel browser. Se incolli dati negli strumenti collegati, leggi le note sulla privacy e usa dati di test. Consulta l’informativa sulla privacy.
Correlati: tester richieste HTTP con diagnosi CORS · codici di stato HTTP · diagnostica errori OAuth2 · tutte le guide agli errori
Configuriamo e verifichiamo OAuth2/OIDC e API gateway, inclusi WSO2 Identity Server e API Manager. Scopri i servizi WSO2 o la revisione di sicurezza.
Scrivici su LinkedIn