blob: 2447fb5302baa588a9659f94c0e05d263372aafa [file] [log] [blame] [view]
Chris Palmer554c66e2017-07-29 01:02:561# Chrome Security FAQ
2
3[TOC]
4
Alex Goughe7bcbea2022-05-03 21:45:345## Process
6
7<a name="TOC-Which-bugs-are-valid-for-rewards-under-the-Chrome-Vulnerability-Rewards-program-"></a>
8### Which bugs are valid for rewards under the Chrome Vulnerability Rewards program?
9
10Please see [the VRP FAQ page](vrp-faq.md).
11
Chris Palmer554c66e2017-07-29 01:02:5612<a name="TOC-Why-are-security-bugs-hidden-in-the-Chromium-issue-tracker-"></a>
Alex Goughe7bcbea2022-05-03 21:45:3413### Why are security bugs hidden in the Chromium issue tracker?
Chris Palmer554c66e2017-07-29 01:02:5614
15We must balance a commitment to openness with a commitment to avoiding
16unnecessary risk for users of widely-used open source libraries.
17
18<a name="TOC-Can-you-please-un-hide-old-security-bugs-"></a>
Alex Goughe7bcbea2022-05-03 21:45:3419### Can you please un-hide old security bugs?
Chris Palmer554c66e2017-07-29 01:02:5620
21Our goal is to open security bugs to the public once the bug is fixed and the
22fix has been shipped to a majority of users. However, many vulnerabilities
23affect products besides Chromium, and we don’t want to put users of those
24products unnecessarily at risk by opening the bug before fixes for the other
25affected products have shipped.
26
27Therefore, we make all security bugs public within approximately 14 weeks of the
28fix landing in the Chromium repository. The exception to this is in the event of
29the bug reporter or some other responsible party explicitly requesting anonymity
30or protection against disclosing other particularly sensitive data included in
31the vulnerability report (e.g. username and password pairs).
32
33<a name="TOC-Can-I-get-advance-notice-about-security-bugs-"></a>
Alex Goughe7bcbea2022-05-03 21:45:3434### Can I get advance notice about security bugs?
Chris Palmer554c66e2017-07-29 01:02:5635
36Vendors of products based on Chromium, distributors of operating systems that
37bundle Chromium, and individuals and organizations that significantly contribute
38to fixing security bugs can be added to a list for earlier access to these bugs.
39You can email us at [email protected] to request to join the list if you
40meet the above criteria. In particular, vendors of anti-malware, IDS/IPS,
41vulnerability risk assessment, and similar products or services do not meet this
42bar.
43
44Please note that the safest version of Chrome/Chromium is always the latest
45stable version — there is no good reason to wait to upgrade, so enterprise
46deployments should always track the latest stable release. When you do this,
47there is no need to further assess the risk of Chromium vulnerabilities: we
48strive to fix vulnerabilities quickly and release often.
49
Alex Goughccfbbb52023-05-16 14:42:1950<a name="TOC-How-can-I-know-which-fixes-to-include-in-my-downstream-project-"></a>
Alex Goughc9ab81fd2023-05-15 19:03:1451### How can I know which fixes to include in my downstream project?
52
53Chrome is built with mitigations and hardening which aim to prevent or reduce
54the impact of security issues. We classify bugs as security issues if they are
55known to affect a version and configuration of Chrome that we ship to the
56public. Some classes of bug might present as security issues if Chrome was
57compiled with different flags, or linked against a different C++ standard
58library, but do not with the toolchain and configuration that we use to build
59Chrome. We discuss some of these cases elsewhere in this FAQ.
60
Amy Resslerb35f8e5d2024-02-02 23:12:5461If we become aware of them, these issues may be triaged as `Type=Vulnerability,
62Security_Impact-None` or as `Type=Bug` because they do not affect the production
Alex Goughc9ab81fd2023-05-15 19:03:1463version of Chrome. They may or may not be immediately visible to the public in
64the bug tracker, and may or may not be identified as security issues. If fixes
65are landed, they may or may not be merged from HEAD to a release branch. Chrome
66will only label, fix and merge security issues in Chrome, but attackers can
67still analyze public issues, or commits in the Chromium project to identify bugs
68that might be exploitable in other contexts.
69
70Chromium embedders and other downstream projects may build with different
71compilers, compile options, target operating systems, standard library, or
72additional software components. It is possible that some issues Chrome
73classifies as functional issues will manifest as security issues in a product
74embedding Chromium - it is the responsibility of any such project to understand
75what code they are shipping, and how it is compiled. We recommend using Chrome's
76[configuration](https://source.chromium.org/chromium/chromium/src/+/main:build/config/)
77whenever possible.
78
Chris Palmer554c66e2017-07-29 01:02:5679<a name="TOC-Can-I-see-these-security-bugs-so-that-I-can-back-port-the-fixes-to-my-downstream-project-"></a>
Alex Goughe7bcbea2022-05-03 21:45:3480### Can I see these security bugs so that I can back-port the fixes to my downstream project?
Chris Palmer554c66e2017-07-29 01:02:5681
82Many developers of other projects use V8, Chromium, and sub-components of
83Chromium in their own projects. This is great! We are glad that Chromium and V8
84suit your needs.
85
86We want to open up fixed security bugs (as described in the previous answer),
87and will generally give downstream developers access sooner. **However, please
88be aware that backporting security patches from recent versions to old versions
89cannot always work.** (There are several reasons for this: The patch won't apply
90to old versions; the solution was to add or remove a feature or change an API;
91the issue may seem minor until it's too late; and so on.) We believe the latest
92stable versions of Chromium and V8 are the most stable and secure. We also
93believe that tracking the latest stable upstream is usually less work for
94greater benefit in the long run than backporting. We strongly recommend that you
95track the latest stable branches, and we support only the latest stable branch.
96
Eric Lawrence122e86882017-12-07 22:53:0597<a name="TOC-Severity-Guidelines"></a>
Alex Goughe7bcbea2022-05-03 21:45:3498### How does the Chrome team determine severity of security bugs?
Eric Lawrence122e86882017-12-07 22:53:0599
100See the [severity guidelines](severity-guidelines.md) for more information.
Tom Sepeze8fb33202018-11-01 19:31:32101Only security issues are considered under the security vulnerability rewards
102program. Other types of bugs, which we call "functional bugs", are not.
Eric Lawrence122e86882017-12-07 22:53:05103
Alex Goughe7bcbea2022-05-03 21:45:34104## Threat Model
Chris Palmer554c66e2017-07-29 01:02:56105
Eric Lawrence15fdea252017-08-09 19:37:41106<a name="TOC-Timing-Attacks"></a>
Alex Goughe7bcbea2022-05-03 21:45:34107### Are timing attacks considered security vulnerabilities?
Eric Lawrence15fdea252017-08-09 19:37:41108
109Some timing attacks are considered security vulnerabilities, and some are
110considered privacy vulnerabilities. Timing attacks vary significantly in terms
111of impact, reliability, and exploitability.
112
113Some timing attacks weaken mitigations like ASLR (e.g.
114[Issue 665930](https://crbug.com/665930)). Others attempt to circumvent the same
115origin policy, for instance, by using SVG filters to read pixels
116cross-origin (e.g. [Issue 686253](https://crbug.com/686253) and
117[Issue 615851](https://crbug.com/615851)).
118
119Many timing attacks rely upon the availability of high-resolution timing
120information [Issue 508166](https://crbug.com/508166); such timing data often has
121legitimate usefulness in non-attack scenarios making it unappealing to remove.
122
123Timing attacks against the browser's HTTP Cache (like
124[Issue 74987](https://crbug.com/74987)) can potentially leak information about
125which sites the user has previously loaded. The browser could attempt to protect
126against such attacks (e.g. by bypassing the cache) at the cost of performance
127and thus user-experience. To mitigate against such timing attacks, end-users can
128delete browsing history and/or browse sensitive sites using Chrome's Incognito
129or Guest browsing modes.
130
131Other timing attacks can be mitigated via clever design changes. For instance,
132[Issue 544765](https://crbug.com/544765) describes an attack whereby an attacker
133can probe for the presence of HSTS rules (set by prior site visits) by timing
Eric Lawrence29ca2722018-02-22 19:04:05134the load of resources with URLs "fixed-up" by HSTS. Prior to Chrome 64, HSTS
135rules [were shared](https://crbug.com/774643) between regular browsing and
136Incognito mode, making the attack more interesting. The attack was mitigated by
137changing Content-Security-Policy such that secure URLs will match rules
138demanding non-secure HTTP urls, a fix that has also proven useful to help to
139unblock migrations to HTTPS. Similarly, [Issue 707071](https://crbug.com/707071)
140describes a timing attack in which an attacker could determine what Android
141applications are installed; the attack was mitigated by introducing randomness
142in the execution time of the affected API.
Eric Lawrence15fdea252017-08-09 19:37:41143
Alex Goughe7bcbea2022-05-03 21:45:34144<a name="TOC-What-if-a-Chrome-component-breaks-an-OS-security-boundary-"></a>
145### What if a Chrome component breaks an OS security boundary?
146
147If Chrome or any of its components (e.g. updater) can be abused to
148perform a local privilege escalation, then it may be treated as a
149valid security vulnerability.
150
151Running any Chrome component with higher privileges than intended is
152not a security bug and we do not recommend running Chrome as an
153Administrator on Windows, or as root on POSIX.
154
155<a name="TOC-Why-isn-t-passive-browser-fingerprinting-including-passive-cookies-in-Chrome-s-threat-model-"></a>
156<a name="TOC-What-is-Chrome-s-threat-model-for-fingerprinting-"></a>
157### What is Chrome's threat model for fingerprinting?
158
159> **Update, August 2019:** Please note that this answer has changed. We have
160> updated our threat model to include fingerprinting.
161
162Although [we do not consider fingerprinting issues to be *security
163vulnerabilities*](#TOC-Are-privacy-issues-considered-security-bugs-), we do now
164consider them to be privacy bugs that we will try to resolve. We distinguish two
165forms of fingerprinting.
166
167* **Passive fingerprinting** refers to fingerprinting techniques that do not
168require a JavaScript API call to achieve. This includes (but is not limited to)
169mechanisms like [ETag
170cookies](https://en.wikipedia.org/wiki/HTTP_ETag#Tracking_using_ETags) and [HSTS
171cookies](https://security.stackexchange.com/questions/79518/what-are-hsts-super-cookies).
172* **Active fingerprinting** refers to fingerprinting techniques that do require
173a JavaScript API call to achieve. Examples include most of the techniques in
174[EFF's Panopticlick proof of concept](https://panopticlick.eff.org).
175
176For passive fingerprinting, our ultimate goal is (to the extent possible) to
177reduce the information content available to below the threshold for usefulness.
178
179For active fingerprinting, our ultimate goal is to establish a [privacy
180budget](https://github.com/bslassey/privacy-budget) and to keep web origins
181below the budget (such as by rejecting some API calls when the origin exceeds
182its budget). To avoid breaking rich web applications that people want to use,
183Chrome may increase an origin's budget when it detects that a person is using
184the origin heavily. As with passive fingerprinting, our goal is to set the
185default budget below the threshold of usefulness for fingerprinting.
186
187These are both long-term goals. As of this writing (August 2019) we do not
188expect that Chrome will immediately achieve them.
189
190For background on fingerprinting and the difficulty of stopping it, see [Arvind
191Narayanan's site](https://33bits.wordpress.com/about/) and [Peter Eckersley's
192discussion of the information theory behind
193Panopticlick](https://www.eff.org/deeplinks/2010/01/primer-information-theory-and-privacy).
194There is also [a pretty good analysis of in-browser fingerprinting
195vectors](https://dev.chromium.org/Home/chromium-security/client-identification-mechanisms).
196
197<a name="TOC-I-found-a-phishing-or-malware-site-not-blocked-by-Safe-Browsing.-Is-this-a-security-vulnerability-"></a>
198### I found a phishing or malware site not blocked by Safe Browsing. Is this a security vulnerability?
199
200Malicious sites not yet blocked by Safe Browsing can be reported via
201[https://www.google.com/safebrowsing/report_phish/](https://www.google.com/safebrowsing/report_phish/).
202Safe Browsing is primarily a blocklist of known-unsafe sites; the feature warns
203the user if they attempt to navigate to a site known to deliver phishing or
204malware content. You can learn more about this feature in these references:
205
206* [https://developers.google.com/safe-browsing/](https://developers.google.com/safe-browsing/)
207* [https://www.google.com/transparencyreport/safebrowsing/](https://www.google.com/transparencyreport/safebrowsing/)
208
209In general, it is not considered a security bug if a given malicious site is not
210blocked by the Safe Browsing feature, unless the site is on the blocklist but is
211allowed to load anyway. For instance, if a site found a way to navigate through
212the blocking red warning page without user interaction, that would be a security
213bug. A malicious site may exploit a security vulnerability (for instance,
214spoofing the URL in the **Location Bar**). This would be tracked as a security
215vulnerability in the relevant feature, not Safe Browsing itself.
216
217<a name="TOC-I-can-download-a-file-with-an-unsafe-extension-and-it-is-not-classified-as-dangerous-"></a>
218### I can download a file with an unsafe extension and it is not classified as dangerous - is this a security bug?
219
220Chrome tries to warn users before they open files that might modify their
221system. What counts as a dangerous file will vary depending on the operating
222system Chrome is running on, the default set of file handlers, Chrome settings,
223Enterprise policy and verdicts on both the site and the file from [Safe
224Browsing](https://code.google.com/apis/safebrowsing/). Because of this it will
225often be okay for a user to download and run a file. However, if you can clearly
226demonstrate how to bypass one of these protections then we’d like to hear about
227it. You can see if a Safe Browsing check happened by opening
228chrome://safe-browsing before starting the download.
229
Daniel Ruberyc7ac344232023-10-09 22:16:20230<a name="TOC-what-about-dangerous-file-types-not-listed-in-the-file-type-policy-"></a>
231### What about dangerous file types not listed in the file type policy?
232
233The [file type
234policy](https://source.chromium.org/chromium/chromium/src/+/main:components/safe_browsing/content/resources/download_file_types.asciipb?q=download_file_types.asciipb%20-f:%2Fgen%2F&ss=chromium)
235controls some details of which security checks to enable for a given file
236extension. Most importantly, it controls whether we contact Safe Browsing about
237a download, and whether we show a warning for all downloads of that file type.
238Starting in M74, the default for unknown file types has been to contact Safe
239Browsing. This prevents large-scale abuse from a previously unknown file type.
240Starting in M105, showing a warning for all downloads of an extension became
241reserved for exceptionally dangerous file types that can compromise a user
242without any user interaction with the file (e.g. DLL hijacking). If you discover
243a new file type that meets that condition, we’d like to hear about it.
244
Daseul Leed2b02532024-01-09 15:22:10245<a name="TOC-i-found-a-local-file-or-directory-that-may-be-security-sensitive-and-is-not-blocked-by-file-system-access-api-"></a>
246### I found a local file or directory that may be security-sensitive and is not blocked by File System Access API - is this a security bug?
247
248The File System Access API maintains a [blocklist](https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/file_system_access/chrome_file_system_access_permission_context.cc;l=266-346)
249of directories and files that may be sensitive such as systems file, and if user
250chooses a file or a directory matching the list on a site using File System
251Access API, the access is blocked.
252
253The blocklist is designed to help mitigate accidental granting by users by
254listing well-known, security-sensitive locations, as a defense in-depth
255strategy. Therefore, the blocklist coverage is not deemed as a security bug,
256especially as it requires user's explicit selection on a file or a directory
257from the file picker.
258
Alex Goughe7bcbea2022-05-03 21:45:34259<a name="TOC-I-can-download-a-file-with-an-unsafe-extension-but-a-different-extension-or-file-type-is-shown-to-the-user-"></a>
260### I can download a file with an unsafe extension but a different extension or file type is shown to the user - is this a security bug?
Alex Gough6d37dae2024-10-02 23:37:36261
262See [file types](#TOC-The-wrong-description-for-a-file-type-is-added-by-Chrome-).
263
Alex Goughe7bcbea2022-05-03 21:45:34264<a name="TOC-Extensions-for-downloaded-files-are-not-shown-in-a-file-dialog-"></a>
265### Extensions for downloaded files are not shown in a file dialog - is this a security bug?
Alex Gough6d37dae2024-10-02 23:37:36266
267See [file types](#TOC-The-wrong-description-for-a-file-type-is-added-by-Chrome-).
268
Alex Goughe7bcbea2022-05-03 21:45:34269<a name="TOC-The-wrong-description-for-a-file-type-is-added-by-Chrome-"></a>
270### The wrong description for a file type is added by Chrome - is this a security bug?
271
272Chrome tries to let users know what they will be saving and downloading before
273they do so. Often operating systems will obscure a file’s type or extension and
274there is little we can do about that. Chrome shows information to help users
275make these decisions, both in Chrome-owned UI and in information that Chrome
276passes to OS-owned UI. If this information can be manipulated from a web site to
277mislead a user, then we’d like to hear about it.
278[Example](https://crbug.com/1137247).
279
280<a name="TOC-I-can-download-a-file-and-OS-indicators-for-its-provenance-are-not-applied-"></a>
281### I can download a file and OS indicators for its provenance are not applied - is this a security bug?
282
283Chrome attempts to label files downloaded from the internet with metadata using
284operating system APIs where these are available – for instance applying the Mark
285of the Web on Windows. This is often not possible (for instance on non-NTFS file
286systems on Windows, or for files inside downloaded archives) or disabled by
287policy. If a web site can cause Chrome to download a file without Chrome then
288adding this metadata as usual, we’d like to hear about it.
289
290<a name="TOC-I-can-cause-a-hard-or-soft-link-to-be-written-to-a-directory-bypassing-normal-OS-blocks-"></a>
291### I can cause a hard or soft link to be written to a directory bypassing normal OS blocks - is this a security bug?
292
293Chrome should not allow filesystem links to be created by initiating a download.
294[Example](https://crbug.com/1140417). [Example](https://crbug.com/1137247#c12).
295
296<a name="TOC-I-can-hijack-a-user-gesture-and-trick-a-user-into-accepting-a-permission-or-downloading-a-file-"></a>
297### I can hijack a user gesture and trick a user into accepting a permission or downloading a file - is this a security bug?
298
299Chrome tries to design its prompts to select safe defaults. If a prompt can
300accidentally be accepted without the user having an opportunity to make a
301decision about the prompt then we’d like to know. Examples might include poor
302defaults so that a user holding down an enter key might accept a dialog they
303would want to dismiss. [Example](https://crbug.com/854455#c11).
304
305Note that a user navigating to a download will cause a file to be
306[downloaded](https://crbug.com/1114592).
307
Arthur Sonzognib89b25f2024-02-13 16:11:22308<a name="TOC-security-properties-not-inherited-using-contextual-menu-"></a>
309### Sandbox/CSP/etc... security properties are not inherited when navigating using the middle-click/contextual-menu - is this a security bug?
310
311The security properties of the document providing the URL are not used/inherited
312when the user deliberately opens a link in a popup using one of:
313
314- Ctrl + left-click (Open link in new tab)
315- Shift + left-click (Open link in new window)
316- Middle-click (Open a link in a new tab)
317- Right-click > "Open link in ..."
318
319These methods of following a link have more or less the same implications as the
320user copying the link's URL and pasting it into a newly-opened window. We treat
321them as user-initiated top-level navigations, and as such will not apply or
322inherit policy restrictions into the new context
323
324Example of security related properties:
325
326- Content-Security-Policy
327- Cross-Origin-Embedder-Policy
328- Cross-Origin-Opener-Policy
329- Origin
330- Referrer
331- Sandbox
332- etc...
333
334These browser's actions/shortcuts are specific to Chrome. They are different
335from the behavior specified by the web-platform, such as using executing
336`window.open()` or opening a link with the `target=_blank` attribute.
337
Chris Palmer5649f942024-09-25 19:46:29338<a name="TOC-What-is-the-threat-model-for-Chrome-for-Testing"></a>
Adrian Taylorfe24932e2024-05-15 15:59:56339### What is the threat model for Chrome for Testing?
340
341[Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing) is a
342distribution of current and older versions of Chrome. It does not auto-update.
343Therefore, it may lack recent fixes for security bugs. Security bugs can more
344easily be exploited once their fixes are [published in the main Chromium source
345code repository](updates.md) and so it is unsafe to use Chrome for Testing to
346access any untrusted website. You should use Chrome for Testing only for
347browser automation and testing purposes, consuming only trustworthy content.
348`chrome-headless-shell` also lacks auto-updates and so, for the same reason,
349should only be used to consume trusted content.
350
Alex Goughe7bcbea2022-05-03 21:45:34351## Areas outside Chrome's Threat Model
352
353<a name="TOC-Are-privacy-issues-considered-security-bugs-"></a>
354### Are privacy issues considered security bugs?
355
356No. The Chrome Privacy team treats privacy issues, such as leaking information
357from Incognito, fingerprinting, and bugs related to deleting browsing data as
358functional bugs.
359
360Privacy issues are not considered under the security vulnerability rewards
361program; the [severity guidelines](severity-guidelines.md) outline the types of
362bugs that are considered security vulnerabilities in more detail.
363
Chris Palmer554c66e2017-07-29 01:02:56364<a name="TOC-What-are-the-security-and-privacy-guarantees-of-Incognito-mode-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34365### What are the security and privacy guarantees of Incognito mode?
Chris Palmer554c66e2017-07-29 01:02:56366
367Bugs in Incognito mode are tracked as privacy bugs, not security bugs.
368
Chris Palmer9839ce42017-08-16 20:59:15369The [Help Center](https://support.google.com/chrome/?p=cpn_incognito) explains
370what privacy protections Incognito mode attempts to enforce. In particular,
371please note that Incognito is not a “do not track” mode, and it does not hide
372aspects of your identity from web sites. Chrome does offer a way to send Do Not
373Track request to servers; see chrome://settings/?search=do+not+track
Chris Palmer554c66e2017-07-29 01:02:56374
375When in Incognito mode, Chrome does not store any new history, cookies, or other
376state in non-volatile storage. However, Incognito windows will be able to access
377some previously-stored state, such as browsing history.
378
Alex Goughe7bcbea2022-05-03 21:45:34379<a name="TOC-Are-XSS-filter-bypasses-considered-security-bugs-"></a>
380### Are XSS filter bypasses considered security bugs?
381
382No. Chromium once contained a reflected XSS filter called the [XSSAuditor](https://www.chromium.org/developers/design-documents/xss-auditor)
383that was a best-effort second line of defense against reflected XSS flaws found
384in web sites. The XSS Auditor was [removed in Chrome 78](https://groups.google.com/a/chromium.org/forum/#!msg/blink-dev/TuYw-EZhO9g/blGViehIAwAJ).
Tom Sepezfd089b8f2023-08-09 17:31:44385Consequently, Chromium no longer takes any special action in response to an
386X-XSS-Protection header.
Alex Goughe7bcbea2022-05-03 21:45:34387
Chris Palmer554c66e2017-07-29 01:02:56388<a name="TOC-Are-denial-of-service-issues-considered-security-bugs-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34389### Are denial of service issues considered security bugs?
Chris Palmer554c66e2017-07-29 01:02:56390
Tom Sepeze8fb33202018-11-01 19:31:32391No. Denial of Service (DoS) issues are treated as **abuse** or **stability**
392issues rather than security vulnerabilities.
Chris Palmer554c66e2017-07-29 01:02:56393
Lukasz Anforowicza2be83462024-02-15 20:49:12394* If you find a reproducible crash (e.g. a way to hit a `CHECK`),
395 we encourage you to [report it](https://issues.chromium.org/new).
Chris Palmer554c66e2017-07-29 01:02:56396* If you find a site that is abusing the user experience (e.g. preventing you
397 from leaving a site), we encourage you to [report
Amy Resslerb35f8e5d2024-02-02 23:12:54398 it](https://issues.chromium.org/new).
Chris Palmer554c66e2017-07-29 01:02:56399
400DoS issues are not considered under the security vulnerability rewards program;
Varun Khanejadf1bc00e2017-08-10 05:22:40401the [severity guidelines](severity-guidelines.md) outline the types of bugs that
402are considered security vulnerabilities in more detail.
Chris Palmer554c66e2017-07-29 01:02:56403
Chris Palmer554c66e2017-07-29 01:02:56404<a name="TOC-Why-aren-t-physically-local-attacks-in-Chrome-s-threat-model-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34405### Why aren't physically-local attacks in Chrome's threat model?
Chris Palmer554c66e2017-07-29 01:02:56406
407People sometimes report that they can compromise Chrome by installing a
408malicious DLL in a place where Chrome will load it, by hooking APIs (e.g. [Issue
409130284](https://crbug.com/130284)), or by otherwise altering the configuration
Tom Sepezf6b2e782020-04-06 23:08:55410of the device.
Chris Palmer554c66e2017-07-29 01:02:56411
412We consider these attacks outside Chrome's threat model, because there is no way
413for Chrome (or any application) to defend against a malicious user who has
Tom Sepezf6b2e782020-04-06 23:08:55414managed to log into your device as you, or who can run software with the
Chris Palmer554c66e2017-07-29 01:02:56415privileges of your operating system user account. Such an attacker can modify
416executables and DLLs, change environment variables like `PATH`, change
417configuration files, read any data your user account owns, email it to
Tom Sepezf6b2e782020-04-06 23:08:55418themselves, and so on. Such an attacker has total control over your device,
Chris Palmer554c66e2017-07-29 01:02:56419and nothing Chrome can do would provide a serious guarantee of defense. This
420problem is not special to Chrome ­— all applications must trust the
421physically-local user.
422
423There are a few things you can do to mitigate risks from people who have
424physical control over **your** computer, in certain circumstances.
425
426* To stop people from reading your data in cases of device theft or loss, use
427 full disk encryption (FDE). FDE is a standard feature of most operating
428 systems, including Windows Vista and later, Mac OS X Lion and later, and
429 some distributions of Linux. (Some older versions of Mac OS X had partial
430 disk encryption: they could encrypt the user’s home folder, which contains
431 the bulk of a user’s sensitive data.) Some FDE systems allow you to use
432 multiple sources of key material, such as the combination of both a
433 password and a key file on a USB token. When available, you should use
434 multiple sources of key material to achieve the strongest defense. Chrome
435 OS encrypts users’ home directories.
436* If you share your computer with other people, take advantage of your
437 operating system’s ability to manage multiple login accounts, and use a
438 distinct account for each person. For guests, Chrome OS has a built-in
439 Guest account for this purpose.
440* Take advantage of your operating system’s screen lock feature.
441* You can reduce the amount of information (including credentials like
442 cookies and passwords) that Chrome will store locally by using Chrome's
443 Content Settings (chrome://settings/content) and turning off the form
444 auto-fill and password storage features
445 ([chrome://settings/search#password](chrome://settings/search#password)).
446
447There is almost nothing you can do to mitigate risks when using a **public**
448computer.
449
450* Assume everything you do on a public computer will become, well, public.
451 You have no control over the operating system or other software on the
452 machine, and there is no reason to trust the integrity of it.
Eric Lawrence29ca2722018-02-22 19:04:05453* If you must use such a computer, use Incognito mode and close all Incognito
454 windows when you are done browsing to limit the amount of data you leave
455 behind. Note that Incognito mode **provides no protection** if the system has
456 already been compromised as described above.
Chris Palmer554c66e2017-07-29 01:02:56457
458<a name="TOC-Why-aren-t-compromised-infected-machines-in-Chrome-s-threat-model-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34459### Why aren't compromised/infected machines in Chrome's threat model?
Chris Palmer554c66e2017-07-29 01:02:56460
Tom Sepez279d9f42020-11-30 21:58:58461Although the attacker may now be remote, the consequences are essentially the
462same as with physically-local attacks. The attacker's code, when it runs as
463your user account on your machine, can do anything you can do. (See also
464[Microsoft's Ten Immutable Laws Of
Eric Lawrence5e1a9c712018-09-12 20:55:19465Security](https://web.archive.org/web/20160311224620/https://technet.microsoft.com/en-us/library/hh278941.aspx).)
Chris Palmer554c66e2017-07-29 01:02:56466
Tom Sepez279d9f42020-11-30 21:58:58467Other cases covered by this section include leaving a debugger port open to
468the world, remote shells, and so forth.
469
Alex Gough5d0d5562024-11-11 22:45:23470<a name="TOC-If-a-website-can-open-an-android-app-via-an-intent"></a>
471### If a website can open an Android app via an intent is this a security bug?
472
473No - websites can link to external handlers or applications - but there are
474restrictions around requiring a user gesture and the type of intent that can
475be launched. Full details are available in the
476[external_intents](../../components/external_intents/README.md) documentation.
477
Chris Palmer554c66e2017-07-29 01:02:56478<a name="TOC-Does-entering-JavaScript:-URLs-in-the-URL-bar-or-running-script-in-the-developer-tools-mean-there-s-an-XSS-vulnerability-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34479### Does entering JavaScript: URLs in the URL bar or running script in the developer tools mean there's an XSS vulnerability?
Chris Palmer554c66e2017-07-29 01:02:56480
Eric Lawrence29ca2722018-02-22 19:04:05481[No](https://crbug.com/81697). Chrome does not attempt to prevent the user from
482knowingly running script against loaded documents, either by entering script in
483the Developer Tools console or by typing a JavaScript: URI into the URL bar.
484Chrome and other browsers do undertake some efforts to prevent *paste* of script
485URLs in the URL bar (to limit
Chris Palmer554c66e2017-07-29 01:02:56486[social-engineering](https://blogs.msdn.microsoft.com/ieinternals/2011/05/19/socially-engineered-xss-attacks/))
487but users are otherwise free to invoke script against pages using either the URL
488bar or the DevTools console.
489
Tom Sepez5b700482020-04-06 20:07:21490<a name="TOC-Does-executing-JavaScript-from-a-bookmark-mean-there-s-an-XSS-vulnerability-"></a>
Eric Lawrence2de6aaa2023-04-13 17:06:55491### Does executing JavaScript from a bookmark or the Home button mean there's an XSS vulnerability?
Tom Sepez5b700482020-04-06 20:07:21492
493No. Chromium allows users to create bookmarks to JavaScript URLs that will run
Chris Palmer554c66e2017-07-29 01:02:56494on the currently-loaded page when the user clicks the bookmark; these are called
495[bookmarklets](https://en.wikipedia.org/wiki/Bookmarklet).
496
Eric Lawrence2de6aaa2023-04-13 17:06:55497Similarly, the Home button may be configured to invoke a JavaScript URL when clicked.
498
Tom Sepezfeca2de2020-04-01 22:58:29499<a name="TOC-Does-executing-JavaScript-in-a-PDF-file-mean-there-s-an-XSS-vulnerability-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34500### Does executing JavaScript in a PDF file mean there's an XSS vulnerability?
Tom Sepezfeca2de2020-04-01 22:58:29501
502No. PDF files have the ability to run JavaScript, usually to facilitate field
503validation during form fill-out. Note that the set of bindings provided to
Tom Sepez72119c3c2022-12-13 18:48:56504the PDF are more limited than those provided by the DOM to HTML documents, nor
505do PDFs get any ambient authority based upon the domain from which they are
506served (e.g. no document.cookie).
Tom Sepezfeca2de2020-04-01 22:58:29507
Alex Goughe7bcbea2022-05-03 21:45:34508<a name="TOC-Are-PDF-files-static-content-in-Chromium-"></a>
509### Are PDF files static content in Chromium?
Chris Palmer554c66e2017-07-29 01:02:56510
Alex Goughe7bcbea2022-05-03 21:45:34511No. PDF files have some powerful capabilities including invoking printing or
512posting form data. To mitigate abuse of these capabiliies, such as beaconing
513upon document open, we require interaction with the document (a "user gesture")
514before allowing their use.
Chris Palmer554c66e2017-07-29 01:02:56515
Charlie Reis65c9a4b2024-11-14 18:25:43516<a name="TOC-Are-non_committed-URLs-entered-by-the-user-considered-URL-spoofs-"></a>
517### Are non-committed URLs entered by the user considered URL spoofs?
518
519No. When a user enters a URL into the address bar (whether by typing,
520copy/pasting, drag and drop, or otherwise), Chrome intentionally displays
521it instead of the last committed URL of the currently active page, until
522both the navigation begins and the new page commits. During this time, the
523currently active page can change its appearance to mimic the new URL while
524its own URL is not shown. However, the active page does not have control
525over which URL the user entered into the address bar, limiting the
526effectiveness of a spoof attempt. The new
527[lock-replacement icon](https://blog.chromium.org/2023/05/an-update-on-lock-icon.html)
528is also not present in this state, and in many cases (i.e., once the new
529navigation has started), the loading indicators are present.
530
531The confusion between the non-committed URL and the active page's
532appearance is a consequence of the address bar needing to serve two roles:
533showing both where you are and where you are going.
534
535See also https://crbug.com/378932942 for context.
536
Alex Goughe7bcbea2022-05-03 21:45:34537<a name="TOC-What-about-URL-spoofs-using-Internationalized-Domain-Names-IDN-"></a>
538### What about URL spoofs using Internationalized Domain Names (IDN)?
Chris Palmer554c66e2017-07-29 01:02:56539
Alex Goughe7bcbea2022-05-03 21:45:34540We try to balance the needs of our international userbase while protecting users
541against confusable homograph attacks. Despite this, there are a list of known
542IDN display issues we are still working on.
Chris Palmer554c66e2017-07-29 01:02:56543
Alex Goughe7bcbea2022-05-03 21:45:34544* Please see [this document](https://docs.google.com/document/d/1_xJz3J9kkAPwk3pma6K3X12SyPTyyaJDSCxTfF8Y5sU)
545for a list of known issues and how we handle them.
546* [This document](https://chromium.googlesource.com/chromium/src/+/main/docs/idn.md)
547describes Chrome's IDN policy in detail.
Chris Palmer554c66e2017-07-29 01:02:56548
Alex Goughe7bcbea2022-05-03 21:45:34549<a name="TOC-Chrome-silently-syncs-extensions-across-devices.-Is-this-a-security-vulnerability-"></a>
550### Chrome silently syncs extensions across devices. Is this a security vulnerability?
Chris Palmer554c66e2017-07-29 01:02:56551
Alex Goughe7bcbea2022-05-03 21:45:34552This topic has been moved to the [Extensions Security FAQ](https://chromium.googlesource.com/chromium/src/+/main/extensions/docs/security_faq.md).
Chris Palmer8d95482a2019-08-28 22:48:45553
Alex Goughe7bcbea2022-05-03 21:45:34554<a name="TOC-Why-arent-null-pointer-dereferences-considered-security-bugs-"></a>
555### Why aren't null pointer dereferences considered security bugs?
Chris Palmer8d95482a2019-08-28 22:48:45556
Alex Goughe7bcbea2022-05-03 21:45:34557Null pointer dereferences with consistent, small, fixed offsets are not considered
558security bugs. A read or write to the NULL page results in a non-exploitable crash.
Daniel Cheng78780d22024-01-06 06:47:43559If the offset is larger than 32KB, or if there's uncertainty about whether the
Alex Goughe7bcbea2022-05-03 21:45:34560offset is controllable, it is considered a security bug.
Chris Palmer8d95482a2019-08-28 22:48:45561
Daniel Cheng78780d22024-01-06 06:47:43562All supported Chrome platforms do not allow mapping memory in at least the first
56332KB of address space:
564
565- Windows: Windows 8 and later disable mapping the first 64k of address space;
566 see page 33 of [Exploit Mitigation Improvements in Windows
567 8][windows-null-page-mapping] [[archived]][windows-null-page-mapping-archived].
568- Mac and iOS: by default, the linker reserves the first 4GB of address space
569 with the `__PAGEZERO` segment for 64-bit binaries.
570- Linux: the default `mmap_min_addr` value for supported distributions is at
571 least 64KB.
572- Android: [CTS][android-mmap_min_addr] enforces that `mmap_min_addr` is set to
573 exactly 32KB.
574- ChromeOS: the [ChromeOS kernels][chromeos-mmap_min_addr] set the default
575 `mmap_min_addr` value to at least 32KB.
576- Fuchsia: the [userspace base address][fuchsia-min-base-address] begins at 2MB;
577 this is configured per-platform but set to the same value on all platforms.
578
579[windows-null-page-mapping]: https://media.blackhat.com/bh-us-12/Briefings/M_Miller/BH_US_12_Miller_Exploit_Mitigation_Slides.pdf
580[windows-null-page-mapping-archived]: https://web.archive.org/web/20230608131033/https://media.blackhat.com/bh-us-12/Briefings/M_Miller/BH_US_12_Miller_Exploit_Mitigation_Slides.pdf
581[android-mmap_min_addr]: https://android.googlesource.com/platform/cts/+/496152a250d10e629d31ac90b2e828ad77b8d70a/tests/tests/security/src/android/security/cts/KernelSettingsTest.java#43
582[chromeos-mmap_min_addr]: https://source.chromium.org/search?q=%22CONFIG_DEFAULT_MMAP_MIN_ADDR%3D%22%20path:chromeos%2F&ss=chromiumos%2Fchromiumos%2Fcodesearch:src%2Fthird_party%2Fkernel%2F
583[fuchsia-min-base-address]: https://cs.opensource.google/fuchsia/fuchsia/+/main:zircon/kernel/arch/arm64/include/arch/kernel_aspace.h;l=20;drc=eeceea01eee2615de74b1339bcf6e6c2c6f72769
584
Alex Gough2d9974c2023-04-11 20:47:57585<a name="TOC-Indexing-a-container-out-of-bounds-hits-a-libcpp-verbose-abort--is-this-a-security-bug-"></a>
586### Indexing a container out of bounds hits a __libcpp_verbose_abort, is this a security bug?
587
588`std::vector` and other containers are now protected by libc++ hardening on all
589platforms [crbug.com/1335422](https://crbug.com/1335422). Indexing these
590containers out of bounds is now a safe crash - if a proof-of-concept reliably
591causes a crash in production builds we consider these to be functional rather than
592security issues.
593
Alex Goughe7bcbea2022-05-03 21:45:34594<a name="TOC-Are-stack-overflows-considered-security-bugs-"></a>
595### Are stack overflows considered security bugs?
596
597No. Guard pages mean that stack overflows are considered unexploitable, and
598are regarded as [denial of service bugs](#TOC-Are-denial-of-service-issues-considered-security-bugs-).
599The only exception is if an attacker can jump over the guard pages allocated by
600the operating system and avoid accessing them, e.g.:
601
602* A frame with a very large stack allocation.
603* C variable length array with an attacker-controlled size.
604* A call to `alloca()` with an attacker-controlled size.
605
danakjc8fb82602024-07-09 16:36:09606<a name="TOC-Are-tint-ICE-considered-security-bugs-"></a>
607### Are tint shader compiler Internal Compiler Errors considered security bugs?
608
609No. When tint fails and throws an ICE (Internal Compiler Error), it will
610terminate the process in an intentional manner and produce no shader output.
611Thus there is not security bug that follows from it.
612
Alex Goughe7bcbea2022-05-03 21:45:34613<a name="TOC-Are-enterprise-admins-considered-privileged-"></a>
614### Are enterprise admins considered privileged?
615
616Chrome [can't guard against local
617attacks](#TOC-Why-aren-t-physically-local-attacks-in-Chrome-s-threat-model-).
618Enterprise administrators often have full control over the device. Does Chrome
619assume that enterprise administrators are as privileged and powerful as other
620local users? It depends:
621
622* On a fully managed machine, for example a [domain-joined Windows
623 machine](https://docs.microsoft.com/en-us/windows-server/identity/ad-fs/deployment/join-a-computer-to-a-domain),
624 a device managed via a Mobile Device Management product, or a device with
625 Chrome managed via machine-level [Chrome Browser Cloud
626 Management](https://support.google.com/chrome/?p=cloud_management),
627 the administrator effectively has privileges to view and mutate any state on
628 the device. Chrome [policy implementations](../enterprise/add_new_policy.md)
629 should still guide enterprise admins to the most user-respectful defaults
630 and policy description text should clearly describe the nature of the
631 capabilities and the user impact of them being granted.
632* On an unmanaged machine, Chrome profiles [can be managed via cloud
633 policy](https://support.google.com/chrome/?p=manage_profiles)
634 if users sign into Chrome using a managed account. These policies are called
635 *user policies*. In this scenario, the Chrome enterprise administrator should
636 have privileges only to *view and mutate state within the profile that they
637 administer*. Any access outside that profile requires end-user consent.
638
639Chrome administrators can force-install Chrome extensions without permissions
640prompts, so the same restrictions must apply to the Chrome extension APIs.
641
642Chrome has a long history of policy support with many hundreds of policies. We
643recognize that there may exist policies or policy combinations that can provide
644capabilities outside of the guidance provided here. In cases of clear violation
645of user expectations, we will attempt to remedy these policies and we will apply
646the guidance laid out in this document to any newly added policies.
647
Camille0f2a39f2022-11-04 10:45:04648See the [Web Platform Security
Chris Thompson1f8b00062023-05-31 00:38:49649guidelines](https://chromium.googlesource.com/chromium/src/+/main/docs/security/web-platform-security-guidelines.md#enterprise-policies)
Camille0f2a39f2022-11-04 10:45:04650for more information on how enterprise policies should interact with Web
651Platform APIs.
652
Alex Goughe7bcbea2022-05-03 21:45:34653<a name="TOC-Can-I-use-EMET-to-help-protect-Chrome-against-attack-on-Microsoft-Windows-"></a>
654### Can I use EMET to help protect Chrome against attack on Microsoft Windows?
655
656There are [known compatibility
657problems](https://sites.google.com/a/chromium.org/dev/Home/chromium-security/chromium-and-emet)
658between Microsoft's EMET anti-exploit toolkit and some versions of Chrome. These
659can prevent Chrome from running in some configurations. Moreover, the Chrome
660security team does not recommend the use of EMET with Chrome because its most
661important security benefits are redundant with or superseded by built-in attack
662mitigations within the browser. For users, the very marginal security benefit is
663not usually a good trade-off for the compatibility issues and performance
664degradation the toolkit can cause.
665
Arthur Sonzognicbc5d692024-05-08 10:37:20666<a name="TOC-dangling-pointers"></a>
667### Dangling pointers
668
669Chromium can be instrumented to detect [dangling
670pointers](https://chromium.googlesource.com/chromium/src/+/main/docs/dangling_ptr.md):
671
672Notable build flags are:
673- `enable_dangling_raw_ptr_checks=true`
Kalvin Lee3f1e9eda2024-07-18 21:53:23674- `use_raw_ptr_asan_unowned_impl=true`
Arthur Sonzognicbc5d692024-05-08 10:37:20675
676Notable runtime flags are:
677- `--enable-features=PartitionAllocDanglingPtr`
678
679It is important to note that detecting a dangling pointer alone does not
680necessarily indicate a security vulnerability. A dangling pointer becomes a
681security vulnerability only when it is dereferenced and used after it becomes
682dangling.
683
684In general, dangling pointer issues should be assigned to feature teams as
685ordinary bugs and be fixed by them. However, they can be considered only if
686there is a demonstrable way to show a memory corruption. e.g. with a POC causing
687crash with ASAN **without the flags above**.
688
Alex Goughe7bcbea2022-05-03 21:45:34689## Certificates & Connection Indicators
Chris Palmer554c66e2017-07-29 01:02:56690
691<a name="TOC-Where-are-the-security-indicators-located-in-the-browser-window-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34692### Where are the security indicators located in the browser window?
Chris Palmer554c66e2017-07-29 01:02:56693
694The topmost portion of the browser window, consisting of the **Omnibox** (or
695**Location Bar**), navigation icons, menu icon, and other indicator icons, is
696sometimes called the browser **chrome** (not to be confused with the Chrome
697Browser itself). Actual security indicators can only appear in this section of
698the window. There can be no trustworthy security indicators elsewhere.
699
700Furthermore, Chrome can only guarantee that it is correctly representing URLs
701and their origins at the end of all navigation. Quirks of URL parsing, HTTP
702redirection, and so on are not security concerns unless Chrome is
703misrepresenting a URL or origin after navigation has completed.
704
705Browsers present a dilemma to the user since the output is a combination of
706information coming from both trustworthy sources (the browser itself) and
707untrustworthy sources (the web page), and the untrustworthy sources are allowed
708virtually unlimited control over graphical presentation. The only restriction on
709the page's presentation is that it is confined to the large rectangular area
710directly underneath the chrome, called the **viewport**. Things like hover text
711and URL preview(s), shown in the viewport, are entirely under the control of the
712web page itself. They have no guaranteed meaning, and function only as the page
713desires. This can be even more confusing when pages load content that looks like
714chrome. For example, many pages load images of locks, which look similar to the
715meaningful HTTPS lock in the Omnibox, but in fact do not convey any meaningful
716information about the transport security of that page.
717
718When the browser needs to show trustworthy information, such as the bubble
719resulting from a click on the lock icon, it does so by making the bubble overlap
Ryan Dicksonbbcdf3d2022-11-16 19:43:51720chrome. This visual detail can't be imitated by the page itself since the page
721is confined to the viewport.
Chris Palmer554c66e2017-07-29 01:02:56722
Ryan Dicksonbbcdf3d2022-11-16 19:43:51723<a name="TOC-Why-does-Chrome-show-a-lock-even-if-my-HTTPS-connection-is-being-proxied-"></a>
724### Why does Chrome show a lock, even if my HTTPS connection is being proxied?
Chris Palmer554c66e2017-07-29 01:02:56725
726Some types of software intercept HTTPS connections. Examples include anti-virus
727software, corporate network monitoring tools, and school censorship software. In
728order for the interception to work, you need to install a private trust anchor
729(root certificate) onto your computer. This may have happened when you installed
730your anti-virus software, or when your company's network administrator set up
731your computer. If that has occurred, your HTTPS connections can be viewed or
732modified by the software.
733
734Since you have allowed the trust anchor to be installed onto your computer,
735Chrome assumes that you have consented to HTTPS interception. Anyone who can add
736a trust anchor to your computer can make other changes to your computer, too,
737including changing Chrome. (See also [Why aren't physically-local attacks in
Avi Drissman36d4e2e2017-07-31 20:54:39738Chrome's threat model?](#TOC-Why-aren-t-physically-local-attacks-in-Chrome-s-threat-model-).)
Chris Palmer554c66e2017-07-29 01:02:56739
740<a name="TOC-Why-can-t-I-select-Proceed-Anyway-on-some-HTTPS-error-screens-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34741### Why can’t I select Proceed Anyway on some HTTPS error screens?
Chris Palmer554c66e2017-07-29 01:02:56742
743A key guarantee of HTTPS is that Chrome can be relatively certain that it is
744connecting to the true web server and not an impostor. Some sites request an
745even higher degree of protection for their users (i.e. you): they assert to
746Chrome (via Strict Transport Security —
Xiaoyin Liub7985e52017-09-21 18:07:46747[HSTS](https://tools.ietf.org/html/rfc6797) — or by other means) that any
Chris Palmer554c66e2017-07-29 01:02:56748server authentication error should be fatal, and that Chrome must close the
749connection. If you encounter such a fatal error, it is likely that your network
750is under attack, or that there is a network misconfiguration that is
751indistinguishable from an attack.
752
753The best thing you can do in this situation is to raise the issue to your
754network provider (or corporate IT department).
755
756Chrome shows non-recoverable HTTPS errors only in cases where the true server
757has previously asked for this treatment, and when it can be relatively certain
758that the current server is not the true server.
759
760<a name="TOC-How-does-key-pinning-interact-with-local-proxies-and-filters-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34761### How does key pinning interact with local proxies and filters?
Chris Palmer554c66e2017-07-29 01:02:56762
763To enable certificate chain validation, Chrome has access to two stores of trust
Ryan Dicksonbbcdf3d2022-11-16 19:43:51764anchors (i.e., certificates that are empowered as issuers). One trust anchor
Alex Goughc9ab81fd2023-05-15 19:03:14765store is for authenticating public internet servers, and depending on the
Ryan Dicksonbbcdf3d2022-11-16 19:43:51766version of Chrome being used and the platform it is running on, the
767[Chrome Root Store](https://chromium.googlesource.com/chromium/src/+/main/net/data/ssl/chrome_root_store/faq.md#what-is-the-chrome-root-store)
768might be in use. The private store contains certificates installed by the user
769or the administrator of the client machine. Private intranet servers should
770authenticate themselves with certificates issued by a private trust anchor.
Chris Palmer554c66e2017-07-29 01:02:56771
772Chrome’s key pinning feature is a strong form of web site authentication that
773requires a web server’s certificate chain not only to be valid and to chain to a
774known-good trust anchor, but also that at least one of the public keys in the
775certificate chain is known to be valid for the particular site the user is
776visiting. This is a good defense against the risk that any trust anchor can
777authenticate any web site, even if not intended by the site owner: if an
778otherwise-valid chain does not include a known pinned key (“pin”), Chrome will
779reject it because it was not issued in accordance with the site operator’s
780expectations.
781
782Chrome does not perform pin validation when the certificate chain chains up to a
783private trust anchor. A key result of this policy is that private trust anchors
784can be used to proxy (or
Ryan Dicksonbbcdf3d2022-11-16 19:43:51785[MITM](https://en.wikipedia.org/wiki/Man-in-the-middle_attack)) connections,
786even to pinned sites. “Data loss prevention” appliances, firewalls, content
787filters, and malware can use this feature to defeat the protections of key
788pinning.
Chris Palmer554c66e2017-07-29 01:02:56789
790We deem this acceptable because the proxy or MITM can only be effective if the
791client machine has already been configured to trust the proxy’s issuing
792certificate — that is, the client is already under the control of the person who
793controls the proxy (e.g. the enterprise’s IT administrator). If the client does
794not trust the private trust anchor, the proxy’s attempt to mediate the
795connection will fail as it should.
796
Adam Langleyc078ba82018-12-17 17:25:46797<a name="TOC-When-is-key-pinning-enabled-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34798### When is key pinning enabled?
Adam Langleyc078ba82018-12-17 17:25:46799
Eric Lawrence542967372024-12-02 22:13:58800Key pinning is enabled for Chrome-branded non-iOS builds when the local
Adam Langleyc078ba82018-12-17 17:25:46801clock is within ten weeks of the embedded build timestamp. Key pinning is a
802useful security measure but it tightly couples client and server configurations
803and completely breaks when those configurations are out of sync. In order to
804manage that risk we need to ensure that we can promptly update pinning clients
Chris Palmer59877ec2019-11-22 01:28:09805in an emergency and ensure that non-emergency changes can be deployed in a
Adam Langleyc078ba82018-12-17 17:25:46806reasonable timeframe.
807
808Each of the conditions listed above helps ensure those properties:
809Chrome-branded builds are those that Google provides and they all have an
Eric Lawrence542967372024-12-02 22:13:58810auto-update mechanism that can be used in an emergency. Even in cases where
811auto-update is generally effective, there are still non-trivial populations
812of stragglers for various reasons. The ten-week timeout prevents those
813stragglers from causing problems for regular, non-emergency changes and
Adam Langleyc078ba82018-12-17 17:25:46814allows stuck users to still, for example, conduct searches and access Chrome's
815homepage to hopefully get unstuck.
816
817In order to determine whether key pinning is active, try loading
Francois Mariere1b8e702023-07-07 05:25:08818[https://pinning-test.badssl.com/](https://pinning-test.badssl.com/). If key
Adam Langleyc078ba82018-12-17 17:25:46819pinning is active the load will _fail_ with a pinning error.
820
Chris Palmer38d751d002017-08-23 17:37:35821<a name="TOC-How-does-certificate-transparency-interact-with-local-proxies-and-filters-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34822### How does Certificate Transparency interact with local proxies and filters?
Chris Palmer38d751d002017-08-23 17:37:35823
Chris Palmer413f3c02017-08-23 17:47:54824Just as [pinning only applies to publicly-trusted trust
825anchors](#TOC-How-does-key-pinning-interact-with-local-proxies-and-filters-),
826Chrome only evaluates Certificate Transparency (CT) for publicly-trusted trust
827anchors. Thus private trust anchors, such as for enterprise middle-boxes and AV
828proxies, do not need to be publicly logged in a CT log.
Chris Palmer38d751d002017-08-23 17:37:35829
Chris Palmer554c66e2017-07-29 01:02:56830<a name="TOC-Why-are-some-web-platform-features-only-available-in-HTTPS-page-loads-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34831### Why are some web platform features only available in HTTPS page-loads?
Chris Palmer554c66e2017-07-29 01:02:56832
833The full answer is here: we [Prefer Secure Origins For Powerful New
834Features](https://www.chromium.org/Home/chromium-security/prefer-secure-origins-for-powerful-new-features).
835In short, many web platform features give web origins access to sensitive new
836sources of information, or significant power over a user's experience with their
Eric Romaned127b672018-01-23 19:36:38837computer/phone/watch/etc., or over their experience with it. We would therefore
Chris Palmer554c66e2017-07-29 01:02:56838like to have some basis to believe the origin meets a minimum bar for security,
839that the sensitive information is transported over the Internet in an
Eric Romaned127b672018-01-23 19:36:38840authenticated and confidential way, and that users can make meaningful choices
Chris Palmer554c66e2017-07-29 01:02:56841to trust or not trust a web origin.
842
843Note that the reason we require secure origins for WebCrypto is slightly
844different: An application that uses WebCrypto is almost certainly using it to
845provide some kind of security guarantee (e.g. encrypted instant messages or
846email). However, unless the JavaScript was itself transported to the client
847securely, it cannot actually provide any guarantee. (After all, a MITM attacker
848could have modified the code, if it was not transported securely.)
849
Camille0f2a39f2022-11-04 10:45:04850See the [Web Platform Security
Chris Thompson1f8b00062023-05-31 00:38:49851guidelines](https://chromium.googlesource.com/chromium/src/+/main/docs/security/web-platform-security-guidelines.md#encryption)
Camille0f2a39f2022-11-04 10:45:04852for more information on security guidelines applicable to web platform APIs.
853
Chris Palmer554c66e2017-07-29 01:02:56854<a name="TOC-Which-origins-are-secure-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34855### Which origins are "secure"?
Chris Palmer554c66e2017-07-29 01:02:56856
857Secure origins are those that match at least one of the following (scheme, host,
858port) patterns:
859
860* (https, *, *)
861* (wss, *, *)
862* (*, localhost, *)
863* (*, 127/8, *)
864* (*, ::1/128, *)
865* (file, *, —)
866* (chrome-extension, *, —)
867
868That is, secure origins are those that load resources either from the local
869machine (necessarily trusted) or over the network from a
870cryptographically-authenticated server. See [Prefer Secure Origins For Powerful
871New
872Features](https://sites.google.com/a/chromium.org/dev/Home/chromium-security/prefer-secure-origins-for-powerful-new-features)
873for more details.
874
875<a name="TOC-What-s-the-story-with-certificate-revocation-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34876### What's the story with certificate revocation?
Chris Palmer554c66e2017-07-29 01:02:56877
Ryan Dicksonbbcdf3d2022-11-16 19:43:51878Chrome's primary mechanism for checking certificate revocation status is
Joe DeBlasio0c6480712024-07-04 00:11:51879[CRLSets](https://dev.chromium.org/Home/chromium-security/crlsets).
Ryan Dicksonbbcdf3d2022-11-16 19:43:51880Additionally, by default, [stapled Online Certificate Status Protocol (OCSP)
881responses](https://en.wikipedia.org/wiki/OCSP_stapling) are honored.
Chris Palmer554c66e2017-07-29 01:02:56882
Joe DeBlasio0c6480712024-07-04 00:11:51883As of 2024, Chrome enforces most security-relevant certificate revocations that
884are visible via Certificate Revocation Lists (CRLs) published to the
885[CCADB](https://www.ccadb.org/) via CRLSets. There is some inherent delay in
886getting revocation information to Chrome clients, but most revocations should
887reach most users within a few days of appearing on a CA's CRL.
888
889Chrome clients do not, by default, perform "online" certificate revocation
890status checks using CRLs directly or via OCSP URLs included in certificates.
891This is because online checks offer limited security value unless a client, like
danakjc8fb82602024-07-09 16:36:09892Chrome, refuses to connect to a website if it cannot get a valid response,
Chris Palmer554c66e2017-07-29 01:02:56893
Ryan Dicksonbbcdf3d2022-11-16 19:43:51894Unfortunately, there are many widely-prevalent causes for why a client
895might be unable to get a valid certificate revocation status response to
896include:
897* timeouts (e.g., an OCSP responder is online but does not respond within an
Alex Goughc9ab81fd2023-05-15 19:03:14898 acceptable time limit),
899* availability issues (e.g., the OCSP responder is offline),
900* invalid responses (e.g., a "stale" or malformed status response), and
901* local network attacks misrouting traffic or blocking responses.
Chris Palmer554c66e2017-07-29 01:02:56902
Alex Goughc9ab81fd2023-05-15 19:03:14903Additional concern with OCSP checks are related to privacy. OCSP
Ryan Dicksonbbcdf3d2022-11-16 19:43:51904requests reveal details of individuals' browsing history to the operator of the
905OCSP responder (i.e., a third party). These details can be exposed accidentally
906(e.g., via data breach of logs) or intentionally (e.g., via subpoena). Chrome
907used to perform revocation checks for Extended Validation certificates, but that
908behavior was disabled in 2022 for [privacy reasons](https://groups.google.com/a/mozilla.org/g/dev-security-policy/c/S6A14e_X-T0/m/T4WxWgajAAAJ).
Chris Palmer554c66e2017-07-29 01:02:56909
Ryan Dicksonbbcdf3d2022-11-16 19:43:51910The following enterprise policies can be used to change the default revocation
911checking behavior in Chrome, though these may be removed in the future:
912* [enable soft-fail OCSP](https://chromeenterprise.google/policies/#EnableOnlineRevocationChecks)
913* [hard-fail for local trust anchors](https://chromeenterprise.google/policies/#RequireOnlineRevocationChecksForLocalAnchors).
Chris Palmer554c66e2017-07-29 01:02:56914
Alex Goughe7bcbea2022-05-03 21:45:34915## Passwords & Local Data
916
917<a name="TOC-What-about-unmasking-of-passwords-with-the-developer-tools-"></a>
918### What about unmasking of passwords with the developer tools?
919
920One of the most frequent reports we receive is password disclosure using the
921Inspect Element feature (see [Issue 126398](https://crbug.com/126398) for an
922example). People reason that "If I can see the password, it must be a bug."
923However, this is just one of the [physically-local attacks described in the
924previous
925section](#TOC-Why-aren-t-physically-local-attacks-in-Chrome-s-threat-model-),
926and all of those points apply here as well.
927
928The reason the password is masked is only to prevent disclosure via
929"shoulder-surfing" (i.e. the passive viewing of your screen by nearby persons),
930not because it is a secret unknown to the browser. The browser knows the
931password at many layers, including JavaScript, developer tools, process memory,
932and so on. When you are physically local to the computer, and only when you are
933physically local to the computer, there are, and always will be, tools for
934extracting the password from any of these places.
935
936<a name="TOC-Is-Chrome-s-support-for-userinfo-in-HTTP-URLs-e.g.-http:-user:password-example.com-considered-a-vulnerability-"></a>
937### Is Chrome's support for userinfo in HTTP URLs (e.g. http://user:[email protected]) considered a vulnerability?
938
939[Not at this time](https://crbug.com/626951). Chrome supports HTTP and HTTPS
940URIs with username and password information embedded within them for
941compatibility with sites that require this feature. Notably, Chrome will
942suppress display of the username and password information after navigation in
943the URL box to limit the effectiveness of spoofing attacks that may try to
944mislead the user. For instance, navigating to
945`http://[email protected]` will show an address of
946`http://evil.example.com` after the page loads.
947
Tom Sepez83fd1f612022-07-18 21:21:27948Note: We often receive reports calling this an "open redirect". However, it has
949nothing to do with redirection; rather the format of URLs is complex and the
950userinfo may be misread as a host.
951
Chris Palmer554c66e2017-07-29 01:02:56952<a name="TOC-Why-does-the-Password-Manager-ignore-autocomplete-off-for-password-fields-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34953### Why does the Password Manager ignore `autocomplete='off'` for password fields?
Chris Palmer554c66e2017-07-29 01:02:56954
955Ignoring `autocomplete='off'` for password fields allows the password manager to
956give more power to users to manage their credentials on websites. It is the
957security team's view that this is very important for user security by allowing
958users to have unique and more complex passwords for websites. As it was
959originally implemented, autocomplete='off' for password fields took control away
960from the user and gave control to the web site developer, which was also a
961violation of the [priority of
Adam Barth3a3bfef2021-10-06 02:36:44962constituencies](https://www.schemehostport.com/2011/10/priority-of-constituencies.html).
Chris Palmer554c66e2017-07-29 01:02:56963For a longer discussion on this, see the [mailing list
964announcement](https://groups.google.com/a/chromium.org/forum/#!topic/chromium-dev/zhhj7hCip5c).
965
Eric Lawrence122e86882017-12-07 22:53:05966<a name="TOC-Signout-of-Chrome"></a>
Alex Goughe7bcbea2022-05-03 21:45:34967### Signing out of Chrome does not delete previously-synced data?
Eric Lawrence122e86882017-12-07 22:53:05968
969If you have signed into Chrome and subsequently sign out of Chrome, previously
970saved passwords and other data are not deleted from your device unless you
971select that option when signing out of Chrome.
972
973If you change your Google password, synced data will no longer be updated in
974Chrome instances until you provide the new password to Chrome on each device
975configured to sync. However, previously synced data [remains available](https://crbug.com/792967)
976on each previously-syncing device unless manually removed.
977
Chris Palmer554c66e2017-07-29 01:02:56978<a name="TOC-Why-doesn-t-the-Password-Manager-save-my-Google-password-if-I-am-using-Chrome-Sync-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34979### Why doesn't the Password Manager save my Google password if I am using Chrome Sync?
Chris Palmer554c66e2017-07-29 01:02:56980
981In its default mode, Chrome Sync uses your Google password to protect all the
982other passwords in the Chrome Password Manager.
983
984In general, it is a bad idea to store the credential that protects an asset in
985the same place as the asset itself. An attacker who could temporarily compromise
986the Chrome Password Manager could, by stealing your Google password, obtain
987continuing access to all your passwords. Imagine you store your valuables in a
988safe, and you accidentally forget to close the safe. If a thief comes along,
989they might steal all of your valuables. That’s bad, but imagine if you had also
990left the combination to the safe inside as well. Now the bad guy has access to
991all of your valuables and all of your future valuables, too. The password
992manager is similar, except you probably would not even know if a bad guy
993accessed it.
994
995To prevent this type of attack, Chrome Password Manager does not save the Google
996password for the account you sync with Chrome. If you have multiple Google
997accounts, the Chrome Password Manager will save the passwords for accounts other
998than the one you are syncing with.
999
1000<a name="TOC-Does-the-Password-Manager-store-my-passwords-encrypted-on-disk-"></a>
Alex Goughe7bcbea2022-05-03 21:45:341001### Does the Password Manager store my passwords encrypted on disk?
Chris Palmer554c66e2017-07-29 01:02:561002
1003Chrome generally tries to use the operating system's user storage mechanism
1004wherever possible and stores them encrypted on disk, but it is platform
1005specific:
1006
1007* On Windows, Chrome uses the [Data Protection API
1008 (DPAPI)](https://msdn.microsoft.com/en-us/library/ms995355.aspx) to bind
1009 your passwords to your user account and store them on disk encrypted with
1010 a key only accessible to processes running as the same logged on user.
Viktor Semeniuk3720fc42024-04-03 09:33:521011* On macOS and iOS, Chrome previously stored credentials directly in the user's
Chris Palmer554c66e2017-07-29 01:02:561012 Keychain, but for technical reasons, it has switched to storing the
1013 credentials in "Login Data" in the Chrome users profile directory, but
1014 encrypted on disk with a key that is then stored in the user's Keychain.
Viktor Semeniuk3720fc42024-04-03 09:33:521015 See [Issue 466638](https://crbug.com/466638) and [Issue 520437](https://crbug.com/520437) for further explanation.
Christos Froussios2a02cc52019-07-30 07:04:461016* On Linux, Chrome previously stored credentials directly in the user's
Tom Anderson761687a2023-06-14 17:27:391017 Gnome Secret Service or KWallet, but for technical reasons, it has switched to
Christos Froussios2a02cc52019-07-30 07:04:461018 storing the credentials in "Login Data" in the Chrome user's profile directory,
1019 but encrypted on disk with a key that is then stored in the user's Gnome
Tom Anderson761687a2023-06-14 17:27:391020 Secret Service or KWallet. If there is no available Secret Service or KWallet,
1021 the data is not encrypted when stored.
Viktor Semeniuk3720fc42024-04-03 09:33:521022* On Android, Chrome doesn't store in the profile anymore, instead it uses Google
1023 Play Services to access passwords stored on a device.
1024* On ChromeOS passwords are only obfuscated since all profile data is encrypted
1025 by the OS.
Chris Palmer554c66e2017-07-29 01:02:561026
Adrian Taylorae8545252021-05-27 17:16:511027<a name="TOC-If-theres-a-way-to-see-stored-passwords-without-entering-a-password--is-this-a-security-bug-"></a>
Alex Goughe7bcbea2022-05-03 21:45:341028### If there's a way to see stored passwords without entering a password, is this a security bug?
Adrian Taylorae8545252021-05-27 17:16:511029
1030No. If an attacker has control of your login on your device, they can get to
1031your passwords by inspecting Chrome disk files or memory. (See
1032[why aren't physically-local attacks in Chrome's threat
1033model](#TOC-Why-aren-t-physically-local-attacks-in-Chrome-s-threat-model-)).
1034
1035On some platforms we ask for a password before revealing stored passwords,
1036but this is not considered a robust defense. It’s historically to stop
1037users inadvertently revealing their passwords on screen, for example if
1038they’re screen sharing. We don’t do this on all platforms because we consider
1039such risks greater on some than on others.
1040
Martin Kreichgauer8788fc622024-09-11 21:06:191041
1042<a name="TOC-On-some-websites-I-can-use-a-passkey-without-passing-a-lock-screen-or-biometric-challenge-is-this-a-security-bug"></a>
1043### On some websites, I can use passkeys without passing a lock screen or biometric challenge. Is this a security bug?
1044
1045Probably not. When a website requests a passkeys signature, it can choose
1046whether the authenticator should perform user verification (e.g. with a local
1047user lock screen challenge). Unless the website sets user verification parameter
1048in the request to 'required', the passkey authenticator can choose to skip the
1049lock screen challenge. Authenticators commonly skip an optional challenge if
1050biometrics are unavailable (e.g. on a laptop with a closed lid).
1051
1052If you can demonstrate bypassing the user verification challenge where the
1053request user verification parameter is set to 'required', please
1054[report it](https://issues.chromium.org/issues/new?noWizard=true&component=1363614&template=1922342).
1055
Alex Goughe7bcbea2022-05-03 21:45:341056## Other
Alex Gough8dc4f562022-04-18 22:14:051057
Chris Palmer554c66e2017-07-29 01:02:561058<a name="TOC-What-is-the-security-story-for-Service-Workers-"></a>
Alex Goughe7bcbea2022-05-03 21:45:341059### What is the security story for Service Workers?
Chris Palmer554c66e2017-07-29 01:02:561060
1061See our dedicated [Service Worker Security
Eric Lawrence [MSFT]f80579552021-04-22 18:39:261062FAQ](https://chromium.googlesource.com/chromium/src/+/main/docs/security/service-worker-security-faq.md).
Chris Palmer554c66e2017-07-29 01:02:561063
Devlin Cronin7304fec2021-06-02 22:51:261064<a name="TOC-What-is-the-security-story-for-Extensions-"></a>
Alex Goughe7bcbea2022-05-03 21:45:341065### What is the security story for Extensions?
Devlin Cronin7304fec2021-06-02 22:51:261066
1067See our dedicated [Extensions Security FAQ](https://chromium.googlesource.com/chromium/src/+/main/extensions/docs/security_faq.md).
Adrian Taylord57a4c62022-11-10 10:27:501068
Adrian Taylor1bbbf142023-08-29 17:41:171069<a name="TOC-What-is-the-security-model-for-Chrome-Custom-Tabs-"></a>
1070### What's the security model for Chrome Custom Tabs?
1071
1072See our [Chrome Custom Tabs security FAQ](custom-tabs-faq.md).
1073
Adrian Taylor98e9c792024-04-29 18:59:231074<a name="TOC-How-is-security-different-in-Chrome-for-iOS--"></a>
1075### How is security different in Chrome for iOS?
1076
1077Chrome for iOS does not use Chrome's standard rendering engine. Due to Apple's
1078iOS platform restrictions, it instead uses Apple's WebKit engine and a more
1079restricted process isolation model. This means its security properties are
1080different from Chrome on all other platforms.
1081
1082The differences in security are far too extensive to list exhaustively, but some
1083notable points are:
1084
1085* Chromium's [site
1086 isolation](https://www.chromium.org/Home/chromium-security/site-isolation/)
1087 isn't used; WebKit has its own alternative implementation with different costs
1088 and benefits.
1089* WebKit has [historically been slower at shipping security
1090 fixes](https://googleprojectzero.blogspot.com/2022/02/a-walk-through-project-zero-metrics.html).
1091* Chrome's network stack, [root
1092 store](https://www.chromium.org/Home/chromium-security/root-ca-policy/) and
1093 associated technology are not used, so
1094 the platform will make different decisions about what web servers to trust.
1095* Sandboxing APIs are not available for native code.
1096
1097Given that the fundamentals of the browser are so different, and given these
1098limitations, Chrome for iOS has historically not consistently implemented some
1099of Chrome's [standard security guidelines](rules.md). This includes the
1100important [Rule of Two](rule-of-2.md). Future Chrome for iOS features should
1101meet all guidelines except in cases where the lack of platform APIs make it
1102unrealistic. (The use of WebAssembly-based sandboxing is currently considered
1103unrealistic though this could change in future.)
1104
1105If the Rule of Two cannot be followed, features for Chrome for iOS should
1106nevertheless follow it as closely as possible, and adopt additional mitigations
1107where they cannot:
1108
1109* First consider adding a validation layer between unsafe code and web contents,
1110 or adopting memory-safe parsers at the boundary between the renderer and the
1111 browser process. Consider changing the design of the feature so the riskiest
1112 parsing can happen in javascript injected in the renderer process.
1113* Any unsafe unsandboxed code that is exposed to web contents or other
1114 untrustworthy data sources must be extensively tested and fuzzed.
1115
1116The Chrome team is enthusiastic about the future possibility of making a version
1117of Chrome for iOS that meets our usual security standards if richer platform
1118facilities become widely available: this will require revisiting existing
1119features to see if adjustment is required.
1120
Adrian Taylor82a534b2023-05-09 19:21:201121<a name="TOC-Are-all-Chrome-updates-important--"></a>
1122### Are all Chrome updates important?
1123
1124Yes - see [our updates FAQ](updates.md).
1125
1126<a name="TOC-What-older-Chrome-versions-are-supported--"></a>
1127### What older Chrome versions are supported?
1128
1129We always recommend being on the most recent Chrome stable version - see
1130[our updates FAQ](updates.md).
1131
Adrian Taylord57a4c62022-11-10 10:27:501132<a name="TOC-Im-making-a-Chromium-based-browser-how-should-I-secure-it-"></a>
1133### I'm making a Chromium-based browser. How should I secure it?
1134
1135If you want to make a browser based on Chromium, you should stay up to date
1136with Chromium's security fixes. There are adversaries who weaponize fixed
1137Chromium bugs ("n-day vulnerabilities") to target browsers which haven’t yet
1138absorbed those fixes.
1139
1140Decide whether your approach is to stay constantly up to date with Chromium
1141releases, or to backport security fixes onto some older version, upgrading
1142Chromium versions less frequently.
1143
1144Backporting security fixes sounds easier than forward-porting features, but in
1145our experience, this is false. Chromium releases 400+ security bug fixes per
1146year ([example
1147query](https://bugs.chromium.org/p/chromium/issues/list?q=type%3DBug-Security%20has%3Arelease%20closed%3Etoday-730%20closed%3Ctoday-365%20allpublic&can=1)).
1148Some downstream browsers take risks by backporting only Medium+ severity fixes,
1149but that's still over 300 ([example
1150query](https://bugs.chromium.org/p/chromium/issues/list?q=type%3DBug-Security%20has%3Arelease%20closed%3Etoday-730%20closed%3Ctoday-365%20allpublic%20Security_Severity%3DMedium%2CHigh%2CCritical&can=1)).
1151Most are trivial cherry-picks; but others require rework and require versatile
1152engineers who can make good decisions about any part of a large codebase.
1153
1154Our recommendation is to stay up-to-date with Chrome's released versions. You
1155should aim to release a version of your browser within just a few days of each
1156Chrome [stable
1157release](https://chromereleases.googleblog.com/search/label/Stable%20updates).
1158If your browser is sufficiently widely-used, you can [apply for advance notice
1159of fixed vulnerabilities](https://www.chromium.org/Home/chromium-security/) to
1160make this a little easier.
1161
1162Finally, if you choose the backporting approach, please explain the security
1163properties to your users. Some fraction of security improvements cannot be
1164backported. This can happen for several reasons, for example: because they
1165depend upon architectural changes (e.g. breaking API changes); because the
1166security improvement is a significant new feature; or because the security
1167improvement is the removal of a broken feature.