ย้ายข้อมูลไปยังคำแนะนำของไคลเอ็นต์ User Agent

กลยุทธ์ในการย้ายข้อมูลเว็บไซต์จากการใช้สตริง User Agent ไปยังคำแนะนำสำหรับไคลเอ็นต์ User Agent ใหม่

เผยแพร่เมื่อวันที่ 19 พฤษภาคม 2021

สตริง User-Agent เป็นแพลตฟอร์มการทำฟิงเกอร์พริ้นต์แบบพาสซีฟที่สำคัญในเบราว์เซอร์ และยังประมวลผลได้ยากด้วย อย่างไรก็ตาม มีเหตุผลที่ถูกต้องมากมายในการรวบรวมและประมวลผลข้อมูล User Agent ดังนั้นสิ่งที่จำเป็นคือแนวทางในการแก้ปัญหาที่ดีกว่า คำแนะนำสำหรับไคลเอ็นต์ User Agent มีทั้งวิธีที่ชัดเจนในการประกาศความต้องการข้อมูล User Agent และวิธีแสดงข้อมูลในรูปแบบที่ใช้งานง่าย

ในส่วนนี้ เราจะแนะนำคุณเกี่ยวกับการตรวจสอบสิทธิ์เข้าถึงข้อมูล User Agent และการย้ายข้อมูลการใช้งานสตริง User Agent ไปยังคำแนะนำสำหรับไคลเอ็นต์ User Agent

Browser Support

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

Source

ตรวจสอบการเก็บรวบรวมและการใช้ข้อมูล User Agent

เช่นเดียวกับการเก็บรวบรวมข้อมูลรูปแบบอื่นๆ คุณควรเข้าใจเหตุผลในการเก็บรวบรวมข้อมูลเสมอ ขั้นตอนแรก ไม่ว่าคุณจะดำเนินการใดๆ หรือไม่ก็ตาม คือการทำความเข้าใจว่าคุณใช้ข้อมูล User Agent ที่ใดและเพราะเหตุใด

หากไม่ทราบว่ามีการใช้ข้อมูล User Agent หรือไม่ หรือใช้ที่ใด ให้ลองค้นหาโค้ดฟรอนท์เอนด์เพื่อดูการใช้ navigator.userAgent และโค้ดแบ็กเอนด์เพื่อดูการใช้ส่วนหัว HTTP User-Agent นอกจากนี้ คุณควรตรวจสอบโค้ดฟรอนท์เอนด์เพื่อดูการใช้ฟีเจอร์ที่เลิกใช้งานแล้ว เช่น navigator.platform และ navigator.appVersion

จากมุมมองด้านการทำงาน ให้พิจารณาตำแหน่งใดก็ตามในโค้ดที่คุณกำลังบันทึกหรือประมวลผลข้อมูลต่อไปนี้

  • ชื่อหรือเวอร์ชันของเบราว์เซอร์
  • ชื่อหรือเวอร์ชันของระบบปฏิบัติการ
  • ยี่ห้อหรือรุ่นของอุปกรณ์
  • ประเภท CPU, สถาปัตยกรรม หรือบิต (เช่น 64 บิต)

นอกจากนี้ คุณอาจใช้ไลบรารีหรือบริการของบุคคลที่สามเพื่อประมวลผล User Agent ด้วย ในกรณีนี้ ให้ตรวจสอบว่าผู้ให้บริการกำลังอัปเดตเพื่อรองรับคำแนะนำสำหรับไคลเอ็นต์ User Agent หรือไม่

คุณใช้เฉพาะข้อมูล User Agent พื้นฐานใช่ไหม

ชุดคำแนะนำสำหรับไคลเอ็นต์ User Agent เริ่มต้นประกอบด้วยข้อมูลต่อไปนี้

  • Sec-CH-UA: ชื่อเบราว์เซอร์และเวอร์ชันหลัก/สำคัญ
  • Sec-CH-UA-Mobile: ค่าบูลีนที่ระบุอุปกรณ์เคลื่อนที่
  • Sec-CH-UA-Platform: ชื่อระบบปฏิบัติการ

