blob: c90cd04b7db35e08859ea925c9fee61c21af33c9 [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
Chris Palmer554c66e2017-07-29 01:02:56470<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:34471### 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:56472
Eric Lawrence29ca2722018-02-22 19:04:05473[No](https://crbug.com/81697). Chrome does not attempt to prevent the user from
474knowingly running script against loaded documents, either by entering script in
475the Developer Tools console or by typing a JavaScript: URI into the URL bar.
476Chrome and other browsers do undertake some efforts to prevent *paste* of script
477URLs in the URL bar (to limit
Chris Palmer554c66e2017-07-29 01:02:56478[social-engineering](https://blogs.msdn.microsoft.com/ieinternals/2011/05/19/socially-engineered-xss-attacks/))
479but users are otherwise free to invoke script against pages using either the URL
480bar or the DevTools console.
481
Tom Sepez5b700482020-04-06 20:07:21482<a name="TOC-Does-executing-JavaScript-from-a-bookmark-mean-there-s-an-XSS-vulnerability-"></a>
Eric Lawrence2de6aaa2023-04-13 17:06:55483### Does executing JavaScript from a bookmark or the Home button mean there's an XSS vulnerability?
Tom Sepez5b700482020-04-06 20:07:21484
485No. Chromium allows users to create bookmarks to JavaScript URLs that will run
Chris Palmer554c66e2017-07-29 01:02:56486on the currently-loaded page when the user clicks the bookmark; these are called
487[bookmarklets](https://en.wikipedia.org/wiki/Bookmarklet).
488
Eric Lawrence2de6aaa2023-04-13 17:06:55489Similarly, the Home button may be configured to invoke a JavaScript URL when clicked.
490
Tom Sepezfeca2de2020-04-01 22:58:29491<a name="TOC-Does-executing-JavaScript-in-a-PDF-file-mean-there-s-an-XSS-vulnerability-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34492### Does executing JavaScript in a PDF file mean there's an XSS vulnerability?
Tom Sepezfeca2de2020-04-01 22:58:29493
494No. PDF files have the ability to run JavaScript, usually to facilitate field
495validation during form fill-out. Note that the set of bindings provided to
Tom Sepez72119c3c2022-12-13 18:48:56496the PDF are more limited than those provided by the DOM to HTML documents, nor
497do PDFs get any ambient authority based upon the domain from which they are
498served (e.g. no document.cookie).
Tom Sepezfeca2de2020-04-01 22:58:29499
Alex Goughe7bcbea2022-05-03 21:45:34500<a name="TOC-Are-PDF-files-static-content-in-Chromium-"></a>
501### Are PDF files static content in Chromium?
Chris Palmer554c66e2017-07-29 01:02:56502
Alex Goughe7bcbea2022-05-03 21:45:34503No. PDF files have some powerful capabilities including invoking printing or
504posting form data. To mitigate abuse of these capabiliies, such as beaconing
505upon document open, we require interaction with the document (a "user gesture")
506before allowing their use.
Chris Palmer554c66e2017-07-29 01:02:56507
Alex Goughe7bcbea2022-05-03 21:45:34508<a name="TOC-What-about-URL-spoofs-using-Internationalized-Domain-Names-IDN-"></a>
509### What about URL spoofs using Internationalized Domain Names (IDN)?
Chris Palmer554c66e2017-07-29 01:02:56510
Alex Goughe7bcbea2022-05-03 21:45:34511We try to balance the needs of our international userbase while protecting users
512against confusable homograph attacks. Despite this, there are a list of known
513IDN display issues we are still working on.
Chris Palmer554c66e2017-07-29 01:02:56514
Alex Goughe7bcbea2022-05-03 21:45:34515* Please see [this document](https://docs.google.com/document/d/1_xJz3J9kkAPwk3pma6K3X12SyPTyyaJDSCxTfF8Y5sU)
516for a list of known issues and how we handle them.
517* [This document](https://chromium.googlesource.com/chromium/src/+/main/docs/idn.md)
518describes Chrome's IDN policy in detail.
Chris Palmer554c66e2017-07-29 01:02:56519
Alex Goughe7bcbea2022-05-03 21:45:34520<a name="TOC-Chrome-silently-syncs-extensions-across-devices.-Is-this-a-security-vulnerability-"></a>
521### Chrome silently syncs extensions across devices. Is this a security vulnerability?
Chris Palmer554c66e2017-07-29 01:02:56522
Alex Goughe7bcbea2022-05-03 21:45:34523This 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:45524
Alex Goughe7bcbea2022-05-03 21:45:34525<a name="TOC-Why-arent-null-pointer-dereferences-considered-security-bugs-"></a>
526### Why aren't null pointer dereferences considered security bugs?
Chris Palmer8d95482a2019-08-28 22:48:45527
Alex Goughe7bcbea2022-05-03 21:45:34528Null pointer dereferences with consistent, small, fixed offsets are not considered
529security bugs. A read or write to the NULL page results in a non-exploitable crash.
Daniel Cheng78780d22024-01-06 06:47:43530If the offset is larger than 32KB, or if there's uncertainty about whether the
Alex Goughe7bcbea2022-05-03 21:45:34531offset is controllable, it is considered a security bug.
Chris Palmer8d95482a2019-08-28 22:48:45532
Daniel Cheng78780d22024-01-06 06:47:43533All supported Chrome platforms do not allow mapping memory in at least the first
53432KB of address space:
535
536- Windows: Windows 8 and later disable mapping the first 64k of address space;
537 see page 33 of [Exploit Mitigation Improvements in Windows
538 8][windows-null-page-mapping] [[archived]][windows-null-page-mapping-archived].
539- Mac and iOS: by default, the linker reserves the first 4GB of address space
540 with the `__PAGEZERO` segment for 64-bit binaries.
541- Linux: the default `mmap_min_addr` value for supported distributions is at
542 least 64KB.
543- Android: [CTS][android-mmap_min_addr] enforces that `mmap_min_addr` is set to
544 exactly 32KB.
545- ChromeOS: the [ChromeOS kernels][chromeos-mmap_min_addr] set the default
546 `mmap_min_addr` value to at least 32KB.
547- Fuchsia: the [userspace base address][fuchsia-min-base-address] begins at 2MB;
548 this is configured per-platform but set to the same value on all platforms.
549
550[windows-null-page-mapping]: https://media.blackhat.com/bh-us-12/Briefings/M_Miller/BH_US_12_Miller_Exploit_Mitigation_Slides.pdf
551[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
552[android-mmap_min_addr]: https://android.googlesource.com/platform/cts/+/496152a250d10e629d31ac90b2e828ad77b8d70a/tests/tests/security/src/android/security/cts/KernelSettingsTest.java#43
553[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
554[fuchsia-min-base-address]: https://cs.opensource.google/fuchsia/fuchsia/+/main:zircon/kernel/arch/arm64/include/arch/kernel_aspace.h;l=20;drc=eeceea01eee2615de74b1339bcf6e6c2c6f72769
555
Alex Gough2d9974c2023-04-11 20:47:57556<a name="TOC-Indexing-a-container-out-of-bounds-hits-a-libcpp-verbose-abort--is-this-a-security-bug-"></a>
557### Indexing a container out of bounds hits a __libcpp_verbose_abort, is this a security bug?
558
559`std::vector` and other containers are now protected by libc++ hardening on all
560platforms [crbug.com/1335422](https://crbug.com/1335422). Indexing these
561containers out of bounds is now a safe crash - if a proof-of-concept reliably
562causes a crash in production builds we consider these to be functional rather than
563security issues.
564
Alex Goughe7bcbea2022-05-03 21:45:34565<a name="TOC-Are-stack-overflows-considered-security-bugs-"></a>
566### Are stack overflows considered security bugs?
567
568No. Guard pages mean that stack overflows are considered unexploitable, and
569are regarded as [denial of service bugs](#TOC-Are-denial-of-service-issues-considered-security-bugs-).
570The only exception is if an attacker can jump over the guard pages allocated by
571the operating system and avoid accessing them, e.g.:
572
573* A frame with a very large stack allocation.
574* C variable length array with an attacker-controlled size.
575* A call to `alloca()` with an attacker-controlled size.
576
danakjc8fb82602024-07-09 16:36:09577<a name="TOC-Are-tint-ICE-considered-security-bugs-"></a>
578### Are tint shader compiler Internal Compiler Errors considered security bugs?
579
580No. When tint fails and throws an ICE (Internal Compiler Error), it will
581terminate the process in an intentional manner and produce no shader output.
582Thus there is not security bug that follows from it.
583
Alex Goughe7bcbea2022-05-03 21:45:34584<a name="TOC-Are-enterprise-admins-considered-privileged-"></a>
585### Are enterprise admins considered privileged?
586
587Chrome [can't guard against local
588attacks](#TOC-Why-aren-t-physically-local-attacks-in-Chrome-s-threat-model-).
589Enterprise administrators often have full control over the device. Does Chrome
590assume that enterprise administrators are as privileged and powerful as other
591local users? It depends:
592
593* On a fully managed machine, for example a [domain-joined Windows
594 machine](https://docs.microsoft.com/en-us/windows-server/identity/ad-fs/deployment/join-a-computer-to-a-domain),
595 a device managed via a Mobile Device Management product, or a device with
596 Chrome managed via machine-level [Chrome Browser Cloud
597 Management](https://support.google.com/chrome/?p=cloud_management),
598 the administrator effectively has privileges to view and mutate any state on
599 the device. Chrome [policy implementations](../enterprise/add_new_policy.md)
600 should still guide enterprise admins to the most user-respectful defaults
601 and policy description text should clearly describe the nature of the
602 capabilities and the user impact of them being granted.
603* On an unmanaged machine, Chrome profiles [can be managed via cloud
604 policy](https://support.google.com/chrome/?p=manage_profiles)
605 if users sign into Chrome using a managed account. These policies are called
606 *user policies*. In this scenario, the Chrome enterprise administrator should
607 have privileges only to *view and mutate state within the profile that they
608 administer*. Any access outside that profile requires end-user consent.
609
610Chrome administrators can force-install Chrome extensions without permissions
611prompts, so the same restrictions must apply to the Chrome extension APIs.
612
613Chrome has a long history of policy support with many hundreds of policies. We
614recognize that there may exist policies or policy combinations that can provide
615capabilities outside of the guidance provided here. In cases of clear violation
616of user expectations, we will attempt to remedy these policies and we will apply
617the guidance laid out in this document to any newly added policies.
618
Camille0f2a39f2022-11-04 10:45:04619See the [Web Platform Security
Chris Thompson1f8b00062023-05-31 00:38:49620guidelines](https://chromium.googlesource.com/chromium/src/+/main/docs/security/web-platform-security-guidelines.md#enterprise-policies)
Camille0f2a39f2022-11-04 10:45:04621for more information on how enterprise policies should interact with Web
622Platform APIs.
623
Alex Goughe7bcbea2022-05-03 21:45:34624<a name="TOC-Can-I-use-EMET-to-help-protect-Chrome-against-attack-on-Microsoft-Windows-"></a>
625### Can I use EMET to help protect Chrome against attack on Microsoft Windows?
626
627There are [known compatibility
628problems](https://sites.google.com/a/chromium.org/dev/Home/chromium-security/chromium-and-emet)
629between Microsoft's EMET anti-exploit toolkit and some versions of Chrome. These
630can prevent Chrome from running in some configurations. Moreover, the Chrome
631security team does not recommend the use of EMET with Chrome because its most
632important security benefits are redundant with or superseded by built-in attack
633mitigations within the browser. For users, the very marginal security benefit is
634not usually a good trade-off for the compatibility issues and performance
635degradation the toolkit can cause.
636
Arthur Sonzognicbc5d692024-05-08 10:37:20637<a name="TOC-dangling-pointers"></a>
638### Dangling pointers
639
640Chromium can be instrumented to detect [dangling
641pointers](https://chromium.googlesource.com/chromium/src/+/main/docs/dangling_ptr.md):
642
643Notable build flags are:
644- `enable_dangling_raw_ptr_checks=true`
Kalvin Lee3f1e9eda2024-07-18 21:53:23645- `use_raw_ptr_asan_unowned_impl=true`
Arthur Sonzognicbc5d692024-05-08 10:37:20646
647Notable runtime flags are:
648- `--enable-features=PartitionAllocDanglingPtr`
649
650It is important to note that detecting a dangling pointer alone does not
651necessarily indicate a security vulnerability. A dangling pointer becomes a
652security vulnerability only when it is dereferenced and used after it becomes
653dangling.
654
655In general, dangling pointer issues should be assigned to feature teams as
656ordinary bugs and be fixed by them. However, they can be considered only if
657there is a demonstrable way to show a memory corruption. e.g. with a POC causing
658crash with ASAN **without the flags above**.
659
Alex Goughe7bcbea2022-05-03 21:45:34660## Certificates & Connection Indicators
Chris Palmer554c66e2017-07-29 01:02:56661
662<a name="TOC-Where-are-the-security-indicators-located-in-the-browser-window-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34663### Where are the security indicators located in the browser window?
Chris Palmer554c66e2017-07-29 01:02:56664
665The topmost portion of the browser window, consisting of the **Omnibox** (or
666**Location Bar**), navigation icons, menu icon, and other indicator icons, is
667sometimes called the browser **chrome** (not to be confused with the Chrome
668Browser itself). Actual security indicators can only appear in this section of
669the window. There can be no trustworthy security indicators elsewhere.
670
671Furthermore, Chrome can only guarantee that it is correctly representing URLs
672and their origins at the end of all navigation. Quirks of URL parsing, HTTP
673redirection, and so on are not security concerns unless Chrome is
674misrepresenting a URL or origin after navigation has completed.
675
676Browsers present a dilemma to the user since the output is a combination of
677information coming from both trustworthy sources (the browser itself) and
678untrustworthy sources (the web page), and the untrustworthy sources are allowed
679virtually unlimited control over graphical presentation. The only restriction on
680the page's presentation is that it is confined to the large rectangular area
681directly underneath the chrome, called the **viewport**. Things like hover text
682and URL preview(s), shown in the viewport, are entirely under the control of the
683web page itself. They have no guaranteed meaning, and function only as the page
684desires. This can be even more confusing when pages load content that looks like
685chrome. For example, many pages load images of locks, which look similar to the
686meaningful HTTPS lock in the Omnibox, but in fact do not convey any meaningful
687information about the transport security of that page.
688
689When the browser needs to show trustworthy information, such as the bubble
690resulting from a click on the lock icon, it does so by making the bubble overlap
Ryan Dicksonbbcdf3d2022-11-16 19:43:51691chrome. This visual detail can't be imitated by the page itself since the page
692is confined to the viewport.
Chris Palmer554c66e2017-07-29 01:02:56693
Ryan Dicksonbbcdf3d2022-11-16 19:43:51694<a name="TOC-Why-does-Chrome-show-a-lock-even-if-my-HTTPS-connection-is-being-proxied-"></a>
695### Why does Chrome show a lock, even if my HTTPS connection is being proxied?
Chris Palmer554c66e2017-07-29 01:02:56696
697Some types of software intercept HTTPS connections. Examples include anti-virus
698software, corporate network monitoring tools, and school censorship software. In
699order for the interception to work, you need to install a private trust anchor
700(root certificate) onto your computer. This may have happened when you installed
701your anti-virus software, or when your company's network administrator set up
702your computer. If that has occurred, your HTTPS connections can be viewed or
703modified by the software.
704
705Since you have allowed the trust anchor to be installed onto your computer,
706Chrome assumes that you have consented to HTTPS interception. Anyone who can add
707a trust anchor to your computer can make other changes to your computer, too,
708including changing Chrome. (See also [Why aren't physically-local attacks in
Avi Drissman36d4e2e2017-07-31 20:54:39709Chrome's threat model?](#TOC-Why-aren-t-physically-local-attacks-in-Chrome-s-threat-model-).)
Chris Palmer554c66e2017-07-29 01:02:56710
711<a name="TOC-Why-can-t-I-select-Proceed-Anyway-on-some-HTTPS-error-screens-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34712### Why can’t I select Proceed Anyway on some HTTPS error screens?
Chris Palmer554c66e2017-07-29 01:02:56713
714A key guarantee of HTTPS is that Chrome can be relatively certain that it is
715connecting to the true web server and not an impostor. Some sites request an
716even higher degree of protection for their users (i.e. you): they assert to
717Chrome (via Strict Transport Security —
Xiaoyin Liub7985e52017-09-21 18:07:46718[HSTS](https://tools.ietf.org/html/rfc6797) — or by other means) that any
Chris Palmer554c66e2017-07-29 01:02:56719server authentication error should be fatal, and that Chrome must close the
720connection. If you encounter such a fatal error, it is likely that your network
721is under attack, or that there is a network misconfiguration that is
722indistinguishable from an attack.
723
724The best thing you can do in this situation is to raise the issue to your
725network provider (or corporate IT department).
726
727Chrome shows non-recoverable HTTPS errors only in cases where the true server
728has previously asked for this treatment, and when it can be relatively certain
729that the current server is not the true server.
730
731<a name="TOC-How-does-key-pinning-interact-with-local-proxies-and-filters-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34732### How does key pinning interact with local proxies and filters?
Chris Palmer554c66e2017-07-29 01:02:56733
734To enable certificate chain validation, Chrome has access to two stores of trust
Ryan Dicksonbbcdf3d2022-11-16 19:43:51735anchors (i.e., certificates that are empowered as issuers). One trust anchor
Alex Goughc9ab81fd2023-05-15 19:03:14736store is for authenticating public internet servers, and depending on the
Ryan Dicksonbbcdf3d2022-11-16 19:43:51737version of Chrome being used and the platform it is running on, the
738[Chrome Root Store](https://chromium.googlesource.com/chromium/src/+/main/net/data/ssl/chrome_root_store/faq.md#what-is-the-chrome-root-store)
739might be in use. The private store contains certificates installed by the user
740or the administrator of the client machine. Private intranet servers should
741authenticate themselves with certificates issued by a private trust anchor.
Chris Palmer554c66e2017-07-29 01:02:56742
743Chrome’s key pinning feature is a strong form of web site authentication that
744requires a web server’s certificate chain not only to be valid and to chain to a
745known-good trust anchor, but also that at least one of the public keys in the
746certificate chain is known to be valid for the particular site the user is
747visiting. This is a good defense against the risk that any trust anchor can
748authenticate any web site, even if not intended by the site owner: if an
749otherwise-valid chain does not include a known pinned key (“pin”), Chrome will
750reject it because it was not issued in accordance with the site operator’s
751expectations.
752
753Chrome does not perform pin validation when the certificate chain chains up to a
754private trust anchor. A key result of this policy is that private trust anchors
755can be used to proxy (or
Ryan Dicksonbbcdf3d2022-11-16 19:43:51756[MITM](https://en.wikipedia.org/wiki/Man-in-the-middle_attack)) connections,
757even to pinned sites. “Data loss prevention” appliances, firewalls, content
758filters, and malware can use this feature to defeat the protections of key
759pinning.
Chris Palmer554c66e2017-07-29 01:02:56760
761We deem this acceptable because the proxy or MITM can only be effective if the
762client machine has already been configured to trust the proxy’s issuing
763certificate — that is, the client is already under the control of the person who
764controls the proxy (e.g. the enterprise’s IT administrator). If the client does
765not trust the private trust anchor, the proxy’s attempt to mediate the
766connection will fail as it should.
767
Adam Langleyc078ba82018-12-17 17:25:46768<a name="TOC-When-is-key-pinning-enabled-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34769### When is key pinning enabled?
Adam Langleyc078ba82018-12-17 17:25:46770
771Key pinning is enabled for Chrome-branded, non-mobile builds when the local
772clock is within ten weeks of the embedded build timestamp. Key pinning is a
773useful security measure but it tightly couples client and server configurations
774and completely breaks when those configurations are out of sync. In order to
775manage that risk we need to ensure that we can promptly update pinning clients
Chris Palmer59877ec2019-11-22 01:28:09776in an emergency and ensure that non-emergency changes can be deployed in a
Adam Langleyc078ba82018-12-17 17:25:46777reasonable timeframe.
778
779Each of the conditions listed above helps ensure those properties:
780Chrome-branded builds are those that Google provides and they all have an
781auto-update mechanism that can be used in an emergency. However, auto-update on
782mobile devices is significantly less effective thus they are excluded. Even in
783cases where auto-update is generally effective, there are still non-trivial
784populations of stragglers for various reasons. The ten-week timeout prevents
785those stragglers from causing problems for regular, non-emergency changes and
786allows stuck users to still, for example, conduct searches and access Chrome's
787homepage to hopefully get unstuck.
788
789In order to determine whether key pinning is active, try loading
Francois Mariere1b8e702023-07-07 05:25:08790[https://pinning-test.badssl.com/](https://pinning-test.badssl.com/). If key
Adam Langleyc078ba82018-12-17 17:25:46791pinning is active the load will _fail_ with a pinning error.
792
Chris Palmer38d751d002017-08-23 17:37:35793<a name="TOC-How-does-certificate-transparency-interact-with-local-proxies-and-filters-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34794### How does Certificate Transparency interact with local proxies and filters?
Chris Palmer38d751d002017-08-23 17:37:35795
Chris Palmer413f3c02017-08-23 17:47:54796Just as [pinning only applies to publicly-trusted trust
797anchors](#TOC-How-does-key-pinning-interact-with-local-proxies-and-filters-),
798Chrome only evaluates Certificate Transparency (CT) for publicly-trusted trust
799anchors. Thus private trust anchors, such as for enterprise middle-boxes and AV
800proxies, do not need to be publicly logged in a CT log.
Chris Palmer38d751d002017-08-23 17:37:35801
Chris Palmer554c66e2017-07-29 01:02:56802<a name="TOC-Why-are-some-web-platform-features-only-available-in-HTTPS-page-loads-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34803### Why are some web platform features only available in HTTPS page-loads?
Chris Palmer554c66e2017-07-29 01:02:56804
805The full answer is here: we [Prefer Secure Origins For Powerful New
806Features](https://www.chromium.org/Home/chromium-security/prefer-secure-origins-for-powerful-new-features).
807In short, many web platform features give web origins access to sensitive new
808sources of information, or significant power over a user's experience with their
Eric Romaned127b672018-01-23 19:36:38809computer/phone/watch/etc., or over their experience with it. We would therefore
Chris Palmer554c66e2017-07-29 01:02:56810like to have some basis to believe the origin meets a minimum bar for security,
811that the sensitive information is transported over the Internet in an
Eric Romaned127b672018-01-23 19:36:38812authenticated and confidential way, and that users can make meaningful choices
Chris Palmer554c66e2017-07-29 01:02:56813to trust or not trust a web origin.
814
815Note that the reason we require secure origins for WebCrypto is slightly
816different: An application that uses WebCrypto is almost certainly using it to
817provide some kind of security guarantee (e.g. encrypted instant messages or
818email). However, unless the JavaScript was itself transported to the client
819securely, it cannot actually provide any guarantee. (After all, a MITM attacker
820could have modified the code, if it was not transported securely.)
821
Camille0f2a39f2022-11-04 10:45:04822See the [Web Platform Security
Chris Thompson1f8b00062023-05-31 00:38:49823guidelines](https://chromium.googlesource.com/chromium/src/+/main/docs/security/web-platform-security-guidelines.md#encryption)
Camille0f2a39f2022-11-04 10:45:04824for more information on security guidelines applicable to web platform APIs.
825
Chris Palmer554c66e2017-07-29 01:02:56826<a name="TOC-Which-origins-are-secure-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34827### Which origins are "secure"?
Chris Palmer554c66e2017-07-29 01:02:56828
829Secure origins are those that match at least one of the following (scheme, host,
830port) patterns:
831
832* (https, *, *)
833* (wss, *, *)
834* (*, localhost, *)
835* (*, 127/8, *)
836* (*, ::1/128, *)
837* (file, *, —)
838* (chrome-extension, *, —)
839
840That is, secure origins are those that load resources either from the local
841machine (necessarily trusted) or over the network from a
842cryptographically-authenticated server. See [Prefer Secure Origins For Powerful
843New
844Features](https://sites.google.com/a/chromium.org/dev/Home/chromium-security/prefer-secure-origins-for-powerful-new-features)
845for more details.
846
847<a name="TOC-What-s-the-story-with-certificate-revocation-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34848### What's the story with certificate revocation?
Chris Palmer554c66e2017-07-29 01:02:56849
Ryan Dicksonbbcdf3d2022-11-16 19:43:51850Chrome's primary mechanism for checking certificate revocation status is
Joe DeBlasio0c6480712024-07-04 00:11:51851[CRLSets](https://dev.chromium.org/Home/chromium-security/crlsets).
Ryan Dicksonbbcdf3d2022-11-16 19:43:51852Additionally, by default, [stapled Online Certificate Status Protocol (OCSP)
853responses](https://en.wikipedia.org/wiki/OCSP_stapling) are honored.
Chris Palmer554c66e2017-07-29 01:02:56854
Joe DeBlasio0c6480712024-07-04 00:11:51855As of 2024, Chrome enforces most security-relevant certificate revocations that
856are visible via Certificate Revocation Lists (CRLs) published to the
857[CCADB](https://www.ccadb.org/) via CRLSets. There is some inherent delay in
858getting revocation information to Chrome clients, but most revocations should
859reach most users within a few days of appearing on a CA's CRL.
860
861Chrome clients do not, by default, perform "online" certificate revocation
862status checks using CRLs directly or via OCSP URLs included in certificates.
863This is because online checks offer limited security value unless a client, like
danakjc8fb82602024-07-09 16:36:09864Chrome, refuses to connect to a website if it cannot get a valid response,
Chris Palmer554c66e2017-07-29 01:02:56865
Ryan Dicksonbbcdf3d2022-11-16 19:43:51866Unfortunately, there are many widely-prevalent causes for why a client
867might be unable to get a valid certificate revocation status response to
868include:
869* timeouts (e.g., an OCSP responder is online but does not respond within an
Alex Goughc9ab81fd2023-05-15 19:03:14870 acceptable time limit),
871* availability issues (e.g., the OCSP responder is offline),
872* invalid responses (e.g., a "stale" or malformed status response), and
873* local network attacks misrouting traffic or blocking responses.
Chris Palmer554c66e2017-07-29 01:02:56874
Alex Goughc9ab81fd2023-05-15 19:03:14875Additional concern with OCSP checks are related to privacy. OCSP
Ryan Dicksonbbcdf3d2022-11-16 19:43:51876requests reveal details of individuals' browsing history to the operator of the
877OCSP responder (i.e., a third party). These details can be exposed accidentally
878(e.g., via data breach of logs) or intentionally (e.g., via subpoena). Chrome
879used to perform revocation checks for Extended Validation certificates, but that
880behavior 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:56881
Ryan Dicksonbbcdf3d2022-11-16 19:43:51882The following enterprise policies can be used to change the default revocation
883checking behavior in Chrome, though these may be removed in the future:
884* [enable soft-fail OCSP](https://chromeenterprise.google/policies/#EnableOnlineRevocationChecks)
885* [hard-fail for local trust anchors](https://chromeenterprise.google/policies/#RequireOnlineRevocationChecksForLocalAnchors).
Chris Palmer554c66e2017-07-29 01:02:56886
Alex Goughe7bcbea2022-05-03 21:45:34887## Passwords & Local Data
888
889<a name="TOC-What-about-unmasking-of-passwords-with-the-developer-tools-"></a>
890### What about unmasking of passwords with the developer tools?
891
892One of the most frequent reports we receive is password disclosure using the
893Inspect Element feature (see [Issue 126398](https://crbug.com/126398) for an
894example). People reason that "If I can see the password, it must be a bug."
895However, this is just one of the [physically-local attacks described in the
896previous
897section](#TOC-Why-aren-t-physically-local-attacks-in-Chrome-s-threat-model-),
898and all of those points apply here as well.
899
900The reason the password is masked is only to prevent disclosure via
901"shoulder-surfing" (i.e. the passive viewing of your screen by nearby persons),
902not because it is a secret unknown to the browser. The browser knows the
903password at many layers, including JavaScript, developer tools, process memory,
904and so on. When you are physically local to the computer, and only when you are
905physically local to the computer, there are, and always will be, tools for
906extracting the password from any of these places.
907
908<a name="TOC-Is-Chrome-s-support-for-userinfo-in-HTTP-URLs-e.g.-http:-user:password-example.com-considered-a-vulnerability-"></a>
909### Is Chrome's support for userinfo in HTTP URLs (e.g. http://user:[email protected]) considered a vulnerability?
910
911[Not at this time](https://crbug.com/626951). Chrome supports HTTP and HTTPS
912URIs with username and password information embedded within them for
913compatibility with sites that require this feature. Notably, Chrome will
914suppress display of the username and password information after navigation in
915the URL box to limit the effectiveness of spoofing attacks that may try to
916mislead the user. For instance, navigating to
917`http://[email protected]` will show an address of
918`http://evil.example.com` after the page loads.
919
Tom Sepez83fd1f612022-07-18 21:21:27920Note: We often receive reports calling this an "open redirect". However, it has
921nothing to do with redirection; rather the format of URLs is complex and the
922userinfo may be misread as a host.
923
Chris Palmer554c66e2017-07-29 01:02:56924<a name="TOC-Why-does-the-Password-Manager-ignore-autocomplete-off-for-password-fields-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34925### Why does the Password Manager ignore `autocomplete='off'` for password fields?
Chris Palmer554c66e2017-07-29 01:02:56926
927Ignoring `autocomplete='off'` for password fields allows the password manager to
928give more power to users to manage their credentials on websites. It is the
929security team's view that this is very important for user security by allowing
930users to have unique and more complex passwords for websites. As it was
931originally implemented, autocomplete='off' for password fields took control away
932from the user and gave control to the web site developer, which was also a
933violation of the [priority of
Adam Barth3a3bfef2021-10-06 02:36:44934constituencies](https://www.schemehostport.com/2011/10/priority-of-constituencies.html).
Chris Palmer554c66e2017-07-29 01:02:56935For a longer discussion on this, see the [mailing list
936announcement](https://groups.google.com/a/chromium.org/forum/#!topic/chromium-dev/zhhj7hCip5c).
937
Eric Lawrence122e86882017-12-07 22:53:05938<a name="TOC-Signout-of-Chrome"></a>
Alex Goughe7bcbea2022-05-03 21:45:34939### Signing out of Chrome does not delete previously-synced data?
Eric Lawrence122e86882017-12-07 22:53:05940
941If you have signed into Chrome and subsequently sign out of Chrome, previously
942saved passwords and other data are not deleted from your device unless you
943select that option when signing out of Chrome.
944
945If you change your Google password, synced data will no longer be updated in
946Chrome instances until you provide the new password to Chrome on each device
947configured to sync. However, previously synced data [remains available](https://crbug.com/792967)
948on each previously-syncing device unless manually removed.
949
Chris Palmer554c66e2017-07-29 01:02:56950<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:34951### Why doesn't the Password Manager save my Google password if I am using Chrome Sync?
Chris Palmer554c66e2017-07-29 01:02:56952
953In its default mode, Chrome Sync uses your Google password to protect all the
954other passwords in the Chrome Password Manager.
955
956In general, it is a bad idea to store the credential that protects an asset in
957the same place as the asset itself. An attacker who could temporarily compromise
958the Chrome Password Manager could, by stealing your Google password, obtain
959continuing access to all your passwords. Imagine you store your valuables in a
960safe, and you accidentally forget to close the safe. If a thief comes along,
961they might steal all of your valuables. That’s bad, but imagine if you had also
962left the combination to the safe inside as well. Now the bad guy has access to
963all of your valuables and all of your future valuables, too. The password
964manager is similar, except you probably would not even know if a bad guy
965accessed it.
966
967To prevent this type of attack, Chrome Password Manager does not save the Google
968password for the account you sync with Chrome. If you have multiple Google
969accounts, the Chrome Password Manager will save the passwords for accounts other
970than the one you are syncing with.
971
972<a name="TOC-Does-the-Password-Manager-store-my-passwords-encrypted-on-disk-"></a>
Alex Goughe7bcbea2022-05-03 21:45:34973### Does the Password Manager store my passwords encrypted on disk?
Chris Palmer554c66e2017-07-29 01:02:56974
975Chrome generally tries to use the operating system's user storage mechanism
976wherever possible and stores them encrypted on disk, but it is platform
977specific:
978
979* On Windows, Chrome uses the [Data Protection API
980 (DPAPI)](https://msdn.microsoft.com/en-us/library/ms995355.aspx) to bind
981 your passwords to your user account and store them on disk encrypted with
982 a key only accessible to processes running as the same logged on user.
Viktor Semeniuk3720fc42024-04-03 09:33:52983* On macOS and iOS, Chrome previously stored credentials directly in the user's
Chris Palmer554c66e2017-07-29 01:02:56984 Keychain, but for technical reasons, it has switched to storing the
985 credentials in "Login Data" in the Chrome users profile directory, but
986 encrypted on disk with a key that is then stored in the user's Keychain.
Viktor Semeniuk3720fc42024-04-03 09:33:52987 See [Issue 466638](https://crbug.com/466638) and [Issue 520437](https://crbug.com/520437) for further explanation.
Christos Froussios2a02cc52019-07-30 07:04:46988* On Linux, Chrome previously stored credentials directly in the user's
Tom Anderson761687a2023-06-14 17:27:39989 Gnome Secret Service or KWallet, but for technical reasons, it has switched to
Christos Froussios2a02cc52019-07-30 07:04:46990 storing the credentials in "Login Data" in the Chrome user's profile directory,
991 but encrypted on disk with a key that is then stored in the user's Gnome
Tom Anderson761687a2023-06-14 17:27:39992 Secret Service or KWallet. If there is no available Secret Service or KWallet,
993 the data is not encrypted when stored.
Viktor Semeniuk3720fc42024-04-03 09:33:52994* On Android, Chrome doesn't store in the profile anymore, instead it uses Google
995 Play Services to access passwords stored on a device.
996* On ChromeOS passwords are only obfuscated since all profile data is encrypted
997 by the OS.
Chris Palmer554c66e2017-07-29 01:02:56998
Adrian Taylorae8545252021-05-27 17:16:51999<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:341000### If there's a way to see stored passwords without entering a password, is this a security bug?
Adrian Taylorae8545252021-05-27 17:16:511001
1002No. If an attacker has control of your login on your device, they can get to
1003your passwords by inspecting Chrome disk files or memory. (See
1004[why aren't physically-local attacks in Chrome's threat
1005model](#TOC-Why-aren-t-physically-local-attacks-in-Chrome-s-threat-model-)).
1006
1007On some platforms we ask for a password before revealing stored passwords,
1008but this is not considered a robust defense. It’s historically to stop
1009users inadvertently revealing their passwords on screen, for example if
1010they’re screen sharing. We don’t do this on all platforms because we consider
1011such risks greater on some than on others.
1012
Martin Kreichgauer8788fc622024-09-11 21:06:191013
1014<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>
1015### On some websites, I can use passkeys without passing a lock screen or biometric challenge. Is this a security bug?
1016
1017Probably not. When a website requests a passkeys signature, it can choose
1018whether the authenticator should perform user verification (e.g. with a local
1019user lock screen challenge). Unless the website sets user verification parameter
1020in the request to 'required', the passkey authenticator can choose to skip the
1021lock screen challenge. Authenticators commonly skip an optional challenge if
1022biometrics are unavailable (e.g. on a laptop with a closed lid).
1023
1024If you can demonstrate bypassing the user verification challenge where the
1025request user verification parameter is set to 'required', please
1026[report it](https://issues.chromium.org/issues/new?noWizard=true&component=1363614&template=1922342).
1027
Alex Goughe7bcbea2022-05-03 21:45:341028## Other
Alex Gough8dc4f562022-04-18 22:14:051029
Chris Palmer554c66e2017-07-29 01:02:561030<a name="TOC-What-is-the-security-story-for-Service-Workers-"></a>
Alex Goughe7bcbea2022-05-03 21:45:341031### What is the security story for Service Workers?
Chris Palmer554c66e2017-07-29 01:02:561032
1033See our dedicated [Service Worker Security
Eric Lawrence [MSFT]f80579552021-04-22 18:39:261034FAQ](https://chromium.googlesource.com/chromium/src/+/main/docs/security/service-worker-security-faq.md).
Chris Palmer554c66e2017-07-29 01:02:561035
Devlin Cronin7304fec2021-06-02 22:51:261036<a name="TOC-What-is-the-security-story-for-Extensions-"></a>
Alex Goughe7bcbea2022-05-03 21:45:341037### What is the security story for Extensions?
Devlin Cronin7304fec2021-06-02 22:51:261038
1039See our dedicated [Extensions Security FAQ](https://chromium.googlesource.com/chromium/src/+/main/extensions/docs/security_faq.md).
Adrian Taylord57a4c62022-11-10 10:27:501040
Adrian Taylor1bbbf142023-08-29 17:41:171041<a name="TOC-What-is-the-security-model-for-Chrome-Custom-Tabs-"></a>
1042### What's the security model for Chrome Custom Tabs?
1043
1044See our [Chrome Custom Tabs security FAQ](custom-tabs-faq.md).
1045
Adrian Taylor98e9c792024-04-29 18:59:231046<a name="TOC-How-is-security-different-in-Chrome-for-iOS--"></a>
1047### How is security different in Chrome for iOS?
1048
1049Chrome for iOS does not use Chrome's standard rendering engine. Due to Apple's
1050iOS platform restrictions, it instead uses Apple's WebKit engine and a more
1051restricted process isolation model. This means its security properties are
1052different from Chrome on all other platforms.
1053
1054The differences in security are far too extensive to list exhaustively, but some
1055notable points are:
1056
1057* Chromium's [site
1058 isolation](https://www.chromium.org/Home/chromium-security/site-isolation/)
1059 isn't used; WebKit has its own alternative implementation with different costs
1060 and benefits.
1061* WebKit has [historically been slower at shipping security
1062 fixes](https://googleprojectzero.blogspot.com/2022/02/a-walk-through-project-zero-metrics.html).
1063* Chrome's network stack, [root
1064 store](https://www.chromium.org/Home/chromium-security/root-ca-policy/) and
1065 associated technology are not used, so
1066 the platform will make different decisions about what web servers to trust.
1067* Sandboxing APIs are not available for native code.
1068
1069Given that the fundamentals of the browser are so different, and given these
1070limitations, Chrome for iOS has historically not consistently implemented some
1071of Chrome's [standard security guidelines](rules.md). This includes the
1072important [Rule of Two](rule-of-2.md). Future Chrome for iOS features should
1073meet all guidelines except in cases where the lack of platform APIs make it
1074unrealistic. (The use of WebAssembly-based sandboxing is currently considered
1075unrealistic though this could change in future.)
1076
1077If the Rule of Two cannot be followed, features for Chrome for iOS should
1078nevertheless follow it as closely as possible, and adopt additional mitigations
1079where they cannot:
1080
1081* First consider adding a validation layer between unsafe code and web contents,
1082 or adopting memory-safe parsers at the boundary between the renderer and the
1083 browser process. Consider changing the design of the feature so the riskiest
1084 parsing can happen in javascript injected in the renderer process.
1085* Any unsafe unsandboxed code that is exposed to web contents or other
1086 untrustworthy data sources must be extensively tested and fuzzed.
1087
1088The Chrome team is enthusiastic about the future possibility of making a version
1089of Chrome for iOS that meets our usual security standards if richer platform
1090facilities become widely available: this will require revisiting existing
1091features to see if adjustment is required.
1092
Adrian Taylor82a534b2023-05-09 19:21:201093<a name="TOC-Are-all-Chrome-updates-important--"></a>
1094### Are all Chrome updates important?
1095
1096Yes - see [our updates FAQ](updates.md).
1097
1098<a name="TOC-What-older-Chrome-versions-are-supported--"></a>
1099### What older Chrome versions are supported?
1100
1101We always recommend being on the most recent Chrome stable version - see
1102[our updates FAQ](updates.md).
1103
Adrian Taylord57a4c62022-11-10 10:27:501104<a name="TOC-Im-making-a-Chromium-based-browser-how-should-I-secure-it-"></a>
1105### I'm making a Chromium-based browser. How should I secure it?
1106
1107If you want to make a browser based on Chromium, you should stay up to date
1108with Chromium's security fixes. There are adversaries who weaponize fixed
1109Chromium bugs ("n-day vulnerabilities") to target browsers which haven’t yet
1110absorbed those fixes.
1111
1112Decide whether your approach is to stay constantly up to date with Chromium
1113releases, or to backport security fixes onto some older version, upgrading
1114Chromium versions less frequently.
1115
1116Backporting security fixes sounds easier than forward-porting features, but in
1117our experience, this is false. Chromium releases 400+ security bug fixes per
1118year ([example
1119query](https://bugs.chromium.org/p/chromium/issues/list?q=type%3DBug-Security%20has%3Arelease%20closed%3Etoday-730%20closed%3Ctoday-365%20allpublic&can=1)).
1120Some downstream browsers take risks by backporting only Medium+ severity fixes,
1121but that's still over 300 ([example
1122query](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)).
1123Most are trivial cherry-picks; but others require rework and require versatile
1124engineers who can make good decisions about any part of a large codebase.
1125
1126Our recommendation is to stay up-to-date with Chrome's released versions. You
1127should aim to release a version of your browser within just a few days of each
1128Chrome [stable
1129release](https://chromereleases.googleblog.com/search/label/Stable%20updates).
1130If your browser is sufficiently widely-used, you can [apply for advance notice
1131of fixed vulnerabilities](https://www.chromium.org/Home/chromium-security/) to
1132make this a little easier.
1133
1134Finally, if you choose the backporting approach, please explain the security
1135properties to your users. Some fraction of security improvements cannot be
1136backported. This can happen for several reasons, for example: because they
1137depend upon architectural changes (e.g. breaking API changes); because the
1138security improvement is a significant new feature; or because the security
1139improvement is the removal of a broken feature.