A/B Test Araçları için Content Security Policy: BT'nin Neye İzin Vermesi Gerekiyor ve Neden

·Ekim 2026'da güncellendi
CSP gereksinimleri Varify dokümantasyonunda belgelenmiştir
unsafe-eval, deneylerin çalıştığı rotalarla sınırlandırılabilir
Enterprise: kendi alt alan adından script dağıtımı
Öne Çıkanlar
  • Bir Content Security Policy (CSP), tarayıcıya bir sayfanın hangi kaynaklardan yükleme ve çalıştırma yapabileceğini söyler. Bir A/B test aracı dört yönergeye dokunur: script-src, connect-src, frame-src ve frame-ancestors.
  • Deneyler, sayfan yayınlandıktan sonra tanımlanır; bu yüzden CSP yazıldığında kodları henüz bilinmez. Hash'ler ve nonce'lar yalnızca önceden bilinen kodu kapsar. Çalışma zamanında özel varyant JavaScript'i çalıştıran araçların script-src içinde unsafe-eval'a ihtiyaç duymasının nedeni budur.
  • Varify, kullanıcı tanımlı JavaScript'in varyasyonlar içinde çalışabilmesi için script-src içinde unsafe-eval gerektirir. CSP rota başına yapılandırılabilir, böylece unsafe-eval yalnızca deneylerin çalıştığı yerlerde geçerli olur.
  • CSP'yi önce Report-Only modunda devreye al, raporları kontrol et, ardından zorunlu kıl. Varify alan adlarının listesi tek bir yerde, Varify dokümantasyonunda bulunur.

Content Security Policy, bir sayfanın hangi script'leri, bağlantıları ve frame'leri kullanabileceğini sınırlayan bir HTTP başlığıdır. Cross-site scripting'e karşı en etkili savunmalardan biridir ve birçok güvenlik ekibi bunu her genel web sitesi için zorunlu kılar. Bir A/B test aracı bu politikaya uymak zorundadır, çünkü bir script yükler, kendi sunucularıyla konuşur ve çalışırken sayfayı değiştirir.

Bu sayfa, bir güvenlik incelemesi için karar sayfasıdır: hangi yönergelerin devreye girdiği, çalışma zamanı deneylerinin neden unsafe-eval'e ihtiyaç duyduğu ve bu istisnayı mümkün olduğunca dar tutmanın yolu. Varify'ın ihtiyaç duyduğu kesin alan adları, Varify dokümantasyonunda Content Security Policy error başlığı altında listelenmiştir; bu sayfa o listeye bağlantı verir ve onu tekrarlamaz, böylece güncel tutulması gereken tek bir kaynak olur.

A/B test araçları neden katı CSP'lerle karşılaşır

Katı bir CSP, sayfadaki her betiğin dağıtım zamanında bilindiğini varsayar. Politika ya izin verilen kaynakları listeler ya da her satır içi betiği bir hash veya nonce ile sabitler. Bunların dışındaki her şey engellenir.

İstemci tarafı bir A/B testi aracı ise tam tersi şekilde çalışır. Ekibin, sayfanın yayınlanmasından genellikle günler sonra aracın editöründe bir deney oluşturur. Deney; metni değiştirebilir, görselleri değiştirebilir, öğeleri taşıyabilir veya özel JavaScript çalıştırabilir. Bu kod, deney yapılandırmasının bir parçası olarak çalışma zamanında ziyaretçinin tarayıcısına ulaşır ve test betiği onu orada çalıştırır.

CSP için buradan üç sonuç çıkar:

  • Test betiğinin kendi kaynağına script-src içinde izin verilmelidir.
  • Betiğin gönderdiği istekler — örneğin deney yapılandırmalarını yüklemek veya olayları raporlamak için — connect-src içinde izin verilmelidir.
  • Yalnızca çalışma zamanında var olan kod, önceden bir hash veya nonce ile sabitlenemez. Bunu çalıştırmak script-src içinde bir istisna gerektirir.

Aynı kısıtlama, tarayıcıda eval tarzı fonksiyonlar aracılığıyla özel varyant JavaScript'i çalıştıran her araç için geçerlidir.

Hangi direktifler devreye giriyor

Bir A/B testi aracının CSP'in altında çalışıp çalışmayacağına dört direktif karar verir. Varify sütunu, tam girişlerin tutulduğu belgelere bağlantı verir.

