TR EN

CORS Hatası Çözümü: No 'Access-Control-Allow-Origin' Header

CORS hatasında sunucu erişim kurallarını değiştirmeden önce tarayıcı isteğini, ön kontrolü, gerçek yanıtı ve izin verilen kökenleri inceleyin.

Önce başarısız isteği belirleyin

CORS, tarayıcıdaki kodun farklı kökenden gelen yanıtı okuyup okuyamayacağını belirler. Bazı istekler tarayıcı yanıtı engellese de sunucuya ulaşabilir; CORS kimlik doğrulama veya CSRF koruması değildir. Eksik başlık; 401, 403, 500, yönlendirme, ağ veya TLS hatasıyla birlikte görülebilir. Erişim kurallarını değiştirmeden asıl hatayı inceleyin.

1. Tarayıcı Network panelini inceleyin

Başarısız isteğin Origin, URL, yöntem ve durum koduna; ayrı bir OPTIONS ön kontrolünün başarısız olup olmadığına bakın. Köken; protokol, sunucu adı ve porttan oluşur. Çerezleri, tokenları, sorgu dizelerini veya özel verileri hata kaydına kopyalamayın.

2. Ön kontrolü ve gerçek yanıtı ayrı inceleyin

Terminalden, yönettiğiniz bir uç noktaya sentetik test uygulayın. İki örnek adresi, yöntem ve başlık listesini kendi yetkili testinize göre değiştirin; kimlik bilgisi eklemeyin:

curl -i -X OPTIONS 'https://api.example.test/resource' \
  -H 'Origin: https://app.example.test' \
  -H 'Access-Control-Request-Method: POST' \
  -H 'Access-Control-Request-Headers: content-type'

Ön kontrol yanıtının durumunu ve izin verilen köken, yöntem ve başlıkları tarayıcı isteğiyle karşılaştırın. Ardından hata yanıtları dahil gerçek yanıtı inceleyin. Başarılı OPTIONS tek başına gerçek isteğin başarılı olduğunu göstermez. Bazı isteklerde ön kontrol oluşmaz. Curl tarayıcının CORS denetimini uygulamaz; gerçek senaryoyu tarayıcıda da doğrulayın.

3. Politikayı uygulamanıza göre belirleyin

  • Özel API için yalnız gereken kökenleri, yöntemleri ve başlıkları izin listesine alın; CORS sunucudaki yetkilendirmenin yerine geçmez.
  • Tarayıcı çerez gibi kimlik bilgileri gönderiyorsa yanıtta izin verilen tam köken ve Access-Control-Allow-Credentials: true gerekir; Access-Control-Allow-Origin: * kimlik bilgili tarayıcı isteğiyle uyumlu değildir. SameSite ve üçüncü taraf çerez kuralları çerezi ayrıca engelleyebilir.
  • Herkese açık ve kimlik bilgisiz bir kaynakta wildcard uygun olabilir. Gelen her Origin değerini otomatik yansıtmayın. Yanıt kökene göre değişiyorsa Vary: Origin ekleyip önbellek davranışını inceleyin.
  • CORS politikasını uygulama veya ters proxy gibi kontrollü tek katmanda yönetin; yinelenen başlıklardan kaçının. Mevcut upstream yönlendirmesini ve kimlik doğrulamayı koruyun; Nginx location bloğunu doğrudan değiştirmek uygulamayı bozabilir.

4. Olumlu ve olumsuz kontrol yapın

İzinli kökenle, ardından özellikle izin verilmeyen bir test kökeniyle deneyin. Ön kontrolü, gerçek yanıtı, yöntem/başlıkları, tarayıcının kimlik bilgisi politikasını ve bir hata yanıtını doğrulayın. İzin verilmeyen köken CORS izni almamalıdır. Sunucu tarafı kimlik doğrulama ve yetkilendirmenin yetkisiz işlemleri ayrıca reddettiğini kontrol edin. Tarayıcı güvenliğini kapatmayın veya sınırsız proxy açmayın.

Kaynaklar: MDN CORS rehberi, Express CORS middleware. İlgili: Laravel 419 oturum ve CSRF kontrolleri. Gözden geçirme: 14 Kasım 2026.

Sıkça Sorulan Sorular

CORS hatası frontend kodundan çözülebilir mi?
İstemci yanlış URL veya istek modunu düzeltebilir; ancak kendisine sunucu CORS izni veremez. Kontrol ettiğiniz proxy ayrı bir sunucu bileşenidir.
Access-Control-Allow-Origin: * yapmak güvenli midir?
Herkese açık, kimlik bilgisi gerektirmeyen kaynaklarda uygun olabilir. Kimlik bilgili tarayıcı isteklerinde izinli köken ve kimlik bilgisi izni açıkça belirtilmelidir.