استراتيجيات لنقل موقعك الإلكتروني من الاعتماد على سلسلة وكيل المستخدم إلى حقول معلومات الوكيل المستخدم الجديدة
تاريخ النشر: 19 مايو 2021
سلسلة وكيل المستخدم هي مساحة سطحية مهمة لبصمات الأصابع السلبية في المتصفّحات، بالإضافة إلى صعوبة معالجتها. ومع ذلك، هناك جميع أنواع الأسباب الصالحة لجمع بيانات وكيل المستخدم ومعالجتها، لذا فإنّ المطلوب هو مسار للوصول إلى حلّ أفضل. توفّر حقول معلومات الوكيل المستخدم طريقة واضحة للإفصاح عن حاجتك إلى بيانات وكيل المستخدم، بالإضافة إلى طرق لعرض البيانات بتنسيق سهل الاستخدام.
في هذه المقالة، سنشرح لك كيفية تدقيق وصولك إلى بيانات وكيل المستخدم والانتقال من استخدام سلسلة وكيل المستخدم إلى حقول معلومات الوكيل المستخدم.
مراجعة جمع بيانات وكيل المستخدم واستخدامها
كما هو الحال مع أي شكل من أشكال جمع البيانات، يجب أن تفهم دائمًا سبب جمعها. الخطوة الأولى، بغض النظر عمّا إذا كنت ستتخذ أي إجراء أم لا، هي فهم مكان استخدام بيانات وكيل المستخدم وسبب استخدامها.
إذا لم تكن تعرف ما إذا كانت بيانات وكيل المستخدم تُستخدَم أو أين تُستخدَم، ننصحك بالبحث في رمز الواجهة الأمامية عن استخدام navigator.userAgent وفي رمز الواجهة الخلفية عن استخدام عنوان HTTP 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 من جهة العميل عند الطلب
إذا كنت تستخدم 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 الوصول إلى عناوين طلبات HTTP، لذا يمكن طلب قيم وكيل المستخدم في أي وقت.
موضع رأسي ثابت من جهة الخادم
إذا كنت تستخدم عنوان الطلب 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، ولكن يجب
تفويضه صراحةً إلى https://cdn.site باستخدام العنوان Permissions-Policy. تتوفّر قائمة التلميحات التي تتحكّم فيها السياسات في مسودة البنية الأساسية لحقول معلومات العميل.
⬇️ الردّ من 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
↪️ HTML لـ blog.site
<iframe src="https://widget.site" allow="ch-ua-model"></iframe>
⬆️ طلب إرسال أموال إلى "widget.site"
Sec-CH-UA-Model: "Pixel 5"
ستلغي السمة allow في إطار iframe أي عنوان 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
يؤدي ذلك إلى زيادة عبء إعادة المحاولة في الطلب الأول، ولكن تكلفة التنفيذ منخفضة نسبيًا. أرسِل العنوان الإضافي وسيتولى المتصفّح الباقي.
في الحالات التي تحتاج فيها إلى تلميحات إضافية عند تحميل الصفحة الأولى، يحدّد اقتراح موثوقية حقول معلومات العميل مسارًا لتحديد التلميحات في الإعدادات على مستوى الاتصال. يستفيد هذا من إضافة إعدادات بروتوكول طبقة التطبيقات (ALPS) إلى الإصدار 1.3 من بروتوكول TLS لإتاحة تمرير التلميحات مبكرًا على اتصالات HTTP/2 وHTTP/3. لا يزال هذا المشروع في مرحلة مبكرة جدًا، ولكن إذا كنت تدير بنفسك إعدادات بروتوكول أمان طبقة النقل (TLS) والاتصال، فهذا هو الوقت المثالي للمساهمة.
الدعم القديم
قد يتضمّن موقعك الإلكتروني رمزًا قديمًا أو رمزًا تابعًا لجهة خارجية يعتمد على
navigator.userAgent، بما في ذلك أجزاء من سلسلة وكيل المستخدم التي سيتم
تقليلها. يجب التخطيط للانتقال إلى مكالمات navigator.userAgentData المكافئة، ولكن هناك حل مؤقت.
UA-CH retrofill هي مكتبة صغيرة تتيح لك استبدال navigator.userAgent بسلسلة جديدة تم إنشاؤها من قيم navigator.userAgentData المطلوبة.
على سبيل المثال، ينشئ هذا الرمز سلسلة وكيل مستخدم تتضمّن أيضًا تلميح "model":
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 ويمكننا استكشاف المشكلة معًا.