उपयोगकर्ता-एजेंट क्लाइंट हिंट पर माइग्रेट करना

अपनी साइट को यूज़र-एजेंट स्ट्रिंग से नए यूज़र-एजेंट क्लाइंट हिंट पर माइग्रेट करने की रणनीतियां.

पब्लिश होने की तारीख: 19 मई, 2021

उपयोगकर्ता एजेंट स्ट्रिंग, ब्राउज़र में पैसिव ऑनलाइन ट्रैकिंग का एक अहम तरीका है. साथ ही, इसे प्रोसेस करना मुश्किल होता है. हालांकि, उपयोगकर्ता एजेंट का डेटा इकट्ठा करने और उसे प्रोसेस करने की कई मान्य वजहें हैं. इसलिए, हमें एक बेहतर समाधान की ज़रूरत है. यूज़र-एजेंट क्लाइंट हिंट, यूज़र-एजेंट डेटा की ज़रूरत को साफ़ तौर पर बताने का तरीका उपलब्ध कराते हैं. साथ ही, डेटा को आसानी से इस्तेमाल किए जा सकने वाले फ़ॉर्मैट में दिखाने के तरीके भी उपलब्ध कराते हैं.

यहां हम आपको यूज़र-एजेंट डेटा के ऐक्सेस की जांच करने और यूज़र-एजेंट स्ट्रिंग के इस्तेमाल को यूज़र-एजेंट क्लाइंट हिंट पर माइग्रेट करने का तरीका बताएंगे.

Browser Support

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

Source

उपयोगकर्ता एजेंट के डेटा को इकट्ठा करने और उसके इस्तेमाल का ऑडिट करना

डेटा कलेक्शन के किसी भी तरीके की तरह, आपको हमेशा यह समझना चाहिए कि डेटा क्यों इकट्ठा किया जा रहा है. सबसे पहले, आपको यह समझना होगा कि उपयोगकर्ता एजेंट डेटा का इस्तेमाल कहां और क्यों किया जा रहा है. भले ही, आपको कोई कार्रवाई करनी हो या नहीं.

अगर आपको नहीं पता कि उपयोगकर्ता एजेंट डेटा का इस्तेमाल कहां किया जा रहा है, तो अपने फ़्रंटएंड कोड में navigator.userAgent और बैकएंड कोड में User-Agent एचटीटीपी हेडर का इस्तेमाल खोजें. आपको अपने फ़्रंटएंड कोड की भी जांच करनी चाहिए, ताकि यह पता चल सके कि कहीं उसमें ऐसी सुविधाओं का इस्तेमाल तो नहीं किया जा रहा है जो अब काम नहीं करतीं. जैसे, navigator.platform और navigator.appVersion.

फ़ंक्शन के हिसाब से, अपने कोड में उन जगहों के बारे में सोचें जहां रिकॉर्डिंग या प्रोसेसिंग की जा रही है:

  • ब्राउज़र का नाम या वर्शन
  • ऑपरेटिंग सिस्टम का नाम या वर्शन
  • डिवाइस का ब्रैंड या मॉडल
  • सीपीयू का टाइप, आर्किटेक्चर या बिटनेस (उदाहरण के लिए, 64-बिट)

ऐसा भी हो सकता है कि उपयोगकर्ता एजेंट को प्रोसेस करने के लिए, तीसरे पक्ष की लाइब्रेरी या सेवा का इस्तेमाल किया जा रहा हो. इस मामले में, देखें कि क्या वे यूज़र-एजेंट क्लाइंट हिंट के साथ काम करने के लिए अपडेट कर रहे हैं.

क्या सिर्फ़ उपयोगकर्ता एजेंट का बुनियादी डेटा इस्तेमाल किया जा रहा है?

यूज़र-एजेंट क्लाइंट हिंट के डिफ़ॉल्ट सेट में ये शामिल हैं:

  • Sec-CH-UA: ब्राउज़र का नाम और मेजर / सिग्निफ़िकेंट वर्शन
  • Sec-CH-UA-Mobile: बूलियन वैल्यू, जो फ़ोन या टैबलेट के बारे में बताती है
  • Sec-CH-UA-Platform: ऑपरेटिंग सिस्टम का नाम

उपयोगकर्ता-एजेंट स्ट्रिंग के जिस छोटे वर्शन का सुझाव दिया गया है उसमें भी यह बुनियादी जानकारी, पुराने सिस्टम के साथ काम करने की सुविधा के तौर पर बनी रहेगी. उदाहरण के लिए, स्ट्रिंग में Chrome/90.0.4430.85 के बजाय Chrome/90.0.0.0 शामिल होगा.