สตริง User Agent เวอร์ชันที่ลดลงซึ่งเสนอมานี้จะยังคงเก็บข้อมูลพื้นฐานนี้ไว้ในลักษณะที่เข้ากันได้แบบย้อนหลัง เช่น แทนที่จะเป็น Chrome/90.0.4430.85 สตริงจะมี Chrome/90.0.0.0

หากคุณตรวจสอบสตริง User Agent เพื่อหาชื่อเบราว์เซอร์ เวอร์ชันหลัก หรือระบบปฏิบัติการเท่านั้น โค้ดจะยังคงทำงานต่อไปแม้ว่าคุณอาจเห็นคำเตือนการเลิกใช้งานก็ตาม

แม้ว่าคุณจะย้ายข้อมูลไปยังคำแนะนำสำหรับไคลเอ็นต์ User Agent ได้และควรทำ แต่คุณอาจมีโค้ดเดิมหรือข้อจำกัดด้านทรัพยากรที่ทำให้ดำเนินการไม่ได้ การลดข้อมูลในสตริง User Agent ด้วยวิธีที่เข้ากันได้แบบย้อนหลังนี้มีจุดประสงค์เพื่อให้แน่ใจว่าแม้โค้ดที่มีอยู่จะได้รับข้อมูลที่มีรายละเอียดน้อยลง แต่ก็ควรยังคงรักษาฟังก์ชันการทำงานพื้นฐานไว้ได้

กลยุทธ์

คุณสามารถใช้กลยุทธ์ต่างๆ เพื่อย้ายข้อมูลการใช้สตริง User Agent ไปยังคำแนะนำสำหรับไคลเอ็นต์ User Agent

JavaScript API ฝั่งไคลเอ็นต์แบบออนดีมานด์

หากคุณใช้ navigator.userAgent คุณควรเปลี่ยนไปใช้ navigator.userAgentData ก่อนที่จะกลับไปแยกวิเคราะห์สตริง User Agent

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
}

หากต้องการค่า User Agent ที่มีเอนโทรปีสูงและมีรายละเอียดมากกว่านี้ คุณต้องระบุค่าดังกล่าวและตรวจสอบผลลัพธ์ใน Promise ที่แสดงผล

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

นอกจากนี้ คุณอาจต้องใช้กลยุทธ์นี้หากต้องการเปลี่ยนจากการประมวลผลฝั่งเซิร์ฟเวอร์เป็นการประมวลผลฝั่งไคลเอ็นต์ JavaScript API ไม่จำเป็นต้องเข้าถึงส่วนหัวของคำขอ HTTP ดังนั้นจึงสามารถขอค่า User Agent ได้ทุกเมื่อ

ส่วนหัวฝั่งเซิร์ฟเวอร์แบบคงที่

หากคุณใช้ส่วนหัวของคำขอ User-Agent ในเซิร์ฟเวอร์และความต้องการข้อมูลนั้นค่อนข้างสอดคล้องกันทั่วทั้งเว็บไซต์ คุณสามารถระบุคำแนะนำสำหรับไคลเอ็นต์เป็นชุดแบบคงที่ในการตอบกลับได้ วิธีนี้ค่อนข้างง่ายเนื่องจากโดยทั่วไปแล้วคุณจะต้องกำหนดค่าในตำแหน่งเดียวเท่านั้น เช่น อาจอยู่ในการกำหนดค่าเว็บเซิร์ฟเวอร์หากคุณเพิ่มส่วนหัวไว้ที่นั่นแล้ว การกำหนดค่าโฮสติ้ง หรือการกำหนดค่าระดับบนสุดของเฟรมเวิร์กหรือแพลตฟอร์มที่คุณใช้สำหรับเว็บไซต์

พิจารณาใช้กลยุทธ์นี้หากคุณกำลังเปลี่ยนรูปแบบหรือปรับแต่งการตอบกลับที่แสดงตามข้อมูล 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 หากไม่มีส่วนหัวดังกล่าว

