Kullanıcı Aracısı İstemci İpuçlarına Taşı

Sitenizi kullanıcı aracısı dizesine güvenmekten yeni Kullanıcı Aracısı İstemci İpuçları'na geçirme stratejileri.

Yayınlanma tarihi: 19 Mayıs 2021

User-Agent dizesi, tarayıcılarda önemli bir pasif dijital parmak izi yüzeyidir ve işlenmesi zordur. Ancak kullanıcı aracısı verilerini toplamak ve işlemek için her türlü geçerli neden vardır. Bu nedenle, daha iyi bir çözüm için bir yol gerekir. Kullanıcı Aracısı İstemci İpuçları, kullanıcı aracısı verilerine duyduğunuz ihtiyacı açıkça belirtmenin bir yolunu ve verileri kullanımı kolay bir biçimde döndürme yöntemlerini sunar.

Bu bölümde, kullanıcı aracısı verilerine erişiminizi denetleme ve kullanıcı aracısı dizesi kullanımını Kullanıcı Aracısı İstemci İpuçları'na taşıma adımlarını ele alacağız.

Browser Support

  • Chrome: 90.
  • Edge: 90.
  • Firefox: not supported.
  • Safari: not supported.

Source

Kullanıcı aracısı verilerinin toplanmasını ve kullanılmasını denetleme

Her veri toplama biçiminde olduğu gibi, verileri neden topladığınızı her zaman bilmeniz gerekir. Herhangi bir işlem yapıp yapmayacağınızdan bağımsız olarak ilk adım, kullanıcı aracısı verilerini nerede ve neden kullandığınızı anlamaktır.

Kullanıcı aracısı verilerinin kullanılıp kullanılmadığını veya nerede kullanıldığını bilmiyorsanız ön uç kodunuzda navigator.userAgent ve arka uç kodunuzda User-Agent HTTP üstbilgisinin kullanımını arayabilirsiniz. Ayrıca, ön uç kodunuzda navigator.platform ve navigator.appVersion gibi desteği sonlandırılmış özelliklerin kullanılıp kullanılmadığını da kontrol etmeniz gerekir.

İşlevsel açıdan, kodunuzda aşağıdaki bilgileri kaydettiğiniz veya işlediğiniz her yeri düşünün:

  • Tarayıcı adı veya sürümü
  • İşletim sistemi adı veya sürümü
  • Cihaz markası veya modeli
  • CPU türü, mimarisi veya bit sayısı (ör. 64 bit)

Kullanıcı aracısını işlemek için üçüncü taraf bir kitaplık veya hizmet kullanıyor olmanız da olasıdır. Bu durumda, Kullanıcı Aracısı İstemci İpuçları'nı desteklemek için güncelleme yapıp yapmadıklarını kontrol edin.

Yalnızca temel kullanıcı aracısı verilerini mi kullanıyorsunuz?

Varsayılan Kullanıcı Aracısı İstemci İpuçları grubu şunları içerir:

  • Sec-CH-UA: tarayıcı adı ve ana/önemli sürüm
  • Sec-CH-UA-Mobile: Mobil cihazı belirten Boole değeri
  • Sec-CH-UA-Platform: işletim sistemi adı

Kullanıcı aracısı dizesinin önerilen azaltılmış sürümü de bu temel bilgileri geriye dönük uyumlu bir şekilde korur. Örneğin, dize Chrome/90.0.4430.85 yerine Chrome/90.0.0.0 değerini içerir.

User-Agent dizesini yalnızca tarayıcı adı, ana sürüm veya işletim sistemi için kontrol ediyorsanız kodunuz çalışmaya devam eder ancak muhtemelen desteğin sonlandırılmasıyla ilgili uyarılar görürsünüz.