DirektifBir A/B testi aracı için ne kontrol ederVarify girişi
script-srcTest betiğinin yüklenmesi ve çalışma zamanında deney kodunun çalıştırılmasıBelgelere bakın, unsafe-eval dahil
connect-srcBetiğin sağlayıcının sunucularına gönderdiği istekler, örneğin deney yapılandırmaları ve olaylarBelgelere bakın
frame-srcAracın sayfanda açtığı çerçeveler, örneğin editör özellikleri içinBelgelere bakın
frame-ancestorsSayfanın, örneğin editör özellikleri tarafından bir çerçeve içinde gösterilip gösterilemeyeceğiBelgelere bakın

Deneylerinin ne yaptığına bağlı olarak iki direktif daha önemli olabilir: varyantlar yeni bir kaynaktan görsel yüklüyorsa img-src, varyantlar stil ekliyorsa style-src. Bunları ekibinin çalıştırmayı planladığı deneylere göre kontrol et.

Çalışma zamanı deneyleri neden unsafe-eval gerektirir

Bir CSP, her şeye izin vermeden belirli bir betiğe izin vermenin iki yolunu sunar: betiğin içeriğinin bir hash'i veya sunucunun her yanıt için belirlediği ve izin verilen her betik etiketinde tekrarlanan rastgele bir değer olan bir nonce. İkisi de yalnızca sunucunun sayfayı gönderirken bildiği kod için çalışır.

Deney kodu bu koşulu karşılamaz. Test aracında yazılır, veri olarak teslim edilir ve tarayıcıda çalıştırılabilir koda dönüştürülür. Bunun için önceden ne bir hash ne de bir nonce hesaplanabilir. Bu adım eval veya benzer fonksiyonlar kullandığında, tarayıcı buna yalnızca script-src unsafe-eval içeriyorsa izin verir.

Varify'ın belgeleri bu konuda açıktır:

  • "script-src direktifinde unsafe-eval değerine de ihtiyacınız var."
  • "Not: unsafe-eval girişi, kullanıcı tanımlı JavaScript'in varyasyonlar içinde çalıştırılabilmesi için gereklidir."
  • "Hayır, teknik olarak konuşursak, deneyler oluşturmak ve teslim etmek unsafe-eval olmadan mümkün değildir."

Tam açıklama, Katı CSP güvenli olmayan değerlendirmeye izin vermiyor belge makalesinde yer alır. İncelemen için önemli olan soru, dolayısıyla istisnanın ne kadar ileriye gittiğidir.

Riski nasıl sınırlandırırsın

unsafe-eval, sayfadaki bir betiğin yapabileceklerini genişletir. İncelemenin amacı bu genişlemeyi mümkün olduğunca küçük tutmaktır. Üç önlem birlikte çalışır:

  1. Rota başına CSP. CSP her rota için farklı şekilde yapılandırılabilir, böylece unsafe-eval yalnızca deneylerin çalıştığı yerlerde, örneğin ürün ve açılış sayfalarında geçerli olur. Katı politikayı giriş, hesap ve ödeme sayfalarında koru. Rota başına bir politika, istisnanın geçerli olduğu yeri daraltır; aynı kaynaktaki sayfalar yine de birbirine ulaşabilir, bu yüzden diğer iki önlemin yerini tutmaz.
  2. Önce Yalnızca Rapor. Yeni politikayı normal trafiğin olduğu bir süre boyunca Content-Security-Policy-Report-Only olarak gönder. Tarayıcı hiçbir şeyi engellemeden ihlalleri raporlar. Raporlar yalnızca beklediğini gösterene kadar politikayı düzelt, ardından zorunlu kılan Content-Security-Policy başlığına geç. Yalnızca Rapor dönemini, ekibinin planladığı deneyleri kapsayacak kadar uzun çalıştır, çünkü çalışan bir deneyi olmayan bir sayfa, bir deneyin neye ihtiyaç duyduğunu göstermez.
  3. Deneylere nelerin dahil edildiğini kontrol et. Özel JavaScript içeren varyantları kimin yayınlayabileceğine dahili olarak karar ver ve bu kodu yayına girmeden önce incele. CSP istisnası, yalnızca onu kullanan kod için izlenen süreç kadar güvenlidir.