अगर सिर्फ़ ब्राउज़र के नाम, मेजर वर्शन या ऑपरेटिंग सिस्टम के लिए उपयोगकर्ता एजेंट स्ट्रिंग की जांच की जा रही है, तो आपका कोड काम करता रहेगा. हालांकि, आपको इस सुविधा के बंद होने की चेतावनियां दिख सकती हैं.

आपके पास यूज़र-एजेंट क्लाइंट हिंट पर माइग्रेट करने का विकल्प है और आपको ऐसा करना भी चाहिए. हालांकि, ऐसा हो सकता है कि आपके पास लेगसी कोड या संसाधन की कमी हो, जिसकी वजह से ऐसा न किया जा सके. पुराने सिस्टम के साथ काम करने की सुविधा वाले इस तरीके से, उपयोगकर्ता-एजेंट स्ट्रिंग में जानकारी को कम करने का मकसद यह पक्का करना है कि मौजूदा कोड को कम जानकारी मिले, लेकिन वह बुनियादी फ़ंक्शन को बनाए रखे.

रणनीतियां

यूज़र-एजेंट स्ट्रिंग के इस्तेमाल को यूज़र-एजेंट क्लाइंट हिंट पर माइग्रेट करने के लिए, कई रणनीतियां अपनाई जा सकती हैं.

मांग पर क्लाइंट-साइड JavaScript API

अगर navigator.userAgent का इस्तेमाल किया जा रहा है, तो आपको उपयोगकर्ता-एजेंट स्ट्रिंग को पार्स करने से पहले, navigator.userAgentData का इस्तेमाल करना चाहिए.

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

अगर आपको मोबाइल या डेस्कटॉप के लिए जांच करनी है, तो बूलियन mobile वैल्यू का इस्तेमाल करें:

const isMobile = navigator.userAgentData.mobile;

userAgentData.brands, brand और version प्रॉपर्टी वाले ऑब्जेक्ट का कलेक्शन है. इसमें ब्राउज़र, उन ब्रैंड के साथ काम करने की अपनी क्षमता को लिस्ट कर सकता है. इसे सीधे ऐरे के तौर पर ऐक्सेस किया जा सकता है. इसके अलावा, यह देखने के लिए कि कोई खास एंट्री मौजूद है या नहीं, some() कॉल का इस्तेमाल किया जा सकता है:

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
}

अगर आपको ज़्यादा जानकारी वाली, हाई-एंट्रॉपी यूज़र-एजेंट वैल्यू में से कोई एक चाहिए, तो आपको उसे बताना होगा. साथ ही, नतीजे के लिए, दिखाए गए Promise में देखना होगा:

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

अगर आपको सर्वर-साइड प्रोसेसिंग से क्लाइंट-साइड प्रोसेसिंग पर स्विच करना है, तो भी इस रणनीति का इस्तेमाल किया जा सकता है. JavaScript API को एचटीटीपी अनुरोध के हेडर के ऐक्सेस की ज़रूरत नहीं होती. इसलिए, उपयोगकर्ता-एजेंट की वैल्यू के लिए किसी भी समय अनुरोध किया जा सकता है.

स्टैटिक सर्वर-साइड हेडर

अगर सर्वर पर User-Agent अनुरोध के हेडर का इस्तेमाल किया जा रहा है और उस डेटा के लिए आपकी ज़रूरतें पूरी साइट पर एक जैसी हैं, तो अपने जवाबों में क्लाइंट हिंट को स्टैटिक सेट के तौर पर तय किया जा सकता है. यह तरीका काफ़ी आसान है, क्योंकि आम तौर पर आपको इसे सिर्फ़ एक जगह पर कॉन्फ़िगर करना होता है. उदाहरण के लिए, अगर आपने पहले से ही हेडर जोड़े हैं, तो यह आपके वेब सर्वर कॉन्फ़िगरेशन, होस्टिंग कॉन्फ़िगरेशन या आपकी साइट के लिए इस्तेमाल किए जाने वाले फ़्रेमवर्क या प्लैटफ़ॉर्म के टॉप-लेवल कॉन्फ़िगरेशन में हो सकता है.

अगर उपयोगकर्ता-एजेंट के डेटा के आधार पर दिए गए जवाबों को बदला जा रहा है या उन्हें पसंद के मुताबिक बनाया जा रहा है, तो इस रणनीति का इस्तेमाल करें.

ब्राउज़र या अन्य क्लाइंट, अलग-अलग डिफ़ॉल्ट हिंट दे सकते हैं. इसलिए, अपनी ज़रूरत के हिसाब से हर चीज़ की जानकारी देना बेहतर होता है. भले ही, वह आम तौर पर डिफ़ॉल्ट रूप से दी जाती हो.

उदाहरण के लिए, Chrome के लिए मौजूदा डिफ़ॉल्ट सेटिंग को इस तरह दिखाया जाएगा:

