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.
