Kullanıcı aracısı ayrıştırıcısı

Kullanıcı aracısı ayrıştırıcısı, bir kullanıcı aracısı dizesini okuyup tarayıcı, işletim sistemi ve cihaz türü bilgilerini döndüren ücretsiz bir araçtır.

Kullanıcı aracısı dizesi hangi bilgileri verir?

Kullanıcı aracısı dizesi, HTTP User-Agent alanının değeridir. Bir web tarayıcısında bu değer genellikle ürün adlarını, sürüm numaralarını, işletim sistemi belirteçlerini ve cihazla ilgili ipuçlarını içerir. Komut satırı istemcileri, tarayıcı botları, akış okuyucuları ve uygulama içi tarayıcılar da kullanıcı aracısı dizeleri gönderebilir.

Bu format ilk bakışta göründüğü kadar düzenli değildir. Tarayıcılar çoğu zaman diğer tarayıcılarla ilişkili uyumluluk belirteçlerini de içerir. Bu nedenle, tanınan ilk ürün adını eşleştirmek yanlış sonuç verebilir. Örneğin Chromium tabanlı tarayıcılarda genellikle hem Chrome hem de Safari ile ilgili belirteçler bulunur. Ayrıştırıcı, değeri basit bir liste olarak ele almak yerine belirteçlerin birleşimini ve sırasını inceler.

Kullanıcı aracısı verileri istemci tarafından beyan edilir. İstemci bu verileri değiştirebilir veya tamamen uydurabilir. Bazı tarayıcılar da paylaştıkları sürüm ve cihaz bilgilerinin kapsamını azaltır. Dolayısıyla ayrıştırılmış veriler sınıflandırma ve hata ayıklama için yararlıdır, ancak cihazın kimliğini kanıtlamaz.

Kullanıcı aracısı nasıl ayrıştırılır?

Üst bilginin tam değerini Kullanıcı aracısı alanına yapıştır ve aracı çalıştır. Araç, Tarayıcı, İşletim sistemi ve Cihaz türü adlı üç alan döndürür.

1. Bir HTTP isteğinden, erişim günlüğünden veya tarayıcı geliştirici araçlarından User-Agent sonrasındaki değeri kopyala.
2. Özgün boşlukları, parantezleri, noktalı virgülleri, eğik çizgileri ve sürüm numaralarını koru. Bunlar dizedeki ürünleri ve açıklamaları birbirinden ayırır.
3. Değeri gönder, ardından döndürülen sınıflandırmaları isteğin bağlamıyla karşılaştır.
4. Kendi hata ayıklama notlarında özgün dizeyi ayrıştırılmış sonuçla birlikte sakla. Tek başına sınıflandırma, yararlı sürüm veya uyumluluk belirteçlerini gizleyebilir.

Ayrıştırıcı sunucuda çalışır. Kullanıcı aracısı dizen HTTPS üzerinden sunucuya gönderilir ve saklanmaz. Yine de göndermeden önce kopyaladığın günlük kayıtlarında ilgisiz sorgu parametreleri, oturum tanımlayıcıları veya dahili ana makine adları bulunup bulunmadığını kontrol et.

Ayrıştırma sonucunu nasıl okumalıyım?

Her alanı, bağımsız olarak doğrulanmış donanım veya yazılım bilgisi şeklinde değil, istemcinin sağladığı belirteçlerden çıkarılan bir sınıflandırma olarak değerlendir.

• Tarayıcı, dizeden tanınan tarayıcı veya istemci ailesini belirtir. Gömülü web görünümlerini ve Chromium türevi tarayıcıları ayırt etmek daha zor olabilir, çünkü bunlar birçok ortak belirteç kullanır.
• İşletim sistemi, Windows NT, Android, iPhone OS, Mac OS X veya Linux gibi işaretlerin belirttiği platformu gösterir. Uyumluluk katmanları ve değiştirilmiş kullanıcı aracıları bu sonucun kesinliğini azaltabilir.
• Cihaz türü, istemciyi cihaz ve platform işaretlerinden çıkarılan genel bir biçim sınıfında gruplandırır. Bunu tam bir donanım modeli değil, pratik bir kategori olarak değerlendir.

Belgelenen sonuç alanları bir söz dizimi doğrulama raporu oluşturmaz. Hatalı biçimlendirilmiş, kısaltılmış veya tanınmayan bir kullanıcı aracısında yararlı bir sınıflandırma için yeterli bilgi bulunmayabilir. Ancak sondaki virgüller veya tırnak içine alınmamış anahtarlar gibi JSON hatalarıyla karşılaştırılabilecek evrensel bir hata listesi yoktur. Gerçek dizeler istemciler arasında değiştiği ve çoğu zaman eski uyumluluk söz dizimini koruduğu için kullanıcı aracısı ayrıştırma işlemi büyük ölçüde sezgisel kurallara dayanır.

