User-Agent Client Hints-এ মাইগ্রেট করা

আপনার সাইটকে ইউজার-এজেন্ট স্ট্রিংয়ের উপর নির্ভরতা থেকে নতুন User-Agent Client Hints-এ মাইগ্রেট করার কৌশল।

প্রকাশিত: ১৯ মে, ২০২১

User-Agent স্ট্রিং হল ব্রাউজারে একটি গুরুত্বপূর্ণ প্যাসিভ ফিঙ্গারপ্রিন্টিং সারফেস, পাশাপাশি এটি প্রসেস করাও কঠিন। তবে, ইউজার-এজেন্ট ডেটা সংগ্রহ ও প্রসেস করার অনেক বৈধ কারণ আছে, তাই আরও ভাল সমাধানের পথ খুঁজে বের করতে হবে। User-Agent Client Hints ইউজার-এজেন্ট ডেটার জন্য আপনার প্রয়োজনীয়তা ঘোষণা করার একটি স্পষ্ট উপায় এবং সহজে ব্যবহারযোগ্য ফর্ম্যাটে ডেটা ফেরত দেওয়ার পদ্ধতি, দুটিই প্রদান করে।

এখানে, আমরা আপনাকে ইউজার-এজেন্ট ডেটাতে আপনার অ্যাক্সেস অডিট করার মাধ্যমে এবং ইউজার-এজেন্ট স্ট্রিং ব্যবহারকে User-Agent Client Hints-এ মাইগ্রেট করার মাধ্যমে নিয়ে যাব।

Browser Support

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

Source

ইউজার-এজেন্ট ডেটা সংগ্রহ ও ব্যবহার অডিট করা

যেকোনও ধরনের ডেটা সংগ্রহের ক্ষেত্রে, আপনি কেন এটি সংগ্রহ করছেন তা আপনাকে সবসময় বুঝতে হবে। আপনি কোনও অ্যাকশন নিন বা না নিন, প্রথম ধাপ হল আপনি কোথায় এবং কেন ইউজার-এজেন্ট ডেটা ব্যবহার করছেন তা বোঝা।

ইউজার-এজেন্ট ডেটা ব্যবহার করা হচ্ছে কিনা বা কোথায় ব্যবহার করা হচ্ছে তা আপনি না জানলে, navigator.userAgent ব্যবহারের জন্য আপনার ফ্রন্টএন্ড কোড এবং User-Agent HTTP হেডার ব্যবহারের জন্য আপনার ব্যাকএন্ড কোড সার্চ করার কথা বিবেচনা করুন। এছাড়াও, আপনার ফ্রন্টএন্ড কোড চেক করে দেখে নিন যে navigator.platform এবং navigator.appVersion-এর মতো আগে থেকে বন্ধ হয়ে যাওয়া ফিচার ব্যবহার করা হচ্ছে কিনা।

কার্যকারিতার দিক থেকে, আপনার কোডের যেকোনও জায়গায় যেখানে আপনি রেকর্ড বা প্রসেস করছেন, সেখানে নিম্নলিখিত বিষয়গুলি বিবেচনা করুন:

  • ব্রাউজারের নাম বা ভার্সন
  • অপারেটিং সিস্টেমের নাম বা ভার্সন
  • ডিভাইসের প্রস্তুতকারক বা মডেল
  • CPU-এর ধরন, আর্কিটেকচার বা বিটনেস (যেমন, ৬৪-বিট)

এছাড়াও, আপনি হয়ত ইউজার-এজেন্ট প্রসেস করার জন্য থার্ড-পার্টি লাইব্রেরি বা পরিষেবা ব্যবহার করছেন। এই ক্ষেত্রে, তারা User-Agent Client Hints-কে সাপোর্ট করার জন্য আপডেট করছে কিনা তা চেক করে দেখুন।

আপনি কি শুধু প্রাথমিক ইউজার-এজেন্ট ডেটা ব্যবহার করছেন?

