Tóm tắt
Chính sách tính năng cho phép các nhà phát triển web bật, tắt và sửa đổi hành vi của một số API và tính năng web trong trình duyệt một cách có chọn lọc. Điều này giống như CSP, nhưng thay vì kiểm soát mức độ bảo mật, thì nó lại kiểm soát các tính năng!
Bản thân chính sách tính năng là những thoả thuận nhỏ giữa nhà phát triển và trình duyệt, có thể giúp chúng tôi đạt được mục tiêu xây dựng (và duy trì) các ứng dụng web chất lượng cao.
Giới thiệu
Xây dựng cho web là một cuộc phiêu lưu đầy khó khăn. Việc xây dựng một ứng dụng web hàng đầu giúp nâng cao hiệu suất và sử dụng tất cả các phương pháp hay nhất và mới nhất là điều không đủ. Việc duy trì trải nghiệm đó theo thời gian thậm chí còn khó hơn nữa. Khi dự án của bạn phát triển, các nhà phát triển sẽ tham gia, các tính năng mới xuất hiện và cơ sở mã cũng phát triển. Trải nghiệm tuyệt vời đó TM mà bạn từng đạt được có thể bắt đầu xấu đi và trải nghiệm người dùng bắt đầu bị ảnh hưởng! Chính sách về tính năng được thiết kế để giúp bạn đi đúng hướng.
Với Chính sách tính năng, bạn chọn sử dụng một bộ "chính sách" cho trình duyệt để thực thi các tính năng cụ thể được dùng trên toàn bộ trang web của bạn. Các chính sách này hạn chế những API mà trang web có thể truy cập hoặc sửa đổi hành vi mặc định của trình duyệt đối với một số tính năng.
Dưới đây là ví dụ về những việc bạn có thể thực hiện với Chính sách về tính năng:
- Thay đổi hành vi mặc định của
autoplay
trên thiết bị di động và video của bên thứ ba. - Hạn chế một trang web sử dụng các API nhạy cảm như
camera
hoặcmicrophone
. - Cho phép iframe sử dụng API
fullscreen
. - Chặn việc sử dụng các API lỗi thời như XHR và
document.write()
đồng bộ. - Đảm bảo hình ảnh có kích thước phù hợp (ví dụ: để tránh tình trạng đơ bố cục) và không quá lớn so với khung nhìn (ví dụ: lãng phí băng thông của người dùng).
Chính sách là hợp đồng giữa nhà phát triển và trình duyệt. Chúng cho trình duyệt biết ý định của nhà phát triển là gì, do đó, giúp chúng tôi trung thực khi ứng dụng của chúng tôi cố gắng rời đi và làm điều gì đó xấu. Nếu trang web hoặc nội dung được nhúng của bên thứ ba cố gắng vi phạm bất kỳ quy tắc nào của nhà phát triển đã chọn sẵn, thì trình duyệt sẽ ghi đè hành vi đó bằng trải nghiệm người dùng tốt hơn hoặc chặn API hoàn toàn.
Sử dụng chính sách tính năng
Chính sách về tính năng cung cấp hai cách để kiểm soát các tính năng:
- Thông qua tiêu đề HTTP
Feature-Policy
. - Bằng thuộc tính
allow
trên iframe.
Tiêu đề HTTP Feature-Policy
Cách dễ nhất để sử dụng Chính sách tính năng là gửi tiêu đề HTTP Feature-Policy
cùng với phản hồi của một trang. Giá trị của tiêu đề này là một chính sách hoặc bộ chính sách mà bạn muốn trình duyệt tôn trọng một nguồn gốc nhất định:
Feature-Policy: <feature> <allow list origin(s)>
Danh sách cho phép theo nguồn gốc có thể nhận một số giá trị khác nhau:
*
: Tính năng này được cho phép trong ngữ cảnh duyệt web cấp cao nhất và trong ngữ cảnh duyệt web lồng nhau (iframe).'self'
: Tính năng này được phép trong bối cảnh duyệt web cấp cao nhất và ngữ cảnh duyệt web lồng ghép có cùng nguồn gốc. Không được phép sử dụng tính năng này trong các tài liệu nhiều nguồn gốc trong ngữ cảnh duyệt web lồng nhau.'none'
: Tính năng này không được phép trong ngữ cảnh duyệt web cấp cao nhất và không được phép trong ngữ cảnh duyệt web lồng nhau.<origin(s)>
: những nguồn gốc cụ thể để bật chính sách (ví dụ:https://example.com
).
Ví dụ
Giả sử bạn muốn chặn tất cả nội dung sử dụng
API vị trí địa lý trên trang web của mình. Bạn có thể thực hiện việc này bằng cách gửi một danh sách cho phép nghiêm ngặt 'none'
cho tính năng geolocation
:
Feature-Policy: geolocation 'none'
Nếu một đoạn mã hoặc iframe cố gắng sử dụng API vị trí địa lý, thì trình duyệt sẽ chặn đoạn mã hoặc iframe đó. Điều này vẫn đúng ngay cả khi trước đây người dùng đã cấp quyền chia sẻ thông tin vị trí của họ.
![Vi phạm chính sách định vị vị trí đã đặt](https://developer.chrome.com/static/blog/feature-policy/image/violating-set-geolocatio-2e1e841fd18d8.png?authuser=5&hl=vi)
Trong các trường hợp khác, bạn có thể nới lỏng chính sách này một chút. Chúng tôi có thể cho phép nguồn gốc của mình sử dụng API vị trí địa lý nhưng ngăn nội dung của bên thứ ba truy cập vào API đó bằng cách đặt 'self'
trong danh sách cho phép:
Feature-Policy: geolocation 'self'
Thuộc tính iframe allow
Cách thứ hai để sử dụng Chính sách tính năng là kiểm soát nội dung trong iframe
. Sử dụng thuộc tính allow
để chỉ định danh sách chính sách cho nội dung được nhúng:
<!-- Allow all browsing contexts within this iframe to use fullscreen. -->
<iframe src="https://example.com..." allow="fullscreen"></iframe>
<!-- Equivalent to: -->
<iframe src="https://example.com..." allow="fullscreen *"></iframe>
<!-- Allow only iframe content on a particular origin to access the user's location. -->
<iframe
src="https://another-example.com/demos/..."
allow="geolocation https://another-example.com"
></iframe>
Còn các thuộc tính iframe hiện có thì sao?
Một số tính năng do Chính sách tính năng kiểm soát hiện có một thuộc tính để kiểm soát hành vi của các tính năng đó. Ví dụ: <iframe allowfullscreen>
là một thuộc tính cho phép nội dung iframe sử dụng API HTMLElement.requestFullscreen()
. Ngoài ra, còn có các thuộc tính allowpaymentrequest
và allowusermedia
để cho phép API yêu cầu thanh toán và getUserMedia()
tương ứng.
Hãy thử dùng thuộc tính allow
thay cho các thuộc tính cũ này nếu có thể. Đối với các trường hợp bạn cần hỗ trợ khả năng tương thích ngược bằng cách sử dụng thuộc tính allow
với thuộc tính cũ tương đương (ví dụ: <iframe allowfullscreen allow="fullscreen">
). Bạn chỉ cần lưu ý rằng chính sách nào hạn chế hơn sẽ chiến thắng. Ví dụ: iframe sau
sẽ không được phép chuyển sang chế độ toàn màn hình vì
allow="fullscreen 'none'"
hạn chế hơn allowfullscreen
:
<!-- Blocks fullscreen access if the browser supports feature policy. -->
<iframe allowfullscreen allow="fullscreen 'none'" src="..."></iframe>
Kiểm soát nhiều chính sách cùng một lúc
Bạn có thể kiểm soát một số tính năng cùng lúc bằng cách gửi tiêu đề HTTP với một danh sách ;
các lệnh chính sách riêng biệt:
Feature-Policy: unsized-media 'none'; geolocation 'self' https://example.com; camera *;
hoặc bằng cách gửi một tiêu đề riêng cho từng chính sách:
Feature-Policy: unsized-media 'none'
Feature-Policy: geolocation 'self' https://example.com
Feature-Policy: camera *;
Ví dụ này sẽ thực hiện như sau:
- Không cho phép sử dụng
unsized-media
cho mọi ngữ cảnh duyệt web. - Không cho phép sử dụng
geolocation
cho mọi ngữ cảnh duyệt web, ngoại trừ nguồn gốc của trang vàhttps://example.com
. - Cho phép
camera
truy cập vào mọi ngữ cảnh duyệt web.
Ví dụ – đặt nhiều chính sách trên một iframe
<!-- Blocks the iframe from using the camera and microphone
(if the browser supports feature policy). -->
<iframe allow="camera 'none'; microphone 'none'"></iframe>
API JavaScript
Mặc dù Chrome 60 đã thêm tính năng hỗ trợ cho tiêu đề HTTP Feature-Policy
và thuộc tính allow
trên iframe, nhưng API JavaScript đã được thêm vào Chrome 74.
API này cho phép mã phía máy khách xác định tính năng nào được phép trên trang, khung hoặc trình duyệt. Bạn có thể truy cập vào các tiện ích của nó trong
document.featurePolicy
cho tài liệu chính hoặc frame.featurePolicy
cho
iframe.
Ví dụ:
Ví dụ bên dưới minh hoạ kết quả của việc gửi chính sách
Feature-Policy: geolocation 'self'
trên trang web https://example.com
:
/* @return {Array<string>} List of feature policies allowed by the page. */
document.featurePolicy.allowedFeatures();
// → ["geolocation", "midi", "camera", "usb", "autoplay",...]
/* @return {boolean} True if the page allows the 'geolocation' feature. */
document.featurePolicy.allowsFeature('geolocation');
// → true
/* @return {boolean} True if the provided origin allows the 'geolocation' feature. */
document.featurePolicy.allowsFeature(
'geolocation',
'https://another-example.com/'
);
// → false
/* @return {Array<string>} List of feature policies allowed by the browser
regardless of whether they are in force. */
document.featurePolicy.features();
// → ["geolocation", "midi", "camera", "usb", "autoplay",...]
/* @return {Array<string>} List of origins (used throughout the page) that are
allowed to use the 'geolocation' feature. */
document.featurePolicy.getAllowlistForFeature('geolocation');
// → ["https://example.com"]
Danh sách chính sách
Vậy Chính sách về tính năng có thể kiểm soát những tính năng nào?
Hiện tại, chúng tôi chưa có tài liệu về những chính sách sẽ được triển khai và cách sử dụng những chính sách đó. Danh sách này cũng sẽ tăng theo thời gian khi các trình duyệt khác nhau áp dụng quy cách và triển khai nhiều chính sách. Chính sách tính năng sẽ là một mục tiêu luôn thay đổi và chắc chắn sẽ cần tài liệu tham khảo tốt.
Hiện tại, có một số cách để xem những tính năng nào có thể điều khiển được.
- Hãy xem bản minh hoạ về Chính sách về tính năng Bồn rửa bát của chúng tôi. Bài viết này có các ví dụ về từng chính sách đã được triển khai trong Blink.
- Hãy xem nguồn của Chrome để biết danh sách tên tính năng.
- Truy vấn
document.featurePolicy.allowedFeatures()
trênabout:blank
để tìm danh sách:
["geolocation",
"midi",
"camera",
"usb",
"magnetometer",
"fullscreen",
"animations",
"payment",
"picture-in-picture",
"accelerometer",
"vr",
...
- Hãy truy cập chromestatus.com để biết các chính sách đã được triển khai hoặc đang được xem xét trong Blink.
Để xác định cách sử dụng một số chính sách này, vui lòng xem kho lưu trữ GitHub của quy cách. Video này chứa một số nội dung giải thích về một số chính sách.
Câu hỏi thường gặp
Khi nào tôi sử dụng Chính sách tính năng?
Tất cả các chính sách đều cho phép người dùng chọn tham gia, vì vậy, hãy sử dụng Chính sách về tính năng vào thời điểm/trường hợp thích hợp. Ví dụ: nếu ứng dụng của bạn là một thư viện hình ảnh, thì chính sách maximum-downscaling-image
sẽ giúp bạn tránh gửi những hình ảnh có kích thước lớn đến khung nhìn trên thiết bị di động.
Bạn nên thận trọng hơn khi sử dụng các chính sách khác như document-write
và sync-xhr
. Việc bật chế độ này có thể làm hỏng nội dung của bên thứ ba, chẳng hạn như quảng cáo. Mặt khác, Chính sách về tính năng có thể là một bước kiểm tra trực tiếp để đảm bảo các trang của bạn không bao giờ sử dụng những API nguy hiểm này!
Tôi có sử dụng Chính sách tính năng trong quá trình phát triển hoặc phát hành chính thức không?
Cả hai. Bạn nên bật chính sách trong quá trình phát triển và duy trì chính sách đó trong quá trình sản xuất. Việc bật chính sách trong quá trình phát triển có thể giúp bạn bắt đầu đi đúng hướng. Cách này sẽ giúp bạn phát hiện mọi sự hồi quy không mong muốn trước khi chúng xảy ra. Luôn bật các chính sách trong phiên bản phát hành công khai để đảm bảo trải nghiệm người dùng nhất định.
Có cách nào để báo cáo các trường hợp vi phạm chính sách đến máy chủ của tôi không?
API Báo cáo đang đang được phát triển! Tương tự như cách các trang web có thể chọn nhận báo cáo về lỗi vi phạm CSP hoặc ngừng sử dụng, bạn sẽ có thể nhận được báo cáo về các lỗi vi phạm chính sách của tính năng đang được áp dụng.
Các quy tắc kế thừa cho nội dung iframe là gì?
Tập lệnh (dù là tập lệnh thứ nhất hay bên thứ ba) đều kế thừa chính sách về ngữ cảnh duyệt web tương ứng. Điều đó có nghĩa là tập lệnh cấp cao nhất kế thừa các chính sách của tài liệu chính.
iframe
kế thừa các chính sách của trang gốc. Nếu iframe
có thuộc tính allow
, chính sách nghiêm ngặt hơn giữa trang mẹ và danh sách allow
sẽ giành chiến thắng. Để biết thêm thông tin về cách sử dụng iframe
, hãy xem
thuộc tính allow
trên iframe.
Nếu tôi áp dụng một chính sách thì chính sách đó có tồn tại trên các thao tác điều hướng trang không?
Không. Thời gian tồn tại của chính sách là dành cho một phản hồi điều hướng trang. Nếu người dùng chuyển đến một trang mới, thì tiêu đề Feature-Policy
phải được gửi một cách rõ ràng trong phản hồi mới để chính sách được áp dụng.
Những trình duyệt nào hỗ trợ Chính sách tính năng?
Hãy truy cập vào caniuse.com để biết thông tin chi tiết mới nhất về tính năng hỗ trợ trình duyệt.
Tại thời điểm này, Chrome là trình duyệt duy nhất hỗ trợ chính sách về tính năng. Tuy nhiên, vì toàn bộ nền tảng API đều cho phép người dùng chọn sử dụng hoặc có thể phát hiện tính năng, nên Chính sách về tính năng phù hợp với những tính năng nâng cao tăng dần.
Kết luận
Chính sách về tính năng có thể giúp cung cấp một lộ trình sáng suốt để cải thiện trải nghiệm người dùng cũng như mang lại hiệu suất tốt. Phương thức này đặc biệt hữu ích khi phát triển hoặc duy trì một ứng dụng vì nó có thể giúp tránh được khả năng xảy ra sát thương trước khi chúng xâm nhập vào cơ sở mã của bạn.
Tài nguyên khác:
- Nội dung giải thích về chính sách tính năng
- Quy cách của Chính sách tính năng
- Bản minh hoạ bồn rửa bát
- Tiện ích Công cụ cho nhà phát triển về chính sách tính năng – Người kiểm tra để dùng thử các chính sách của tính năng trên một trang.
- các mục nhập trên chromestatus.com