Kullanıcı Aracısı İstemci İpuçları'na geçiş yapmanız mümkün ve önerilen bir işlem olsa da eski kod veya kaynak kısıtlamaları nedeniyle bunu yapamayabilirsiniz. Kullanıcı aracısı dizesindeki bilgilerin geriye dönük uyumlu bir şekilde azaltılması, mevcut kodun daha az ayrıntılı bilgi almasını ancak temel işlevlerini korumasını sağlar.

Stratejiler

Kullanıcı aracısı dizesi kullanımını Kullanıcı Aracısı İstemci İpuçları'na taşımak için uygulayabileceğiniz çeşitli stratejiler vardır.

İsteğe bağlı istemci tarafı JavaScript API'si

navigator.userAgent kullanıyorsanız kullanıcı aracısı dizesini ayrıştırmaya geri dönmeden önce navigator.userAgentData tercih etmeye geçiş yapmanız gerekir.

if (navigator.userAgentData) {
  // use new hints
} else {
  // fall back to user-agent string parsing
}

Mobil veya masaüstü için kontrol yapıyorsanız boole mobile değerini kullanın:

const isMobile = navigator.userAgentData.mobile;

userAgentData.brands, tarayıcının bu markalarla uyumluluğunu listeleyebildiği brand ve version özelliklerine sahip bir nesne dizisidir. Doğrudan bir dizi olarak erişebilir veya belirli bir girişin mevcut olup olmadığını kontrol etmek için some() çağrısı kullanabilirsiniz:

function isCompatible(item) {
  // In real life you most likely have more complex rules here
  return ['Chromium', 'Google Chrome', 'NewBrowser'].includes(item.brand);
}
if (navigator.userAgentData.brands.some(isCompatible)) {
  // browser reports as compatible
}

Daha ayrıntılı, yüksek entropili kullanıcı aracısı değerlerinden birine ihtiyacınız varsa bunu belirtmeniz ve döndürülen Promise içinde sonucu kontrol etmeniz gerekir:

navigator.userAgentData.getHighEntropyValues(['model'])
  .then(ua => {
    // requested hints available as attributes
    const model = ua.model
  });

Sunucu tarafı işlemeden istemci tarafı işlemeye geçmek istiyorsanız da bu stratejiyi kullanabilirsiniz. JavaScript API, HTTP istek başlıklarına erişim gerektirmediğinden kullanıcı aracısı değerleri herhangi bir noktada istenebilir.

Sunucu tarafı statik başlık

Sunucuda User-Agent istek başlığını kullanıyorsanız ve bu verilerle ilgili ihtiyaçlarınız sitenizin tamamında nispeten tutarlıysa yanıtlarınızda istemci ipuçlarını statik bir küme olarak belirtebilirsiniz. Genellikle yalnızca tek bir yerde yapılandırmanız gerektiğinden bu nispeten basit bir yaklaşımdır. Örneğin, başlıkları zaten orada ekliyorsanız web sunucusu yapılandırmanızda, barındırma yapılandırmanızda veya siteniz için kullandığınız çerçeve ya da platformun üst düzey yapılandırmasında olabilir.

Kullanıcı aracısı verilerine göre sunulan yanıtları dönüştürüyor veya özelleştiriyorsanız bu stratejiyi kullanabilirsiniz.

Tarayıcılar veya diğer istemciler farklı varsayılan ipuçları sağlamayı seçebilir. Bu nedenle, genellikle varsayılan olarak sağlansa bile ihtiyacınız olan her şeyi belirtmeniz iyi bir uygulamadır.

Örneğin, Chrome için geçerli varsayılanlar şu şekilde gösterilir:

⬇️ Yanıt başlıkları

Accept-CH: Sec-CH-UA-Mobile, Sec-CH-UA-Platform, Sec-CH-UA

Yanıtlarda cihaz modelini de almak istiyorsanız şunu gönderirsiniz:

⬇️ Yanıt başlıkları

Accept-CH: Sec-CH-UA-Mobile, Sec-CH-UA-Model, Sec-CH-UA-Platform, Sec-CH-UA