⬇️ रिस्पॉन्स हेडर

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

अगर आपको जवाबों में डिवाइस मॉडल भी चाहिए, तो आपको यह भेजना होगा:

⬇️ रिस्पॉन्स हेडर

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

सर्वर-साइड पर इसे प्रोसेस करते समय, आपको सबसे पहले यह देखना चाहिए कि ज़रूरी Sec-CH-UA हेडर भेजा गया है या नहीं. अगर यह उपलब्ध नहीं है, तो User-Agent हेडर को पार्स करने के लिए फ़ॉलबैक करें.

अलग-अलग डोमेन से किए जाने वाले अनुरोधों के लिए हिंट डेलिगेट करना

अगर आपको क्रॉस-ऑरिजिन या क्रॉस-साइट सब-रिसोर्स का अनुरोध करना है, तो उनके अनुरोधों पर यूज़र-एजेंट क्लाइंट हिंट भेजने होंगे. इसके लिए, आपको अनुमतियों से जुड़ी नीति का इस्तेमाल करके, अपनी ज़रूरत के हिसाब से हिंट साफ़ तौर पर बताने होंगे.

उदाहरण के लिए, मान लें कि https://blog.site, https://cdn.site पर रिसॉर्स होस्ट करता है. यह किसी खास डिवाइस के लिए ऑप्टिमाइज़ किए गए रिसॉर्स दिखा सकता है. https://blog.site, Sec-CH-UA-Model हिंट का अनुरोध कर सकता है. हालांकि, इसके लिए उसे Permissions-Policy हेडर का इस्तेमाल करके, साफ़ तौर पर https://cdn.site को ऐक्सेस देना होगा. नीति के तहत कंट्रोल किए जाने वाले हिंट की सूची, क्लाइंट हिंट इन्फ़्रास्ट्रक्चर के ड्राफ़्ट में उपलब्ध है

⬇️ हिंट को डेलिगेट करने वाले blog.site से मिला जवाब

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

⬆️ cdn.site पर सब-रिसोर्स के लिए किए गए अनुरोध में, डेलिगेट किया गया हिंट शामिल होता है

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

एक से ज़्यादा ऑरिजिन के लिए, एक से ज़्यादा हिंट तय किए जा सकते हैं. ये हिंट, सिर्फ़ ch-ua रेंज से नहीं होने चाहिए:

⬇️ blog.site से मिला रिस्पॉन्स, जिसमें कई ऑरिजिन को कई हिंट डेलिगेट किए गए हैं

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")

iframe को हिंट असाइन करना

क्रॉस-ऑरिजिन iframe, क्रॉस-ऑरिजिन रिसॉर्स की तरह ही काम करते हैं. हालांकि, आपको allow एट्रिब्यूट में वे हिंट बताने होंगे जिन्हें आपको डेलिगेट करना है.

blog.site ⬇️ से जवाब मिला

Accept-CH: Sec-CH-UA-Model

blog.site के लिए एचटीएमएल

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

widget.site ⬆️ को भेजा गया अनुरोध

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

iframe में मौजूद allow एट्रिब्यूट, Accept-CH हेडर को बदल देगा. widget.site खुद को भेज सकता है. इसलिए, पक्का करें कि आपने iframe की गई साइट के लिए ज़रूरी सभी चीज़ें तय की हों.

डाइनैमिक सर्वर-साइड हिंट

अगर आपको उपयोगकर्ता अनुभव के कुछ हिस्सों में, साइट के बाकी हिस्सों की तुलना में ज़्यादा हिंट की ज़रूरत है, तो आपके पास पूरी साइट पर स्टैटिक तौर पर हिंट दिखाने के बजाय, मांग के हिसाब से हिंट दिखाने का विकल्प होता है. इसे मैनेज करना ज़्यादा मुश्किल है. हालांकि, अगर आपने पहले से ही हर रूट के हिसाब से अलग-अलग हेडर सेट किए हैं, तो ऐसा किया जा सकता है.

यहां यह याद रखना ज़रूरी है कि Accept-CH हेडर का हर इंस्टेंस, मौजूदा सेट को ओवरराइट कर देगा. इसलिए, अगर हेडर को डाइनैमिक तौर पर सेट किया जा रहा है, तो हर पेज को ज़रूरी हिंट के पूरे सेट का अनुरोध करना होगा.

उदाहरण के लिए, हो सकता है कि आपकी साइट पर कोई ऐसा सेक्शन हो जहां आपको उपयोगकर्ता के ऑपरेटिंग सिस्टम से मैच करने वाले आइकॉन और कंट्रोल उपलब्ध कराने हों. इसके लिए, आपको Sec-CH-UA-Platform-Version को भी शामिल करना पड़ सकता है, ताकि सही सब-रिसोर्स दिखाए जा सकें.

