Adamant Solutions

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-Origin con 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 aggiungi Access-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

Hai ancora difficoltà o stai progettando il flusso della tua API?

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