Bunu sunucu tarafında işlerken önce istenen Sec-CH-UA başlığının gönderilip gönderilmediğini kontrol etmeniz ve mevcut değilse User-Agent başlık ayrıştırmaya geri dönmeniz gerekir.

İpuçlarını kaynaklar arası isteklere devretme

İsteklerinde Kullanıcı Aracısı İstemci İpuçları'nın gönderilmesini gerektiren çapraz kaynak veya siteler arası alt kaynaklar istiyorsanız İzinler Politikası'nı kullanarak istediğiniz ipuçlarını açıkça belirtmeniz gerekir.

Örneğin, https://blog.site, https://cdn.site üzerinde belirli bir cihaz için optimize edilmiş kaynaklar döndürebilen kaynaklar barındırıyor diyelim. https://blog.site, Sec-CH-UA-Model ipucunu isteyebilir ancak Permissions-Policy başlığını kullanarak bunu açıkça https://cdn.site kaynağına devretmesi gerekir. Politika tarafından kontrol edilen ipuçlarının listesini İstemci İpuçları Altyapısı taslağında bulabilirsiniz.

⬇️ blog.site tarafından ipucunu devreden yanıt

Accept-CH: Sec-CH-UA-Model
Permissions-Policy: ch-ua-model=(self "https://cdn.site")

⬆️ cdn.site üzerindeki alt kaynaklara yönelik istekler, yetki verilmiş ipucunu içeriyor

Sec-CH-UA-Model: "Pixel 5"

Yalnızca ch-ua aralığından değil, birden fazla kaynak için birden fazla ipucu belirtebilirsiniz:

⬇️ blog.site tarafından birden fazla kaynağa birden fazla ipucu yetkisi veren yanıt

Accept-CH: Sec-CH-UA-Model, DPR
Permissions-Policy: ch-ua-model=(self "https://cdn.site"),
                    ch-dpr=(self "https://cdn.site" "https://img.site")

İpuçlarını iframe'lere devretme

Çapraz kaynak iframe'ler, çapraz kaynaklara benzer şekilde çalışır ancak yetki vermek istediğiniz ipuçlarını allow özelliğinde belirtirsiniz.

⬇️ blog.site tarafından verilen yanıt

Accept-CH: Sec-CH-UA-Model

↪️ blog.site için HTML

<iframe src="https://widget.site" allow="ch-ua-model"></iframe>

⬆️ İstek gönderilen: widget.site

Sec-CH-UA-Model: "Pixel 5"

iframe'deki allow özelliği, widget.site tarafından gönderilebilecek tüm Accept-CH başlıklarını geçersiz kılar. Bu nedenle, iframe'e eklenen sitenin ihtiyaç duyacağı her şeyi belirttiğinizden emin olun.

Dinamik sunucu tarafı ipuçları

Kullanıcı yolculuğunun, sitenin geri kalanına kıyasla daha fazla ipucu seçeneğine ihtiyaç duyduğunuz belirli bölümleri varsa bu ipuçlarını tüm site genelinde statik olarak değil, isteğe bağlı olarak talep etmeyi seçebilirsiniz. Bu yöntemin yönetimi daha karmaşıktır ancak her rota için farklı başlıklar ayarladıysanız uygulanabilir.

Burada unutmamanız gereken önemli nokta, Accept-CH üstbilgisinin her örneğinin mevcut grubu etkili bir şekilde geçersiz kılacağıdır. Bu nedenle, başlığı dinamik olarak ayarlıyorsanız her sayfa, gereken tam ipucu grubunu istemelidir.

Örneğin, sitenizde kullanıcının işletim sistemine uygun simgeler ve kontroller sunmak istediğiniz bir bölüm olabilir. Bunun için uygun alt kaynakları sunmak üzere Sec-CH-UA-Platform-Version öğesini de eklemeniz gerekebilir.

⬇️ /blog için yanıt başlıkları

Accept-CH: Sec-CH-UA-Mobile, Sec-CH-UA-Platform, Sec-CH-UA

