ANKA MÜHENDİSLİKSincan / Ankara
Web • Orta

CORS nedir?

Cross-Origin Resource Sharing (Kökenler Arası Kaynak Paylaşımı)

Tarayıcının, bir sitenin başka bir kökendeki kaynağa erişmesine hangi koşullarda izin vereceğini belirleyen mekanizma.

Tarayıcılar güvenlik için Aynı Köken Politikası'nı (Same-Origin Policy) uygular: bir sayfadaki JavaScript, varsayılan olarak yalnızca aynı kökendeki (protokol + alan adı + port aynı) kaynakların yanıtını okuyabilir. Örneğin https://site.com üzerindeki kod, https://api.baska.com'dan gelen yanıtı okuyamaz. CORS, sunucunun belirli başlıklar göndererek bu kısıtlamayı kontrollü biçimde gevşetmesini sağlayan standarttır.

Sunucu, yanıtına Access-Control-Allow-Origin başlığı ekleyerek hangi kökenlerin yanıtı okuyabileceğini bildirir. Özel başlık içeren veya GET/POST dışındaki metotları kullanan istekler için tarayıcı önce OPTIONS metoduyla bir ön kontrol (preflight) isteği gönderir; sunucu izin verirse asıl istek yapılır.

Sık karşılaşılan yanılgı, CORS hatasının istemci tarafında düzeltilebileceğini düşünmektir. CORS izni sunucunun vereceği bir karardır; düzeltme API sunucusunun yapılandırmasında yapılır. Ayrıca CORS bir sunucu koruma mekanizması değildir: curl gibi tarayıcı dışı araçlar bu kurala tabi değildir, bu yüzden API'nizi yine kimlik doğrulama ve yetkilendirmeyle korumanız gerekir.

Örnek: Express.js'te yalnızca belirli bir kökene izin verme

app.use((req, res, next) => {
  res.setHeader('Access-Control-Allow-Origin', 'https://www.ornekokul.com');
  res.setHeader('Access-Control-Allow-Methods', 'GET, POST');
  res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
  if (req.method === 'OPTIONS') return res.sendStatus(204);
  next();
});

İpuçları

  • Kimlik bilgisi (çerez) gönderilen API'lerde Access-Control-Allow-Origin değerini * yapmayın; izinli kökenleri açıkça listeleyin.
  • CORS hatası tarayıcı konsolunda görünür ama çözümü sunucu tarafındadır.