Wesloo
Tüm konularKonular

Web teknolojileri

CORS co to jest: Cross-Origin Resource Sharing nedir?

Kısa cevap

CORS, bir tarayıcının farklı origin'den kaynak istemesine izin verip vermeyeceğini HTTP başlıklarıyla belirleyen mekanizmadır. Aynı origin politikasını güvenli biçimde esnetir ve sunucunun açık izni olmadan veri okunmasını engeller.

Ana maddeler

  • CORS, farklı origin'den kaynak isteğini sunucunun açık izniyle denetler.
  • Tarayıcılar varsayılan olarak cross-origin okuma isteklerini engeller.
  • Preflight, riskli isteklerden önce sunucuya izin sorar.
  • Kimlik bilgileri içeren isteklerde joker origin kullanılamaz.
  • Hata ayrıntıları JavaScript'e verilmez; konsol incelenir.

CORS co to jest sorusunun en kısa yanıtı şudur: tarayıcının, bir web sayfasının yüklendiği origin dışındaki bir kaynaktan veri okumasına izin verip vermeyeceğini HTTP başlıklarıyla denetleyen mekanizmadır. Cross-Origin Resource Sharing, yani CORS, aynı origin politikasını tamamen kaldırmaz; sunucunun açıkça izin verdiği durumlarda güvenli bir esneme sağlar. Bu nedenle modern web uygulamalarında API çağrıları, fontlar, medya ve üçüncü taraf servisler sıkça CORS ile çalışır.

CORS co to jest: temel tanım

CORS, tarayıcı ile sunucu arasında bir anlaşma gibidir. Tarayıcı, sayfanın origin'i dışındaki bir adrese istek gönderdiğinde Origin başlığını ekler. Sunucu, yanıta Access-Control-Allow-Origin gibi başlıklar ekleyerek hangi origin'lerin yanıtı okuyabileceğini söyler. Tarayıcı bu yanıtı JavaScript'e vermeden önce bu izni kontrol eder.

Origin, şema, alan adı ve portun birleşimidir. https://api.example.com ile https://example.com farklı origin'dir; http ile https de farklıdır. Aynı alan adı olsa bile port değişirse origin değişir. Bu ayrım, tarayıcının güven modelinin temelidir.

Aynı origin politikası neden var?

Tarayıcılar, bir sayfanın başka bir origin'deki veriyi okumasını varsayılan olarak engeller. Bu kural, kötü amaçlı bir sitenin kullanıcının oturum açtığı başka bir siteden veri çalmasını zorlaştırır. Örneğin bankacılık sayfasındaki bakiye bilgisi, rastgele bir siteden JavaScript ile okunamaz.

CORS bu engeli kaldırmaz; yalnızca sunucunun izin verdiği origin'ler için kontrollü bir geçiş açar. Böylece API sağlayıcısı, hangi sitelerin verisini okuyabileceğini kendisi belirler. İzin verilmeyen origin'ler için tarayıcı yanıtı JavaScript'e iletmez.

CORS nasıl çalışır?

Basit bir akışta tarayıcı isteği gönderir ve Origin başlığını ekler. Sunucu yanıtı döndürürken Access-Control-Allow-Origin başlığına izin verilen origin'i yazar. Tarayıcı, bu değer sayfanın origin'i ile uyumluysa yanıtı uygulamaya verir; uyumsuzsa hata üretir.

Daha riskli isteklerde tarayıcı önce bir ön istek gönderir. Bu istek OPTIONS metodunu kullanır ve asıl isteğin metodunu, başlıklarını sunucuya sorar. Sunucu izin verirse asıl istek gönderilir; vermezse tarayıcı asıl isteği göndermez.

Preflight (ön istek) nedir?

Preflight, tarayıcının asıl isteği göndermeden önce sunucuya izin sorduğu OPTIONS isteğidir. Bu mekanizma, özellikle veri değiştiren veya özel başlık taşıyan isteklerde kullanılır. Sunucu, Access-Control-Allow-Methods ve Access-Control-Allow-Headers başlıklarıyla hangi metod ve başlıklara izin verdiğini bildirir.

Preflight yanıtı ayrıca Access-Control-Max-Age başlığıyla önbelleğe alınabilir. Böylece tarayıcı aynı origin ve aynı istek türü için kısa süre içinde yeniden ön istek göndermek zorunda kalmaz. Bu, gereksiz ağ trafiğini azaltır.

Basit istekler ve preflight tetikleyicileri

Her cross-origin istek preflight gerektirmez. GET, HEAD veya POST gibi sınırlı metodlar ve belirli başlık kombinasyonları daha basit kabul edilir. Örneğin Content-Type değeri application/json olduğunda veya X-Auth-Token gibi özel başlık gönderildiğinde tarayıcı ön istek yapar.

DurumPreflight gerekir mi?
GET veya HEAD isteğiGenellikle hayır
POST ve basit Content-TypeGenellikle hayır
PUT veya DELETEEvet
application/json gövdesiEvet
Özel başlık (ör. X-Auth-Token)Evet