⬇️ /blog के लिए रिस्पॉन्स हेडर

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

⬇️ /app के लिए रिस्पॉन्स हेडर

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

पहले अनुरोध पर ज़रूरी सर्वर-साइड हिंट को मैनेज करना

ऐसा हो सकता है कि आपको पहले अनुरोध पर ही, हिंट के डिफ़ॉल्ट सेट से ज़्यादा हिंट की ज़रूरत पड़े. हालांकि, ऐसा बहुत कम होता है. इसलिए, पक्का करें कि आपने वजह की समीक्षा कर ली हो.

पहले अनुरोध का मतलब है कि उस ब्राउज़िंग सेशन में, उस ऑरिजिन के लिए भेजा गया सबसे पहला टॉप-लेवल अनुरोध. हिंट के डिफ़ॉल्ट सेट में, ब्राउज़र का नाम और उसका मेजर वर्शन, प्लैटफ़ॉर्म, और मोबाइल इंडिकेटर शामिल होता है. इसलिए, यहां यह सवाल पूछना ज़रूरी है कि क्या आपको शुरुआती पेज लोड पर ज़्यादा डेटा की ज़रूरत है?

पहले अनुरोध पर अतिरिक्त संकेत पाने के लिए, दो विकल्प मौजूद हैं. सबसे पहले, Critical-CH हेडर का इस्तेमाल किया जा सकता है. यह Accept-CH जैसा ही फ़ॉर्मैट है. हालांकि, यह ब्राउज़र को बताता है कि अगर पहला अनुरोध ज़रूरी हिंट के बिना भेजा गया था, तो उसे तुरंत अनुरोध को फिर से भेजना चाहिए.

⬆️ शुरुआती अनुरोध

[With default headers]

⬇️ रिस्पॉन्स हेडर

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

🔃 ब्राउज़र, अतिरिक्त हेडर के साथ शुरुआती अनुरोध को फिर से भेजता है

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

इससे पहले अनुरोध पर ही फिर से कोशिश करने का ओवरहेड होता है. हालांकि, इसे लागू करने की लागत काफ़ी कम होती है. अतिरिक्त हेडर भेजें और ब्राउज़र बाकी काम कर देगा.

अगर आपको पहली बार पेज लोड होने पर ही ज़्यादा जानकारी चाहिए, तो क्लाइंट हिंट की विश्वसनीयता से जुड़ा प्रस्ताव, कनेक्शन-लेवल की सेटिंग में जानकारी देने का तरीका बता रहा है. इसके लिए, टीएलएस 1.3 के ऐप्लिकेशन-लेयर प्रोटोकॉल सेटिंग (एएलपीएस) एक्सटेंशन का इस्तेमाल किया जाता है. इससे एचटीटीपी/2 और एचटीटीपी/3 कनेक्शन पर हिंट को पहले ही पास किया जा सकता है. यह सुविधा अभी शुरुआती दौर में है. हालांकि, अगर आपके पास अपने टीएलएस और कनेक्शन की सेटिंग को मैनेज करने का विकल्प है, तो इसमें योगदान देने का यह सबसे सही समय है.

लेगसी सहायता

ऐसा हो सकता है कि आपकी साइट पर लेगसी या तीसरे पक्ष का कोड हो, जो navigator.userAgent पर निर्भर करता हो. इसमें यूज़र-एजेंट स्ट्रिंग के वे हिस्से भी शामिल हैं जिन्हें कम किया जाएगा. आपको navigator.userAgentData कॉल पर स्विच करना चाहिए. हालांकि, कुछ समय के लिए एक और तरीका भी अपनाया जा सकता है.

UA-CH retrofill एक छोटी लाइब्रेरी है. इसकी मदद से, navigator.userAgent को अनुरोध की गई navigator.userAgentData वैल्यू से बनी नई स्ट्रिंग से बदला जा सकता है.

उदाहरण के लिए, यह कोड एक उपयोगकर्ता-एजेंट स्ट्रिंग जनरेट करता है, जिसमें "मॉडल" हिंट भी शामिल होता है:

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

नतीजे के तौर पर मिलने वाली स्ट्रिंग में Pixel 5 मॉडल दिखेगा. हालांकि, इसमें अब भी कम किया गया 92.0.0.0 दिखेगा, क्योंकि uaFullVersion हिंट का अनुरोध नहीं किया गया था:

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

ज़्यादा मदद पाना

अगर इन रणनीतियों से आपके इस्तेमाल के उदाहरण को हल नहीं किया जा सकता, तो privacy-sandbox-dev-support रेपो में चर्चा शुरू करें. इसके बाद, हम आपकी समस्या को हल करने के लिए मिलकर काम कर सकते हैं.