CORS nedir?
Kısa tanım
CORS, bir web sayfasının başka bir alan adındaki kaynaklara tarayıcı üzerinden erişmesine sunucunun HTTP başlıklarıyla izin verip vermediğini belirleyen mekanizmadır; açılımı Cross-Origin Resource Sharing'dir.
Son güncelleme:
CORS nedir, tarayıcı neden bazı istekleri durdurur?
Mağazanızın vitrini bir alan adında, API'si başka bir alan adında çalışıyorsa tarayıcı, vitrindeki kodun API'ye doğrudan istek atmasına varsayılan olarak izin vermez. Bunun nedeni güvenliktir: bir site, başka bir sitedeki oturumunuzu kullanarak istek atmamalıdır. MDN'e göre CORS, sunucunun kendi alan adı dışındaki hangi kaynaklardan isteğe izin vereceğini belirtmesini sağlayan HTTP başlığı tabanlı bir mekanizmadır. Ayrıntılar MDN'in CORS sayfasında (yeni sekmede açılır) yer alır.
CORS hatası neden çıkar?
CORS hatası, tarayıcının istek yapılan sunucudan izin başlığını alamadığı durumda görülür. Sayfanın kodu isteği atar, sunucu yanıt verir ama yanıtta izin yoktur; tarayıcı yanıtı koda vermez ve konsola hata yazar. Sık nedenler şunlardır.
- Sunucu hiç CORS başlığı göndermiyor.
- İzin verilen alan adı listesinde sizin siteniz yok.
- Kullandığınız yöntem ya da başlık için ön kontrol isteği reddediliyor.
- Adres http ve https arasında karışık kullanılıyor.
CORS ayarı nasıl yapılır?
CORS ayarı, istek yapılan sunucuda yapılır, istek yapan sayfada değil. Sunucu, güvendiği alan adlarını yanıt başlığında bildirir. Başka bir sağlayıcının API'sine bağlanıyorsanız ayarı o sağlayıcının panelinden ya da destek ekibinden istemeniz gerekebilir. Çözüm sizde değilse, tarayıcıdan doğrudan istek yerine kendi sunucunuz üzerinden istek atmak yaygın bir yoldur.
Ön kontrol isteği nedir?
Bazı isteklerde tarayıcı, asıl isteği atmadan önce sunucuya bir ön kontrol isteği gönderir ve gerçek isteğe izin olup olmadığını sorar. Sunucu bu soruya doğru yanıt vermezse asıl istek hiç gönderilmez. Konsolda hata görüp sunucu günlüğünde asıl isteği bulamıyorsanız ön kontrolün reddedilmiş olması muhtemeldir.
Hata ayıklarken ne yapılır?
Tarayıcının ağ sekmesinde isteğin ve yanıtın başlıklarına bakın. Yanıtta izin başlığının olup olmadığını, hangi alan adına izin verildiğini kontrol edin. Aynı isteği tarayıcı dışında bir araçla atıp yanıtı karşılaştırın.
CORS ayarında hangi hatalar yapılır?
En sık hata, hatayı çözmek için her alan adına izin vermektir. Bu, hatayı susturur ama kapıyı herkese açar. İzin verilecek alan adlarını tek tek yazın, yalnızca gereken yöntemlere izin verin ve geliştirme adreslerini canlı ortamda kapatın. Hatanın tarayıcı konsolundaki ayrıntısını okuyun; hangi başlığın eksik olduğunu genellikle söyler. Sistemleri hazır ve güvenli bağlamak için Entegrasyon ve Otomasyon Marketi sayfasına bakabilirsiniz.
Ayarı değiştirdikten sonra tarayıcı önbelleğini temizleyip tekrar deneyin; eski izin yanıtı hatayı sürdürüyor görünebilir.
CORS nerede karşınıza çıkar?
- Mağaza sayfasındaki bir kodun başka alan adındaki API'ye istek atması
- Tarayıcı konsolunda görülen "CORS policy" hatası
- Mobil uygulama ya da ayrı bir vitrin sitesinin mağaza API'sine bağlanması
- API sağlayıcısının hangi sitelerden isteğe izin verdiğini belirtmesi
Sistemlerinizi güvenle bağlayın
Mağaza, vitrin ve dış servisler arasındaki bağlantıları düzenli kuran hazır entegrasyonlar.
CORS hakkında sık sorulanlar
CORS hatası sunucudan mı tarayıcıdan mı gelir?
CORS sunucular arası isteklerde de geçerli mi?
Her kaynağa izin vermek güvenli mi?
İlk adımı birlikte atalım
Operasyonunuzdaki elle yürüyen işleri inceleyip ayda kaç saatin sistemle yürüyebileceğini yazılı olarak veriyoruz; teknik bilgi ve taahhüt gerekmez.
- Kredi kartı yok
- 1 iş gününde dönüş
- KVKK uyumlu
- Veriler şifreli bağlantıyla iletilir