User-Agent Client Hints-এর ডিফল্ট সেটে এগুলি অন্তর্ভুক্ত থাকে:

  • Sec-CH-UA: ব্রাউজারের নাম এবং প্রধান / গুরুত্বপূর্ণ ভার্সন
  • Sec-CH-UA-Mobile: বুলিয়ান ভ্যালু যা মোবাইল ডিভাইসকে নির্দেশ করে
  • Sec-CH-UA-Platform: অপারেটিং সিস্টেমের নাম

ইউজার-এজেন্ট স্ট্রিংয়ের যে সংক্ষিপ্ত ভার্সন প্রস্তাব করা হয়েছে, সেটিও ব্যাকওয়ার্ড কম্প্যাটিবল উপায়ে এই প্রাথমিক তথ্য ধরে রাখবে। যেমন, Chrome/90.0.4430.85-এর পরিবর্তে স্ট্রিংয়ে Chrome/90.0.0.0 অন্তর্ভুক্ত থাকবে।

আপনি যদি ব্রাউজারের নাম, মেজর ভার্সন বা অপারেটিং সিস্টেমের জন্য শুধুমাত্র ইউজার-এজেন্ট স্ট্রিং চেক করেন, তাহলে আপনার কোড কাজ করা চালিয়ে যাবে, যদিও আপনি সম্ভবত বন্ধ হয়ে যাওয়া সংক্রান্ত সতর্কতা দেখতে পাবেন।

আপনি User-Agent Client Hints-এ মাইগ্রেট করতে পারলেও এবং আপনার তা করা উচিত হলেও, আপনার কাছে লিগ্যাসি কোড বা রিসোর্স সংক্রান্ত সীমাবদ্ধতা থাকতে পারে যা এটি করতে বাধা দেয়। এই ব্যাকওয়ার্ড কম্প্যাটিবল উপায়ে ইউজার-এজেন্ট স্ট্রিংয়ে তথ্য কমানোর উদ্দেশ্য হল, বর্তমান কোড কম বিস্তারিত তথ্য পেলেও যাতে এটি এখনও প্রাথমিক কার্যকারিতা বজায় রাখতে পারে তা নিশ্চিত করা।

কৌশল

ইউজার-এজেন্ট স্ট্রিং ব্যবহার থেকে User-Agent Client Hints-এ মাইগ্রেট করার জন্য আপনি বিভিন্ন কৌশল অবলম্বন করতে পারেন।

চাহিদা অনুযায়ী ক্লায়েন্ট-সাইড জাভাস্ক্রিপ্ট 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-এর HTTP অনুরোধ হেডারে অ্যাক্সেস প্রয়োজন হয় না, তাই যেকোনও সময় ইউজার-এজেন্ট ভ্যালুর জন্য অনুরোধ করা যেতে পারে।

স্ট্যাটিক সার্ভার-সাইড হেডার

আপনি যদি সার্ভারে User-Agent রিকোয়েস্ট হেডার ব্যবহার করেন এবং সেই ডেটার জন্য আপনার প্রয়োজনীয়তা আপনার সম্পূর্ণ সাইট জুড়ে তুলনামূলকভাবে সামঞ্জস্যপূর্ণ হয়, তাহলে আপনি আপনার উত্তরে স্ট্যাটিক সেট হিসেবে Client Hints নির্দিষ্ট করতে পারেন। এটি তুলনামূলকভাবে সহজ পদ্ধতি কারণ সাধারণত আপনাকে এটি একটি লোকেশনেই কনফিগার করতে হয়। যেমন, আপনি যদি আগে থেকেই হেডার যোগ করে থাকেন, তাহলে এটি আপনার ওয়েব সার্ভার কনফিগারেশন, আপনার হোস্টিং কনফিগারেশন বা আপনার সাইটের জন্য ব্যবহার করা ফ্রেমওয়ার্ক বা প্ল্যাটফর্মের টপ-লেভেল কনফিগারেশনে থাকতে পারে।

আপনি যদি ইউজার-এজেন্ট ডেটার উপর ভিত্তি করে পরিবেশিত উত্তর পরিবর্তন বা কাস্টমাইজ করেন, তাহলে এই কৌশলটি বিবেচনা করুন।

ব্রাউজার বা অন্যান্য ক্লায়েন্ট বিভিন্ন ডিফল্ট ইঙ্গিত প্রদান করতে পারে, তাই আপনার যা প্রয়োজন তা নির্দিষ্ট করে দেওয়া ভাল, এমনকি সাধারণত ডিফল্ট হিসেবে প্রদান করা হলেও।