Boş bir değerde sınıflandırılacak hiçbir şey yoktur. Çok uzun değerler uzantılar, uygulama tanımlayıcıları veya yinelenen ürün belirteçleri içerebilir. Sayılar ise genellikle yalnızca niteledikleri ürün belirtecinin yanında anlam taşır. Özel istemci dizelerinde aksanlı veya Latin alfabesi dışındaki karakterler bulunabilir, ancak bunlar tek başına bir tarayıcıyı, işletim sistemini ya da cihazı tanımlamaz.

Uygulamalı örnekler

Girdi Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36

Bir ayrıştırıcı normalde bunu Windows üzerinde çalışan Chrome ve masaüstü cihaz olarak sınıflandırır. Safari belirteci uyumluluk amacıyla bulunur ve tek başına tarayıcının Safari olarak belirlenmesine yol açmamalıdır.

Girdi Mozilla/5.0 (iPhone; CPU iPhone OS 17_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4 Mobile/15E148 Safari/604.1

Bu dize, iOS üzerinde Safari'yi ve bir mobil cihazı belirtir. "like Mac OS X" ifadesi uyumluluk bilgilerinin bir parçasıdır. iPhone ve Mobile işaretleri, cihaz konusunda daha güçlü ipuçları sağlar.

Bir kullanıcı aracısı URL sorgu parametresi içinde yakalanmışsa yüzde kodlamalı olabilir. Ortaya çıkan kullanıcı aracısı değerini ayrıştırmadan önce parametreyi ayırmak ve kodunu çözmek için URL ayrıştırıcı aracını kullan.

Kullanıcı aracısını ayrıştırmak ne zaman yararlıdır, ne zaman değildir?

Tanımadığın bir isteği anlaşılır hâle getirmek veya kullanıma almadan önce sınıflandırma mantığını kontrol etmek istediğinde ayrıştırma yararlıdır. Apache ya da nginx erişim günlüğündeki bir kaydı incelemek, belirli bir tarayıcıya özgü görüntüleme sorununu araştırmak, gömülü bir uygulamadan gelen trafiği kontrol etmek veya analiz platformundan dışa aktarılan ham verileri okumak yaygın kullanım örnekleridir.

Başka bir sistem tarayıcıyı, işletim sistemini ve cihazı zaten yapılandırılmış alanlar hâlinde sağlıyorsa ayrıştırma yapmak genellikle gerekli değildir. Hizmetinin yalnızca özgün üst bilgiyi iletmesi veya arşivlemesi gerekiyorsa da pek fayda sağlamaz. Gönderen taraf dizeyi taklit edebileceğinden sonucu kimlik doğrulama, sahtekârlık tespiti veya erişim kontrolü için tek dayanak olarak kullanma.

Duyarlı yerleşimlerde CSS medya sorguları ve özellik algılama, sunucu tarafındaki cihaz tahminlerinden genellikle daha güvenilirdir. Kullanıcı aracısını, belirli bir tarayıcı özelliğinin desteklendiğini varsaymak için değil, tanılama veya raporlama bağlamına ihtiyaç duyduğunda ayrıştır.

Sık sorulan sorular

Ayrıştırıcı, isteğin bir bottan gelip gelmediğini anlayabilir mi?

Döndürülen alanlarda botlara özel bir sınıflandırma yoktur. Bazı tarayıcı botları kullanıcı aracısında kendilerini açıkça tanıtır, ancak bazıları tarayıcıları taklit eder veya yararlı ayrıntıları belirtmez. Gerektiğinde istek sıklığı örüntülerini, yayımlanmış tarayıcı botu IP kontrollerini ve istek davranışlarını inceleyerek otomatik trafiği doğrula.

Edge kullanıcı aracısında neden Chrome ve Safari geçiyor?

Modern Edge, Chromium tabanlıdır ve kullanıcı aracılarını inceleyen siteler için gerekli uyumluluk belirteçlerini içerir. Ayrıştırıcının, isteği genel Chrome veya Safari olarak değerlendirmeden önce daha özel Edge belirtecini araması gerekir. Belirteçlerin sırası ve özgüllüğü önemlidir.

Cihaz türüne göre mobil ziyaretçileri yönlendirebilir miyim?

Cihaz türünü ipucu olarak kullanabilirsin, ancak zorunlu yönlendirme tabletleri, masaüstü modundaki tarayıcıları ve değiştirilmiş kullanıcı aracılarını yanlış sınıflandırabilir. Duyarlı bir sayfayı tercih et. Ayrı bir mobil deneyim kaçınılmazsa ziyaretçinin başka bir sürümü seçmesine izin ver.

Tarayıcı istemci ipuçları, kullanıcı aracısı ayrıştırmanın yerini alır mı?

İstemci ipuçları, tarayıcı ve sunucu tarafından desteklendiğinde yapılandırılmış tarayıcı ve platform bilgileri sağlayabilir. Ancak her istekte veya istemcide bulunmaz. Eski tarayıcıları, tarayıcı botlarını ve mevcut erişim günlüklerini işleyen sistemlerde kullanıcı aracısı ayrıştırmaya hâlâ ihtiyaç duyulabilir. Yalnızca görev için gerekli kullanıcı aracısı sınıflandırmalarını sakla ve geçerli gizlilik yükümlülüklerini dikkate al.