Bu tablo, tarayıcının neden bazı isteklerde önce OPTIONS gönderdiğini anlamaya yardımcı olur. API tasarımında metod ve başlık seçimi, preflight sayısını doğrudan etkiler.

Kimlik bilgileri ve güvenli paylaşım

Cookie, HTTP kimlik doğrulaması veya istemci sertifikası içeren isteklerde CORS daha sıkı uygulanır. Bu tür isteklerde sunucu Access-Control-Allow-Credentials: true başlığını döndürmelidir. Ayrıca Access-Control-Allow-Origin değeri joker karakter (*) olamaz; tam origin belirtilmelidir.

Bu kural, tarayıcının kimlik bilgilerini taşıyan yanıtı yalnızca açıkça izin verilen siteye vermesini sağlar. Aksi halde herhangi bir site, kullanıcının oturum bilgileriyle korunan veriyi okuyabilirdi. Bu nedenle credentials: include kullanılan isteklerde sunucu yapılandırması daha dikkatli yapılmalıdır.

CORS hataları neden JavaScript'e ayrıntı vermez?

CORS başarısızlığında tarayıcı hata verir; güvenlik nedeniyle JavaScript bu hatanın ayrıntısını göremez. Kod, yalnızca bir hata olduğunu anlar. Tam nedeni anlamak için tarayıcı konsoluna ve Network sekmesine bakılmalıdır.

Bu davranış kasıtlıdır. Hata ayrıntısının verilmesi, saldırganın sunucu yapılandırması veya izin durumu hakkında bilgi toplamasını kolaylaştırabilirdi. Geliştirici için en güvenli yol, konsoldaki mesajı ve sunucu başlıklarını birlikte kontrol etmektir.

Sunucu tarafında CORS yapılandırması

CORS kararı sunucuda verilir. Uygulama veya web sunucusu, gelen Origin değerini kontrol edip uygun Access-Control-Allow-Origin başlığını döndürmelidir. İzin verilen metodlar, başlıklar ve önbellek süresi de aynı yanıta eklenebilir.

Genel amaçlı bir API için joker origin kullanılabilir, ancak bu yalnızca herkese açık veri için uygundur. Kullanıcıya özel veri döndüren uç noktalarda origin listesi açıkça tanımlanmalıdır. Yanlış yapılandırma, hassas verinin beklenmedik origin'lere açılmasına yol açabilir.

Yaygın hatalar ve güvenlik riskleri

Sunucunun hiç CORS başlığı döndürmemesi bir hatadır. Bu durumda tarayıcı yanıtı engeller ve geliştirici bunu ağ hatası gibi algılayabilir. Credentials kullanılan istekte joker origin ile credentials true birlikte kullanmak da hatadır; tarayıcı bunu reddeder.

Bir diğer risk, Origin başlığını koşulsuz olarak yanıta yansıtmaktır. Bu yapılandırma, saldırganın kendi origin'ini izinliymiş gibi göstermesine ve kimlik bilgileriyle korunan veriyi okumasına izin verebilir. Bu nedenle origin değeri sabit bir izin listesiyle karşılaştırılmalıdır.

CORS ile CSRF farkı

CORS, bir yanıtın JavaScript tarafından okunup okunamayacağını denetler. CSRF ise kullanıcının tarayıcısının, kullanıcının haberi olmadan başka bir site adına işlem yapmasıdır. CORS, CSRF saldırılarını tek başına engellemez; sunucu tarafında token, SameSite cookie ve origin kontrolü gibi ek önlemler gerekir.

Bu ayrım önemlidir çünkü CORS başlıklarını eklemek uygulamayı otomatik olarak güvenli yapmaz. CORS, veri paylaşımını düzenler; yetkilendirme ve istek doğrulama ayrı konulardır.

Ne zaman CORS gerekmez?

Gömülü resim, stil, betik, iframe veya video gibi kaynaklarda veri okunmuyorsa CORS gerekmeyebilir. Dış kaynağa yalnızca yazma yapılıyorsa kullanıcı verisinin sızma olasılığı daha azdır. Bununla birlikte tarayıcılar cross-origin isteklere giderek daha temkinli yaklaşıyor ve istek başlatan yeni web özellikleri çoğunlukla CORS ister.

Bu nedenle bir kaynağın gömülmesi ile JavaScript ile verisinin okunması aynı şey değildir. CORS özellikle okuma erişimini denetler. Geliştirici, kaynağın nasıl kullanılacağına göre CORS gerekip gerekmediğini belirlemelidir.

REST API ve GraphQL ile CORS

Modern uygulamalarda frontend ile backend farklı origin'lerde çalışabilir. Bu durumda REST API nedir? Temel kavramlar ve farklar sayfasında anlatılan uç noktalar CORS başlıklarıyla erişilebilir hale getirilir. GraphQL kullanan servislerde de benzer şekilde GraphQL nedir: API sorgu dili ve çalışma zamanı ile ilgili uç noktalar için origin izni tanımlanır.

