กลยุทธ์ในการย้ายข้อมูลเว็บไซต์จากการใช้สตริง User Agent ไปยังคำแนะนำสำหรับไคลเอ็นต์ User Agent ใหม่
เผยแพร่เมื่อวันที่ 19 พฤษภาคม 2021
สตริง User-Agent เป็นแพลตฟอร์มการทำฟิงเกอร์พริ้นต์แบบพาสซีฟที่สำคัญในเบราว์เซอร์ และยังประมวลผลได้ยากด้วย อย่างไรก็ตาม มีเหตุผลที่ถูกต้องมากมายในการรวบรวมและประมวลผลข้อมูล User Agent ดังนั้นสิ่งที่จำเป็นคือแนวทางในการแก้ปัญหาที่ดีกว่า คำแนะนำสำหรับไคลเอ็นต์ User Agent มีทั้งวิธีที่ชัดเจนในการประกาศความต้องการข้อมูล User Agent และวิธีแสดงข้อมูลในรูปแบบที่ใช้งานง่าย
ในส่วนนี้ เราจะแนะนำคุณเกี่ยวกับการตรวจสอบสิทธิ์เข้าถึงข้อมูล User Agent และการย้ายข้อมูลการใช้งานสตริง User Agent ไปยังคำแนะนำสำหรับไคลเอ็นต์ User Agent
ตรวจสอบการเก็บรวบรวมและการใช้ข้อมูล 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 แล้วเราจะสำรวจปัญหาของคุณร่วมกัน