যেমন, 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 হেডার পার্সিংয়ে ফিরে যেতে হবে।

ক্রস-অরিজিন অনুরোধে হিন্ট ডেলিগেট করুন

আপনি যদি ক্রস-অরিজিন বা ক্রস-সাইট সাবরিসোর্সের জন্য অনুরোধ করেন যার জন্য User-Agent Client Hints তাদের অনুরোধে পাঠাতে হবে, তাহলে আপনাকে অনুমতি সংক্রান্ত নীতি ব্যবহার করে স্পষ্টভাবে কাঙ্ক্ষিত ইঙ্গিতগুলি নির্দিষ্ট করতে হবে।

যেমন, ধরা যাক https://blog.site, https://cdn.site-এ রিসোর্স হোস্ট করে, যা নির্দিষ্ট ডিভাইসের জন্য অপ্টিমাইজ করা রিসোর্স ফিরিয়ে দিতে পারে। https://blog.site, Sec-CH-UA-Model হিন্টের জন্য জিজ্ঞাসা করতে পারে, তবে Permissions-Policy হেডার ব্যবহার করে https://cdn.site-এ স্পষ্টভাবে ডেলিগেট করতে হবে। নীতি-নিয়ন্ত্রিত হিন্টের তালিকা Clients Hints Infrastructure ড্রাফ্ট-এ উপলভ্য আছে

⬇️ 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-এর জন্য ↪️ HTML

<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

এর ফলে প্রথম অনুরোধেই আবার চেষ্টা করার ওভারহেড খরচ হয়, তবে প্রয়োগ করার খরচ তুলনামূলকভাবে কম। অতিরিক্ত হেডার পাঠান এবং ব্রাউজার বাকি কাজ করে দেবে।

এমন পরিস্থিতিতে যেখানে প্রথমবার পৃষ্ঠা লোড করার সময় আপনার অতিরিক্ত হিন্টের প্রয়োজন হয়, সেখানে Client Hints Reliability প্রস্তাব কানেকশন-লেভেল সেটিংসে হিন্ট নির্দিষ্ট করার জন্য একটি রুট তৈরি করছে। HTTP/2 এবং HTTP/3 কানেকশনে এই আগাম ইঙ্গিত পাঠানোর সুবিধা চালু করতে, এটি TLS 1.3-এর অ্যাপ্লিকেশন-লেয়ার প্রোটোকল সেটিংস(ALPS) এক্সটেনশন ব্যবহার করে। এটি এখনও খুব প্রাথমিক পর্যায়ে রয়েছে, তবে আপনি যদি নিজের TLS ও কানেকশন সেটিংস সক্রিয়ভাবে ম্যানেজ করেন, তাহলে কন্ট্রিবিউট করার জন্য এটিই আদর্শ সময়।

পুরনো ভার্সনের জন্য সহায়তা

আপনার সাইটে লিগ্যাসি বা থার্ড-পার্টি কোড থাকতে পারে যা navigator.userAgent-এর উপর নির্ভর করে, যার মধ্যে ইউজার-এজেন্ট স্ট্রিংয়ের অংশও অন্তর্ভুক্ত যা কমানো হবে। আপনাকে সমতুল্য navigator.userAgentData কলে যাওয়ার পরিকল্পনা করতে হবে, তবে একটি অন্তর্বর্তী সমাধান আছে।

UA-CH রেট্রোফিল হল একটি ছোট লাইব্রেরি যা আপনাকে অনুরোধ করা navigator.userAgentData ভ্যালু থেকে তৈরি একটি নতুন স্ট্রিং দিয়ে navigator.userAgent ওভাররাইট করতে দেয়।

যেমন, এই কোডটি একটি ইউজার-এজেন্ট স্ট্রিং তৈরি করে যা অতিরিক্তভাবে "মডেল" ইঙ্গিত অন্তর্ভুক্ত করে:

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 repo-তে আলোচনা শুরু করুন এবং আমরা একসাথে আপনার সমস্যাটি খতিয়ে দেখতে পারি।