API tasarımı sırasında CORS politikası, metodlar ve başlıklar birlikte planlanmalıdır. Aksi halde tarayıcı isteği engeller ve hata yalnızca konsolda görünür. Bu da geliştirme sürecinde zaman kaybına yol açar.

CORS başlıkları özeti

BaşlıkGörevi
Access-Control-Allow-Originİzin verilen origin'i belirtir.
Access-Control-Allow-Methodsİzin verilen HTTP metodlarını belirtir.
Access-Control-Allow-Headersİzin verilen özel başlıkları belirtir.
Access-Control-Allow-CredentialsKimlik bilgilerine izin verip vermediğini belirtir.
Access-Control-Max-AgePreflight sonucunun önbellek süresini belirtir.
Access-Control-Expose-HeadersJavaScript'in okuyabileceği ek başlıkları belirtir.

Bu başlıklar birlikte çalışır. Sunucu yalnızca gerekli olanları döndürmeli ve izin listesini mümkün olduğunca dar tutmalıdır.

Sık sorulan diğer sorular

CORS tarayıcıda mı sunucuda mı çalışır?

CORS kararı sunucu başlıklarıyla verilir, ancak tarayıcı bu başlıkları kontrol eder ve yanıtı JavaScript'e verip vermeyeceğine karar verir.

CORS hatası ağ hatasıyla aynı şey midir?

Hayır. İstek ağ üzerinden gönderilebilir, ancak tarayıcı CORS izni yoksa yanıtı uygulamaya iletmez ve hata üretir.

Preflight her istekte gönderilir mi?

Hayır. GET, HEAD veya basit POST gibi bazı istekler preflight gerektirmez; riskli metodlar ve özel başlıklar ön isteği tetikler.

CORS CSRF saldırılarını engeller mi?

Hayır. CORS veri okuma erişimini denetler; CSRF koruması için ayrıca token, SameSite cookie ve origin kontrolü gerekir.

İlgili sayfalar

  • Client side render vs server side render farkları

    Client-side rendering (CSR), web sayfasının HTML yapısını kullanıcının tarayıcısında JavaScript aracılığıyla oluştururken server-side rendering (SSR), eksiksiz HTML belgesini doğrudan sunucuda derleyip tarayıcıya iletir. Bu ayrım web sitelerinin ilk içerik görüntüleme süresini, arama motoru indeksleme başarısını ve sunucu altyapı yükünü doğrudan belirler. Projelerde zengin kullanıcı etkileşimi veya yüksek arama motoru görünürlüğü hedeflerine göre uygun yaklaşım seçilir.

  • WebSocket Nedir ve Ne Zaman Kullanılır?

    WebSocket, istemci ile sunucu arasında tek bir TCP bağlantısı üzerinden kesintisiz ve çift yönlü veri aktarımı sağlayan bir ağ protokolüdür. HTTP protokolünün istek-yanıt döngüsündeki ek başlık yükünü ortadan kaldırarak tarafların bağımsız biçimde veri göndermesine izin verir. Canlı sohbet, borsa ekranları ve çevrim içi oyunlar gibi anlık veri senkronizasyonu isteyen sistemlerde tercih edilir.

  • Web önbelleği nedir ve nasıl çalışır?

    Web önbelleği, tarayıcının veya ara sunucunun daha önce indirdiği site kaynaklarını yerelde saklayıp sonraki ziyaretlerde yeniden kullanmasıdır. Cache-Control başlığı ve max-age değeri, bir dosyanın ne kadar süre taze kalacağını belirler. Önbellek temizleme bozuk veya eski dosyaları yenilemek için yararlıdır, ancak kaydedilmiş şifreleri ve indirilen dosyaları silmez.

  • Web siteleri nasıl çalışır: çerezler

    Çerez, bir web sunucusunun tarayıcıya gönderdiği küçük veri parçasıdır; tarayıcı bunu saklar ve aynı sunucuya yapılan sonraki isteklerde geri gönderir. HTTP protokolü durumsuz olduğundan çerezler oturum, tercih ve izleme bilgilerini hatırlamayı sağlar.

  • GraphQL nedir: API sorgu dili ve çalışma zamanı

    GraphQL, API'ler için sorgu dili olup bu sorguları mevcut veriler üzerinde çalıştıran bir çalışma zamanı sağlar. İstemci, şemada tanımlı alanlardan yalnızca gerekenleri tek işlemde isteyebilir. Güçlü tür sistemi ve kendi kendini tanımlayan şema, araçların ve istemci kitaplıklarının geliştirilmesini kolaylaştırır.

  • REST API nedir? Temel kavramlar ve farklar

    REST API, HTTP üzerinden kaynakları yönetmek için kullanılan bir API türüdür. Tüm REST API'ler API'dir, ancak her API REST değildir. RESTful API ise REST kurallarının tamamına uyan daha katı bir uygulamadır.

Bu sayfa nasıl hazırlandı

Yazmadan önce konu aşağıdaki kaynaklarda araştırıldı. Sayfa ardından otomatik kalite denetimlerinden geçti.

Bu sayfadaki bir hatayı bildir