Varify ayrıca Enterprise planında birinci taraf bağlam sunar: "Birinci taraf bağlamı (CNAME): Daha iyi performans ve daha az engelleyici için Varify betiğini kendi alt alan adından teslim et." Kurulum, birinci taraf bağlamı (CNAME) hakkındaki sayfada açıklanmıştır.

Varify'ın CSP gereksinimleri

Varify'ın ihtiyaç duyduğu alan adları ve direktif değerleri tek bir yerde, Varify dokümantasyonunda tutulur. Yapılandırman için şu iki makaleyi kullan:

Varify'ın VİS'i, teknik önlemleri arasında "SFTP veya HTTPS gibi şifreli bağlantılar üzerinden veri sağlanması"nı listeler.

Güvenlik incelemesinin geri kalanı için A/B test araçları için 25 maddelik güvenlik kontrol listesine bak.

Güvenlik incelemesi için kontrol listesi

Herhangi bir A/B testi aracının incelemesinde şu noktaları belgele:

  • Sağlayıcının CSP gereksinimleri, direktif başına belgelenmiştir.
  • script-src ve connect-src içindeki alan adları, kontrol ettiğin tarihle birlikte sağlayıcının güncel belgelerinden alınmıştır.
  • Araç gerektiriyorsa, unsafe-eval için gerekçe belgelenmiştir.
  • unsafe-eval'a izin veren rotalar listelenmiştir ve izin vermeyen rotalar listelenmiştir.
  • Giriş, hesap ve ödeme sayfaları katı politikayı korur.
  • Politika, zorunlu kılınmadan önce Report-Only modunda çalıştırıldı ve raporlar incelendi.
  • Varyantlarda özel JavaScript yayınlayabilecek kişilere ilişkin dahili kural yazılı hale getirildi.
  • frame-src ve frame-ancestors, aracın editör özelliklerine göre kontrol edildi.
  • Sağlayıcı alan adlarını değiştirdiğinde veya deneyler yeni rotalara taşındığında karar yeniden gözden geçirilir.

Ekibimizle CSP'yi konuş

Content Security Policy'ni demoya getir ve hangi rotaların deney çalıştıracağını planla.

CSP ve A/B testi hakkında sıkça sorulan sorular

Varify nonce veya hash'lerle çalışır mı?

Nonce'lar ve hash'ler, sayfa gönderildiğinde bilinen kodu kapsar. Deney kodu daha sonra oluşturulur ve çalışma zamanında yürütülür. Varify'ın dokümantasyonu şunu belirtir: "Hayır, teknik olarak konuşursak, unsafe-eval olmadan deney oluşturmak ve sunmak mümkün değildir." Bkz. Strict CSP does not allow unsafe evaluation.

unsafe-eval'e yalnızca bazı sayfalarda izin verebilir miyiz?

Evet. CSP her rota için farklı şekilde yapılandırılabilir, böylece unsafe-eval yalnızca deney çalıştıran sayfalarda izin verilir ve katı politika her yerde geçerli kalır.

Hangi Varify alan adları CSP'mizde yer almalı?

Güncel liste, Varify dokümantasyonunda Content Security Policy error başlığı altında yer alır. Yapılandırmanın her zaman tek bir kaynağı takip etmesi için liste yalnızca orada tutulur.

Görsel editör neden frame-src'ye ihtiyaç duyar?

Bazı editör özellikleri sayfanı bir çerçeve içinde gösterir veya üzerine bir çerçeve açar. Bir aracın bunu nasıl yaptığına bağlı olarak, CSP'inin çerçeveye frame-src içinde izin vermesi veya sayfanın frame-ancestors içinde çerçevelenmesine izin vermesi gerekir. Hangi Varify özelliğinin bu girişlere ihtiyaç duyduğu ve hangi değerlerin ayarlanacağı CSP belgelerinde listelenmiştir.

Bir güvenlik incelemecisi unsafe-eval hakkında neleri belgelemeli?

Neden gerekli olduğu, hangi rotalarda izin verildiği, hangi rotalarda verilmediği, Report-Only döneminin ve sonuçlarının ne olduğu ve varyantlarda özel JavaScript yayınlama yetkisinin kimde olduğuna dair dahili kural. Deneyler yeni rotalara taşındığında bu kararı yeniden gözden geçir.