⬇️ /app için yanıt başlıkları

Accept-CH: Sec-CH-UA-Mobile, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version, Sec-CH-UA

İlk istekte sunucu tarafı ipuçlarının gerekli olması sorununu giderme

İlk istekte varsayılan ipucu grubundan daha fazlasına ihtiyaç duyduğunuz durumlar olabilir. Ancak bu durum nadiren görülür. Bu nedenle, gerekçeyi incelediğinizden emin olun.

İlk istek, söz konusu tarama oturumunda gönderilen, ilgili kaynağa yönelik ilk üst düzey istek anlamına gelir. Varsayılan ipucu grubu, ana sürümle birlikte tarayıcı adını, platformu ve mobil göstergeyi içerir. Bu noktada sormanız gereken soru, ilk sayfa yüklemesinde genişletilmiş verilere ihtiyacınız olup olmadığıdır.

İlk istekte ek ipuçları için iki seçenek vardır. İlk olarak Critical-CH başlığını kullanabilirsiniz. Bu, Accept-CH ile aynı biçimi alır ancak tarayıcıya, ilk istek kritik ipucu olmadan gönderildiyse isteği hemen yeniden denemesi gerektiğini bildirir.

⬆️ İlk istek

[With default headers]

⬇️ Yanıt başlıkları

Accept-CH: Sec-CH-UA-Model
Critical-CH: Sec-CH-UA-Model

🔃 Tarayıcı, ilk isteği ek başlıkla yeniden dener.

[With default headers + …]
Sec-CH-UA-Model: Pixel 5

Bu, ilk istekte yeniden deneme ek yüküne neden olur ancak uygulama maliyeti nispeten düşüktür. Ek başlığı gönderdiğinizde tarayıcı gerisini halleder.

İlk sayfa yüklemesinde ek ipuçlarına gerçekten ihtiyaç duyduğunuz durumlarda İstemci İpuçları Güvenilirliği teklifi, bağlantı düzeyindeki ayarlarda ipuçlarını belirtmek için bir yol sunar. Bu, HTTP/2 ve HTTP/3 bağlantılarında bu erken ipucu aktarımını etkinleştirmek için TLS 1.3'ün Uygulama Katmanı Protokol Ayarları (ALPS) uzantısını kullanır. Bu özellik henüz çok erken bir aşamadadır ancak kendi TLS ve bağlantı ayarlarınızı etkin bir şekilde yönetiyorsanız katkıda bulunmak için ideal bir zamandır.

Eski destek

Sitenizde, kullanıcı aracısı dizesinin azaltılacak kısımları da dahil olmak üzere navigator.userAgent'e bağlı eski veya üçüncü taraf kodları olabilir. Eşdeğer navigator.userAgentData çağrılarına geçiş yapmayı planlamanız gerekir ancak geçici bir çözüm de mevcuttur.

UA-CH retrofill, navigator.userAgent değerini istenen navigator.userAgentData değerlerinden oluşturulan yeni bir dizeyle üzerine yazmanıza olanak tanıyan küçük bir kitaplıktır.

Örneğin, bu kod, "model" ipucunu da içeren bir kullanıcı aracısı dizesi oluşturur:

import { overrideUserAgentUsingClientHints } from './uach-retrofill.js';
overrideUserAgentUsingClientHints(['model'])
  .then(() => { console.log(navigator.userAgent); });

Sonuç dizesi Pixel 5 modelini gösterir ancak uaFullVersion ipucu istenmediği için azaltılmış 92.0.0.0 değerini göstermeye devam eder:

Mozilla/5.0 (Linux; Android 10.0; Pixel 5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.0.0 Mobile Safari/537.36

Daha fazla destek

Bu stratejiler kullanım alanınıza uygun değilse privacy-sandbox-dev-support deposunda bir tartışma başlatın. Böylece sorununuzu birlikte inceleyebiliriz.