มอบสิทธิ์คำแนะนำให้กับคำขอข้ามต้นทาง

หากคุณขอทรัพยากรย่อยแบบข้ามต้นทางหรือข้ามเว็บไซต์ที่ต้องส่งคำแนะนำสำหรับไคลเอ็นต์ 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

ต้องระบุคำแนะนำฝั่งเซิร์ฟเวอร์ของที่อยู่ในคำขอแรก

อาจมีบางกรณีที่คุณต้องการคำแนะนำมากกว่าชุดคำแนะนำเริ่มต้นในคำขอแรก แต่กรณีนี้อาจเกิดขึ้นไม่บ่อยนัก ดังนั้นโปรดตรวจสอบเหตุผล

คำขอแรกหมายถึงคำขอระดับบนสุดรายการแรกสุดสำหรับต้นทางนั้นที่ส่งในเซสชันการท่องเว็บนั้น ชุดคำแนะนำเริ่มต้นประกอบด้วยชื่อเบราว์เซอร์พร้อมเวอร์ชันหลัก แพลตฟอร์ม และสัญญาณบอกสถานะอุปกรณ์เคลื่อนที่ ดังนั้นคำถามที่ควรถามในที่นี้คือ คุณต้องการข้อมูลเพิ่มเติมในการโหลดหน้าเว็บครั้งแรกหรือไม่

หากต้องการคำใบ้เพิ่มเติมในคำขอแรก คุณมี 2 ตัวเลือกดังนี้ ก่อนอื่น คุณสามารถใช้ส่วนหัว 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

วิธีนี้จะทำให้เกิดค่าใช้จ่ายเพิ่มเติมในการลองใหม่ในคำขอแรก แต่ค่าใช้จ่ายในการติดตั้งใช้งานค่อนข้างต่ำ ส่งส่วนหัวเพิ่มเติม แล้วเบราว์เซอร์จะจัดการส่วนที่เหลือเอง

สำหรับสถานการณ์ที่คุณต้องการคำแนะนำเพิ่มเติมในการโหลดหน้าเว็บครั้งแรกจริงๆ ข้อเสนอความน่าเชื่อถือของคำแนะนำสำหรับไคลเอ็นต์จะวางเส้นทางเพื่อระบุคำแนะนำในการตั้งค่าระดับการเชื่อมต่อ ซึ่งใช้ประโยชน์จากส่วนขยาย Application-Layer Protocol Settings (ALPS) ของ TLS 1.3 เพื่อเปิดใช้การส่งคำแนะนำก่อนกำหนดนี้ในการเชื่อมต่อ HTTP/2 และ HTTP/3 แม้ว่าฟีเจอร์นี้จะยังอยู่ในช่วงเริ่มต้น แต่หากคุณจัดการการตั้งค่า TLS และการเชื่อมต่อด้วยตนเองอยู่แล้ว นี่ก็เป็นโอกาสดีที่จะมีส่วนร่วม

การสนับสนุนแบบเดิม

คุณอาจมีโค้ดเดิมหรือโค้ดของบุคคลที่สามในเว็บไซต์ที่ขึ้นอยู่กับ navigator.userAgent รวมถึงบางส่วนของสตริง User Agent ที่จะลดลง คุณควรวางแผนที่จะเปลี่ยนไปใช้การเรียก navigator.userAgentData ที่เทียบเท่า แต่ก็มีโซลูชันชั่วคราวให้ใช้

UA-CH retrofill เป็นไลบรารีขนาดเล็กที่ช่วยให้คุณเขียนทับ navigator.userAgent ด้วยสตริงใหม่ที่สร้างจากค่า navigator.userAgentData ที่ขอได้

ตัวอย่างเช่น โค้ดนี้จะสร้างสตริง User Agent ที่มีคำแนะนำ "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 แล้วเราจะสำรวจปัญหาของคุณร่วมกัน