blob: 58603b70923eed6bb69c23121186d6f011d5ad91 [file] [log] [blame] [view]
Chris Palmer554c66e2017-07-29 01:02:561# Chrome Security FAQ
2
3[TOC]
4
5<a name="TOC-Why-are-security-bugs-hidden-in-the-Chromium-issue-tracker-"></a>
6## Why are security bugs hidden in the Chromium issue tracker?
7
8We must balance a commitment to openness with a commitment to avoiding
9unnecessary risk for users of widely-used open source libraries.
10
11<a name="TOC-Can-you-please-un-hide-old-security-bugs-"></a>
12## Can you please un-hide old security bugs?
13
14Our goal is to open security bugs to the public once the bug is fixed and the
15fix has been shipped to a majority of users. However, many vulnerabilities
16affect products besides Chromium, and we don’t want to put users of those
17products unnecessarily at risk by opening the bug before fixes for the other
18affected products have shipped.
19
20Therefore, we make all security bugs public within approximately 14 weeks of the
21fix landing in the Chromium repository. The exception to this is in the event of
22the bug reporter or some other responsible party explicitly requesting anonymity
23or protection against disclosing other particularly sensitive data included in
24the vulnerability report (e.g. username and password pairs).
25
26<a name="TOC-Can-I-get-advance-notice-about-security-bugs-"></a>
27## Can I get advance notice about security bugs?
28
29Vendors of products based on Chromium, distributors of operating systems that
30bundle Chromium, and individuals and organizations that significantly contribute
31to fixing security bugs can be added to a list for earlier access to these bugs.
32You can email us at [email protected] to request to join the list if you
33meet the above criteria. In particular, vendors of anti-malware, IDS/IPS,
34vulnerability risk assessment, and similar products or services do not meet this
35bar.
36
37Please note that the safest version of Chrome/Chromium is always the latest
38stable version — there is no good reason to wait to upgrade, so enterprise
39deployments should always track the latest stable release. When you do this,
40there is no need to further assess the risk of Chromium vulnerabilities: we
41strive to fix vulnerabilities quickly and release often.
42
43<a name="TOC-Can-I-see-these-security-bugs-so-that-I-can-back-port-the-fixes-to-my-downstream-project-"></a>
44## Can I see these security bugs so that I can back-port the fixes to my downstream project?
45
46Many developers of other projects use V8, Chromium, and sub-components of
47Chromium in their own projects. This is great! We are glad that Chromium and V8
48suit your needs.
49
50We want to open up fixed security bugs (as described in the previous answer),
51and will generally give downstream developers access sooner. **However, please
52be aware that backporting security patches from recent versions to old versions
53cannot always work.** (There are several reasons for this: The patch won't apply
54to old versions; the solution was to add or remove a feature or change an API;
55the issue may seem minor until it's too late; and so on.) We believe the latest
56stable versions of Chromium and V8 are the most stable and secure. We also
57believe that tracking the latest stable upstream is usually less work for
58greater benefit in the long run than backporting. We strongly recommend that you
59track the latest stable branches, and we support only the latest stable branch.
60
Eric Lawrence122e86882017-12-07 22:53:0561<a name="TOC-Severity-Guidelines"></a>
62## How does the Chrome team determine severity of security bugs?
63
64See the [severity guidelines](severity-guidelines.md) for more information.
Tom Sepeze8fb33202018-11-01 19:31:3265Only security issues are considered under the security vulnerability rewards
66program. Other types of bugs, which we call "functional bugs", are not.
Eric Lawrence122e86882017-12-07 22:53:0567
Chris Palmer554c66e2017-07-29 01:02:5668<a name="TOC-Are-privacy-issues-considered-security-bugs-"></a>
69## Are privacy issues considered security bugs?
70
Tom Sepeze8fb33202018-11-01 19:31:3271No. The Chrome Privacy team treats privacy issues, such as leaking information
72from Incognito, fingerprinting, and bugs related to deleting browsing data as
73functional bugs.
74
75Privacy issues are not considered under the security vulnerability rewards
76program; the [severity guidelines](severity-guidelines.md) outline the types of
77bugs that are considered security vulnerabilities in more detail.
Chris Palmer554c66e2017-07-29 01:02:5678
Eric Lawrence15fdea252017-08-09 19:37:4179<a name="TOC-Timing-Attacks"></a>
80## Are timing attacks considered security vulnerabilities?
81
82Some timing attacks are considered security vulnerabilities, and some are
83considered privacy vulnerabilities. Timing attacks vary significantly in terms
84of impact, reliability, and exploitability.
85
86Some timing attacks weaken mitigations like ASLR (e.g.
87[Issue 665930](https://crbug.com/665930)). Others attempt to circumvent the same
88origin policy, for instance, by using SVG filters to read pixels
89cross-origin (e.g. [Issue 686253](https://crbug.com/686253) and
90[Issue 615851](https://crbug.com/615851)).
91
92Many timing attacks rely upon the availability of high-resolution timing
93information [Issue 508166](https://crbug.com/508166); such timing data often has
94legitimate usefulness in non-attack scenarios making it unappealing to remove.
95
96Timing attacks against the browser's HTTP Cache (like
97[Issue 74987](https://crbug.com/74987)) can potentially leak information about
98which sites the user has previously loaded. The browser could attempt to protect
99against such attacks (e.g. by bypassing the cache) at the cost of performance
100and thus user-experience. To mitigate against such timing attacks, end-users can
101delete browsing history and/or browse sensitive sites using Chrome's Incognito
102or Guest browsing modes.
103
104Other timing attacks can be mitigated via clever design changes. For instance,
105[Issue 544765](https://crbug.com/544765) describes an attack whereby an attacker
106can probe for the presence of HSTS rules (set by prior site visits) by timing
Eric Lawrence29ca2722018-02-22 19:04:05107the load of resources with URLs "fixed-up" by HSTS. Prior to Chrome 64, HSTS
108rules [were shared](https://crbug.com/774643) between regular browsing and
109Incognito mode, making the attack more interesting. The attack was mitigated by
110changing Content-Security-Policy such that secure URLs will match rules
111demanding non-secure HTTP urls, a fix that has also proven useful to help to
112unblock migrations to HTTPS. Similarly, [Issue 707071](https://crbug.com/707071)
113describes a timing attack in which an attacker could determine what Android
114applications are installed; the attack was mitigated by introducing randomness
115in the execution time of the affected API.
Eric Lawrence15fdea252017-08-09 19:37:41116
Chris Palmer554c66e2017-07-29 01:02:56117<a name="TOC-What-are-the-security-and-privacy-guarantees-of-Incognito-mode-"></a>
118## What are the security and privacy guarantees of Incognito mode?
119
120Bugs in Incognito mode are tracked as privacy bugs, not security bugs.
121
Chris Palmer9839ce42017-08-16 20:59:15122The [Help Center](https://support.google.com/chrome/?p=cpn_incognito) explains
123what privacy protections Incognito mode attempts to enforce. In particular,
124please note that Incognito is not a “do not track” mode, and it does not hide
125aspects of your identity from web sites. Chrome does offer a way to send Do Not
126Track request to servers; see chrome://settings/?search=do+not+track
Chris Palmer554c66e2017-07-29 01:02:56127
128When in Incognito mode, Chrome does not store any new history, cookies, or other
129state in non-volatile storage. However, Incognito windows will be able to access
130some previously-stored state, such as browsing history.
131
132<a name="TOC-Are-denial-of-service-issues-considered-security-bugs-"></a>
133## Are denial of service issues considered security bugs?
134
Tom Sepeze8fb33202018-11-01 19:31:32135No. Denial of Service (DoS) issues are treated as **abuse** or **stability**
136issues rather than security vulnerabilities.
Chris Palmer554c66e2017-07-29 01:02:56137
138* If you find a reproducible crash, we encourage you to [report
139 it](https://bugs.chromium.org/p/chromium/issues/entry?template=Crash%20Report).
140* If you find a site that is abusing the user experience (e.g. preventing you
141 from leaving a site), we encourage you to [report
142 it](https://crbug.com/new).
143
144DoS issues are not considered under the security vulnerability rewards program;
Varun Khanejadf1bc00e2017-08-10 05:22:40145the [severity guidelines](severity-guidelines.md) outline the types of bugs that
146are considered security vulnerabilities in more detail.
Chris Palmer554c66e2017-07-29 01:02:56147
148<a name="TOC-Are-XSS-filter-bypasses-considered-security-bugs-"></a>
149## Are XSS filter bypasses considered security bugs?
150
Eric Lawrence81dba4452019-08-21 14:28:20151No. Chromium once contained a reflected XSS filter called the [XSSAuditor](https://www.chromium.org/developers/design-documents/xss-auditor)
152that was a best-effort second line of defense against reflected XSS flaws found
153in 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 Sepeze8fb33202018-11-01 19:31:32154
Chris Palmer554c66e2017-07-29 01:02:56155<a name="TOC-Why-aren-t-physically-local-attacks-in-Chrome-s-threat-model-"></a>
156## Why aren't physically-local attacks in Chrome's threat model?
157
158People sometimes report that they can compromise Chrome by installing a
159malicious DLL in a place where Chrome will load it, by hooking APIs (e.g. [Issue
160130284](https://crbug.com/130284)), or by otherwise altering the configuration
161of the PC.
162
163We consider these attacks outside Chrome's threat model, because there is no way
164for Chrome (or any application) to defend against a malicious user who has
165managed to log into your computer as you, or who can run software with the
166privileges of your operating system user account. Such an attacker can modify
167executables and DLLs, change environment variables like `PATH`, change
168configuration files, read any data your user account owns, email it to
169themselves, and so on. Such an attacker has total control over your computer,
170and nothing Chrome can do would provide a serious guarantee of defense. This
171problem is not special to Chrome ­— all applications must trust the
172physically-local user.
173
174There are a few things you can do to mitigate risks from people who have
175physical control over **your** computer, in certain circumstances.
176
177* To stop people from reading your data in cases of device theft or loss, use
178 full disk encryption (FDE). FDE is a standard feature of most operating
179 systems, including Windows Vista and later, Mac OS X Lion and later, and
180 some distributions of Linux. (Some older versions of Mac OS X had partial
181 disk encryption: they could encrypt the user’s home folder, which contains
182 the bulk of a user’s sensitive data.) Some FDE systems allow you to use
183 multiple sources of key material, such as the combination of both a
184 password and a key file on a USB token. When available, you should use
185 multiple sources of key material to achieve the strongest defense. Chrome
186 OS encrypts users’ home directories.
187* If you share your computer with other people, take advantage of your
188 operating system’s ability to manage multiple login accounts, and use a
189 distinct account for each person. For guests, Chrome OS has a built-in
190 Guest account for this purpose.
191* Take advantage of your operating system’s screen lock feature.
192* You can reduce the amount of information (including credentials like
193 cookies and passwords) that Chrome will store locally by using Chrome's
194 Content Settings (chrome://settings/content) and turning off the form
195 auto-fill and password storage features
196 ([chrome://settings/search#password](chrome://settings/search#password)).
197
198There is almost nothing you can do to mitigate risks when using a **public**
199computer.
200
201* Assume everything you do on a public computer will become, well, public.
202 You have no control over the operating system or other software on the
203 machine, and there is no reason to trust the integrity of it.
Eric Lawrence29ca2722018-02-22 19:04:05204* If you must use such a computer, use Incognito mode and close all Incognito
205 windows when you are done browsing to limit the amount of data you leave
206 behind. Note that Incognito mode **provides no protection** if the system has
207 already been compromised as described above.
Chris Palmer554c66e2017-07-29 01:02:56208
209<a name="TOC-Why-aren-t-compromised-infected-machines-in-Chrome-s-threat-model-"></a>
210## Why aren't compromised/infected machines in Chrome's threat model?
211
212This is essentially the same situation as with physically-local attacks. The
213attacker's code, when it runs as your user account on your machine, can do
214anything you can do. (See also [Microsoft's Ten Immutable Laws Of
Eric Lawrence5e1a9c712018-09-12 20:55:19215Security](https://web.archive.org/web/20160311224620/https://technet.microsoft.com/en-us/library/hh278941.aspx).)
Chris Palmer554c66e2017-07-29 01:02:56216
217<a name="TOC-What-about-unmasking-of-passwords-with-the-developer-tools-"></a>
218## What about unmasking of passwords with the developer tools?
219
220One of the most frequent reports we receive is password disclosure using the
221Inspect Element feature (see [Issue 126398](https://crbug.com/126398) for an
222example). People reason that "If I can see the password, it must be a bug."
223However, this is just one of the [physically-local attacks described in the
224previous
225section](#TOC-Why-aren-t-physically-local-attacks-in-Chrome-s-threat-model-),
226and all of those points apply here as well.
227
228The reason the password is masked is only to prevent disclosure via
229"shoulder-surfing" (i.e. the passive viewing of your screen by nearby persons),
230not because it is a secret unknown to the browser. The browser knows the
231password at many layers, including JavaScript, developer tools, process memory,
232and so on. When you are physically local to the computer, and only when you are
233physically local to the computer, there are, and always will be, tools for
234extracting the password from any of these places.
235
236<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>
Avi Drissman36d4e2e2017-07-31 20:54:39237## 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:56238
Eric Lawrence29ca2722018-02-22 19:04:05239[No](https://crbug.com/81697). Chrome does not attempt to prevent the user from
240knowingly running script against loaded documents, either by entering script in
241the Developer Tools console or by typing a JavaScript: URI into the URL bar.
242Chrome and other browsers do undertake some efforts to prevent *paste* of script
243URLs in the URL bar (to limit
Chris Palmer554c66e2017-07-29 01:02:56244[social-engineering](https://blogs.msdn.microsoft.com/ieinternals/2011/05/19/socially-engineered-xss-attacks/))
245but users are otherwise free to invoke script against pages using either the URL
246bar or the DevTools console.
247
248Similarly, users may create bookmarks pointed at JavaScript URLs that will run
249on the currently-loaded page when the user clicks the bookmark; these are called
250[bookmarklets](https://en.wikipedia.org/wiki/Bookmarklet).
251
252<a name="TOC-Is-Chrome-s-support-for-userinfo-in-HTTP-URLs-e.g.-http:-user:password-example.com-considered-a-vulnerability-"></a>
253## Is Chrome's support for userinfo in HTTP URLs (e.g. http://user:[email protected]) considered a vulnerability?
254
255[Not at this time](https://crbug.com/626951). Chrome supports HTTP and HTTPS
256URIs with username and password information embedded within them for
257compatibility with sites that require this feature. Notably, Chrome will
258suppress display of the username and password information after navigation in
259the URL box to limit the effectiveness of spoofing attacks that may try to
260mislead the user. For instance, navigating to
261`http://[email protected]` will show an address of
262`http://evil.example.com` after the page loads.
263
264<a name="TOC-Why-isn-t-passive-browser-fingerprinting-including-passive-cookies-in-Chrome-s-threat-model-"></a>
Chris Palmer8d95482a2019-08-28 22:48:45265<a name="TOC-What-is-Chrome-s-threat-model-for-fingerprinting-"></a>
266## What is Chrome's threat model for fingerprinting?
Chris Palmer554c66e2017-07-29 01:02:56267
Chris Palmer8d95482a2019-08-28 22:48:45268> **Update, August 2019:** Please note that this answer has changed. We have
269> updated our threat model to include fingerprinting.
Chris Palmer554c66e2017-07-29 01:02:56270
Chris Palmer8d95482a2019-08-28 22:48:45271Although [we do not consider fingerprinting issues to be *security
272vulnerabilities*](#TOC-Are-privacy-issues-considered-security-bugs-), we do now
273consider them to be privacy bugs that we will try to resolve. We distinguish two
274forms of fingerprinting.
Chris Palmer554c66e2017-07-29 01:02:56275
Chris Palmer8d95482a2019-08-28 22:48:45276* **Passive fingerprinting** refers to fingerprinting techniques that do not
277require a JavaScript API call to achieve. This includes (but is not limited to)
278mechanisms like [ETag
279cookies](https://en.wikipedia.org/wiki/HTTP_ETag#Tracking_using_ETags) and [HSTS
280cookies](https://security.stackexchange.com/questions/79518/what-are-hsts-super-cookies).
281* **Active fingerprinting** refers to fingerprinting techniques that do require
282a JavaScript API call to achieve. Examples include most of the techniques in
283[EFF's Panopticlick proof of concept](https://panopticlick.eff.org).
Chris Palmer554c66e2017-07-29 01:02:56284
Chris Palmer8d95482a2019-08-28 22:48:45285For passive fingerprinting, our ultimate goal is (to the extent possible) to
286reduce the information content available to below the threshold for usefulness.
287
288For active fingerprinting, our ultimate goal is to establish a [privacy
289budget](https://github.com/bslassey/privacy-budget) and to keep web origins
290below the budget (such as by rejecting some API calls when the origin exceeds
291its budget). To avoid breaking rich web applications that people want to use,
292Chrome may increase an origin's budget when it detects that a person is using
293the origin heavily. As with passive fingerprinting, our goal is to set the
294default budget below the threshold of usefulness for fingerprinting.
295
296These are both long-term goals. As of this writing (August 2019) we do not
297expect that Chrome will immediately achieve them.
298
299For background on fingerprinting and the difficulty of stopping it, see [Arvind
300Narayanan's site](https://33bits.wordpress.com/about/) and [Peter Eckersley's
301discussion of the information theory behind
302Panopticlick](https://www.eff.org/deeplinks/2010/01/primer-information-theory-and-privacy).
303There is also [a pretty good analysis of in-browser fingerprinting
304vectors](https://dev.chromium.org/Home/chromium-security/client-identification-mechanisms).
Chris Palmer554c66e2017-07-29 01:02:56305
306<a name="TOC-Where-are-the-security-indicators-located-in-the-browser-window-"></a>
307## Where are the security indicators located in the browser window?
308
309The topmost portion of the browser window, consisting of the **Omnibox** (or
310**Location Bar**), navigation icons, menu icon, and other indicator icons, is
311sometimes called the browser **chrome** (not to be confused with the Chrome
312Browser itself). Actual security indicators can only appear in this section of
313the window. There can be no trustworthy security indicators elsewhere.
314
315Furthermore, Chrome can only guarantee that it is correctly representing URLs
316and their origins at the end of all navigation. Quirks of URL parsing, HTTP
317redirection, and so on are not security concerns unless Chrome is
318misrepresenting a URL or origin after navigation has completed.
319
320Browsers present a dilemma to the user since the output is a combination of
321information coming from both trustworthy sources (the browser itself) and
322untrustworthy sources (the web page), and the untrustworthy sources are allowed
323virtually unlimited control over graphical presentation. The only restriction on
324the page's presentation is that it is confined to the large rectangular area
325directly underneath the chrome, called the **viewport**. Things like hover text
326and URL preview(s), shown in the viewport, are entirely under the control of the
327web page itself. They have no guaranteed meaning, and function only as the page
328desires. This can be even more confusing when pages load content that looks like
329chrome. For example, many pages load images of locks, which look similar to the
330meaningful HTTPS lock in the Omnibox, but in fact do not convey any meaningful
331information about the transport security of that page.
332
333When the browser needs to show trustworthy information, such as the bubble
334resulting from a click on the lock icon, it does so by making the bubble overlap
335chrome. In the case of the lock bubble, it is a small triangular bump in the
336border of the bubble that overlays the chrome. This visual detail can't be
337imitated by the page itself since the page is confined to the viewport.
338
339<a name="TOC-Why-does-Chrome-show-a-green-lock-even-if-my-HTTPS-connection-is-being-proxied-"></a>
340## Why does Chrome show a green lock, even if my HTTPS connection is being proxied?
341
342Some types of software intercept HTTPS connections. Examples include anti-virus
343software, corporate network monitoring tools, and school censorship software. In
344order for the interception to work, you need to install a private trust anchor
345(root certificate) onto your computer. This may have happened when you installed
346your anti-virus software, or when your company's network administrator set up
347your computer. If that has occurred, your HTTPS connections can be viewed or
348modified by the software.
349
350Since you have allowed the trust anchor to be installed onto your computer,
351Chrome assumes that you have consented to HTTPS interception. Anyone who can add
352a trust anchor to your computer can make other changes to your computer, too,
353including changing Chrome. (See also [Why aren't physically-local attacks in
Avi Drissman36d4e2e2017-07-31 20:54:39354Chrome's threat model?](#TOC-Why-aren-t-physically-local-attacks-in-Chrome-s-threat-model-).)
Chris Palmer554c66e2017-07-29 01:02:56355
356<a name="TOC-Why-can-t-I-select-Proceed-Anyway-on-some-HTTPS-error-screens-"></a>
357## Why can’t I select Proceed Anyway on some HTTPS error screens?
358
359A key guarantee of HTTPS is that Chrome can be relatively certain that it is
360connecting to the true web server and not an impostor. Some sites request an
361even higher degree of protection for their users (i.e. you): they assert to
362Chrome (via Strict Transport Security —
Xiaoyin Liub7985e52017-09-21 18:07:46363[HSTS](https://tools.ietf.org/html/rfc6797) — or by other means) that any
Chris Palmer554c66e2017-07-29 01:02:56364server authentication error should be fatal, and that Chrome must close the
365connection. If you encounter such a fatal error, it is likely that your network
366is under attack, or that there is a network misconfiguration that is
367indistinguishable from an attack.
368
369The best thing you can do in this situation is to raise the issue to your
370network provider (or corporate IT department).
371
372Chrome shows non-recoverable HTTPS errors only in cases where the true server
373has previously asked for this treatment, and when it can be relatively certain
374that the current server is not the true server.
375
376<a name="TOC-How-does-key-pinning-interact-with-local-proxies-and-filters-"></a>
377## How does key pinning interact with local proxies and filters?
378
379To enable certificate chain validation, Chrome has access to two stores of trust
Adam Langleyc078ba82018-12-17 17:25:46380anchors (i.e. certificates that are empowered as issuers). One trust anchor
381store is the system or public trust anchor store, and the other other is the
382local or private trust anchor store. The public store is provided as part of
383the operating system, and intended to authenticate public internet servers. The
Chris Palmer554c66e2017-07-29 01:02:56384private store contains certificates installed by the user or the administrator
385of the client machine. Private intranet servers should authenticate themselves
386with certificates issued by a private trust anchor.
387
388Chrome’s key pinning feature is a strong form of web site authentication that
389requires a web server’s certificate chain not only to be valid and to chain to a
390known-good trust anchor, but also that at least one of the public keys in the
391certificate chain is known to be valid for the particular site the user is
392visiting. This is a good defense against the risk that any trust anchor can
393authenticate any web site, even if not intended by the site owner: if an
394otherwise-valid chain does not include a known pinned key (“pin”), Chrome will
395reject it because it was not issued in accordance with the site operator’s
396expectations.
397
398Chrome does not perform pin validation when the certificate chain chains up to a
399private trust anchor. A key result of this policy is that private trust anchors
400can be used to proxy (or
Xiaoyin Liub7985e52017-09-21 18:07:46401[MITM](https://en.wikipedia.org/wiki/Man-in-the-middle_attack)) connections, even
Chris Palmer554c66e2017-07-29 01:02:56402to pinned sites. “Data loss prevention” appliances, firewalls, content filters,
403and malware can use this feature to defeat the protections of key pinning.
404
405We deem this acceptable because the proxy or MITM can only be effective if the
406client machine has already been configured to trust the proxy’s issuing
407certificate — that is, the client is already under the control of the person who
408controls the proxy (e.g. the enterprise’s IT administrator). If the client does
409not trust the private trust anchor, the proxy’s attempt to mediate the
410connection will fail as it should.
411
Adam Langleyc078ba82018-12-17 17:25:46412<a name="TOC-When-is-key-pinning-enabled-"></a>
413## When is key pinning enabled?
414
415Key pinning is enabled for Chrome-branded, non-mobile builds when the local
416clock is within ten weeks of the embedded build timestamp. Key pinning is a
417useful security measure but it tightly couples client and server configurations
418and completely breaks when those configurations are out of sync. In order to
419manage that risk we need to ensure that we can promptly update pinning clients
420an in emergency and ensure that non-emergency changes can be deployed in a
421reasonable timeframe.
422
423Each of the conditions listed above helps ensure those properties:
424Chrome-branded builds are those that Google provides and they all have an
425auto-update mechanism that can be used in an emergency. However, auto-update on
426mobile devices is significantly less effective thus they are excluded. Even in
427cases where auto-update is generally effective, there are still non-trivial
428populations of stragglers for various reasons. The ten-week timeout prevents
429those stragglers from causing problems for regular, non-emergency changes and
430allows stuck users to still, for example, conduct searches and access Chrome's
431homepage to hopefully get unstuck.
432
433In order to determine whether key pinning is active, try loading
434[https://pinningtest.appspot.com](https://pinningtest.appspot.com). If key
435pinning is active the load will _fail_ with a pinning error.
436
Chris Palmer38d751d002017-08-23 17:37:35437<a name="TOC-How-does-certificate-transparency-interact-with-local-proxies-and-filters-"></a>
438## How does Certificate Transparency interact with local proxies and filters?
439
Chris Palmer413f3c02017-08-23 17:47:54440Just as [pinning only applies to publicly-trusted trust
441anchors](#TOC-How-does-key-pinning-interact-with-local-proxies-and-filters-),
442Chrome only evaluates Certificate Transparency (CT) for publicly-trusted trust
443anchors. Thus private trust anchors, such as for enterprise middle-boxes and AV
444proxies, do not need to be publicly logged in a CT log.
Chris Palmer38d751d002017-08-23 17:37:35445
Chris Palmer554c66e2017-07-29 01:02:56446<a name="TOC-Can-I-use-EMET-to-help-protect-Chrome-against-attack-on-Microsoft-Windows-"></a>
447## Can I use EMET to help protect Chrome against attack on Microsoft Windows?
448
449There are [known compatibility
450problems](https://sites.google.com/a/chromium.org/dev/Home/chromium-security/chromium-and-emet)
451between Microsoft's EMET anti-exploit toolkit and some versions of Chrome. These
452can prevent Chrome from running in some configurations. Moreover, the Chrome
453security team does not recommend the use of EMET with Chrome because its most
454important security benefits are redundant with or superseded by built-in attack
455mitigations within the browser. For users, the very marginal security benefit is
456not usually a good trade-off for the compatibility issues and performance
457degradation the toolkit can cause.
458
459<a name="TOC-Why-are-some-web-platform-features-only-available-in-HTTPS-page-loads-"></a>
460## Why are some web platform features only available in HTTPS page-loads?
461
462The full answer is here: we [Prefer Secure Origins For Powerful New
463Features](https://www.chromium.org/Home/chromium-security/prefer-secure-origins-for-powerful-new-features).
464In short, many web platform features give web origins access to sensitive new
465sources of information, or significant power over a user's experience with their
Eric Romaned127b672018-01-23 19:36:38466computer/phone/watch/etc., or over their experience with it. We would therefore
Chris Palmer554c66e2017-07-29 01:02:56467like to have some basis to believe the origin meets a minimum bar for security,
468that the sensitive information is transported over the Internet in an
Eric Romaned127b672018-01-23 19:36:38469authenticated and confidential way, and that users can make meaningful choices
Chris Palmer554c66e2017-07-29 01:02:56470to trust or not trust a web origin.
471
472Note that the reason we require secure origins for WebCrypto is slightly
473different: An application that uses WebCrypto is almost certainly using it to
474provide some kind of security guarantee (e.g. encrypted instant messages or
475email). However, unless the JavaScript was itself transported to the client
476securely, it cannot actually provide any guarantee. (After all, a MITM attacker
477could have modified the code, if it was not transported securely.)
478
479<a name="TOC-Which-origins-are-secure-"></a>
480## Which origins are "secure"?
481
482Secure origins are those that match at least one of the following (scheme, host,
483port) patterns:
484
485* (https, *, *)
486* (wss, *, *)
487* (*, localhost, *)
488* (*, 127/8, *)
489* (*, ::1/128, *)
490* (file, *, —)
491* (chrome-extension, *, —)
492
493That is, secure origins are those that load resources either from the local
494machine (necessarily trusted) or over the network from a
495cryptographically-authenticated server. See [Prefer Secure Origins For Powerful
496New
497Features](https://sites.google.com/a/chromium.org/dev/Home/chromium-security/prefer-secure-origins-for-powerful-new-features)
498for more details.
499
500<a name="TOC-What-s-the-story-with-certificate-revocation-"></a>
501## What's the story with certificate revocation?
502
503Chrome's primary mechanism for checking the revocation status of HTTPS
504certificates is
Xiaoyin Liub7985e52017-09-21 18:07:46505[CRLsets](https://dev.chromium.org/Home/chromium-security/crlsets).
Chris Palmer554c66e2017-07-29 01:02:56506
507Chrome also supports Online Certificate Status Protocol (OCSP). However, the
508effectiveness of OCSP is is essentially 0 unless the client fails hard (refuses
509to connect) if it cannot get a live, valid OCSP response. No browser has OCSP
510set to hard-fail by default, for good reasons explained by Adam Langley (see
511[https://www.imperialviolet.org/2014/04/29/revocationagain.html](https://www.imperialviolet.org/2014/04/29/revocationagain.html) and
512[https://www.imperialviolet.org/2014/04/19/revchecking.html](https://www.imperialviolet.org/2014/04/19/revchecking.html)).
513
514Stapled OCSP with the Must Staple option (hard-fail if a valid OCSP response is
515not stapled to the certificate) is a much better solution to the revocation
516problem than non-stapled OCSP. CAs and browsers are working toward that solution
517(see the
Xiaoyin Liub7985e52017-09-21 18:07:46518[Internet-Draft](https://tools.ietf.org/html/draft-hallambaker-tlssecuritypolicy-03)).
Chris Palmer554c66e2017-07-29 01:02:56519
520Additionally, non-stapled OCSP poses a privacy problem: in order to check the
521status of a certificate, the client must query an OCSP responder for the status
522of the certificate, thus exposing a user's HTTPS browsing history to the
523responder (a third party).
524
525That said, you can use enterprise policies to [enable soft-fail
526OCSP](https://www.chromium.org/administrators/policy-list-3#EnableOnlineRevocationChecks)
527and hard-fail OCSP for [local trust
528anchors](https://www.chromium.org/administrators/policy-list-3#RequireOnlineRevocationChecksForLocalAnchors).
529
530Chrome performs online checking for [Extended
531Validation](https://cabforum.org/about-ev-ssl/) certificates if it does not
532already have a non-expired CRLSet entry covering the domain. If Chrome does not
533get a response, it simply downgrades the security indicator to Domain Validated.
534
535See also [Issue 361820](https://crbug.com/361820) for more discussion of the
536user-facing UX.
537
538<a name="TOC-Why-does-the-Password-Manager-ignore-autocomplete-off-for-password-fields-"></a>
539## Why does the Password Manager ignore `autocomplete='off'` for password fields?
540
541Ignoring `autocomplete='off'` for password fields allows the password manager to
542give more power to users to manage their credentials on websites. It is the
543security team's view that this is very important for user security by allowing
544users to have unique and more complex passwords for websites. As it was
545originally implemented, autocomplete='off' for password fields took control away
546from the user and gave control to the web site developer, which was also a
547violation of the [priority of
548constituencies](http://www.schemehostport.com/2011/10/priority-of-constituencies.html).
549For a longer discussion on this, see the [mailing list
550announcement](https://groups.google.com/a/chromium.org/forum/#!topic/chromium-dev/zhhj7hCip5c).
551
Eric Lawrence122e86882017-12-07 22:53:05552<a name="TOC-Signout-of-Chrome"></a>
553## Signing out of Chrome does not delete previously-synced data?
554
555If you have signed into Chrome and subsequently sign out of Chrome, previously
556saved passwords and other data are not deleted from your device unless you
557select that option when signing out of Chrome.
558
559If you change your Google password, synced data will no longer be updated in
560Chrome instances until you provide the new password to Chrome on each device
561configured to sync. However, previously synced data [remains available](https://crbug.com/792967)
562on each previously-syncing device unless manually removed.
563
Chris Palmer554c66e2017-07-29 01:02:56564<a name="TOC-Why-doesn-t-the-Password-Manager-save-my-Google-password-if-I-am-using-Chrome-Sync-"></a>
565## Why doesn't the Password Manager save my Google password if I am using Chrome Sync?
566
567In its default mode, Chrome Sync uses your Google password to protect all the
568other passwords in the Chrome Password Manager.
569
570In general, it is a bad idea to store the credential that protects an asset in
571the same place as the asset itself. An attacker who could temporarily compromise
572the Chrome Password Manager could, by stealing your Google password, obtain
573continuing access to all your passwords. Imagine you store your valuables in a
574safe, and you accidentally forget to close the safe. If a thief comes along,
575they might steal all of your valuables. That’s bad, but imagine if you had also
576left the combination to the safe inside as well. Now the bad guy has access to
577all of your valuables and all of your future valuables, too. The password
578manager is similar, except you probably would not even know if a bad guy
579accessed it.
580
581To prevent this type of attack, Chrome Password Manager does not save the Google
582password for the account you sync with Chrome. If you have multiple Google
583accounts, the Chrome Password Manager will save the passwords for accounts other
584than the one you are syncing with.
585
586<a name="TOC-Does-the-Password-Manager-store-my-passwords-encrypted-on-disk-"></a>
587## Does the Password Manager store my passwords encrypted on disk?
588
589Chrome generally tries to use the operating system's user storage mechanism
590wherever possible and stores them encrypted on disk, but it is platform
591specific:
592
593* On Windows, Chrome uses the [Data Protection API
594 (DPAPI)](https://msdn.microsoft.com/en-us/library/ms995355.aspx) to bind
595 your passwords to your user account and store them on disk encrypted with
596 a key only accessible to processes running as the same logged on user.
597* On macOS, Chrome previously stored credentials directly in the user's
598 Keychain, but for technical reasons, it has switched to storing the
599 credentials in "Login Data" in the Chrome users profile directory, but
600 encrypted on disk with a key that is then stored in the user's Keychain.
601 See [Issue 466638](https://crbug.com/466638) for further explanation.
Christos Froussios2a02cc52019-07-30 07:04:46602* On Linux, Chrome previously stored credentials directly in the user's
603 Gnome Keyring or KWallet, but for technical reasons, it has switched to
604 storing the credentials in "Login Data" in the Chrome user's profile directory,
605 but encrypted on disk with a key that is then stored in the user's Gnome
606 Keyring or KWallet. If there is no available Keyring or KWallet, the data is
607 not encrypted when stored.
Chris Palmer554c66e2017-07-29 01:02:56608* On iOS, passwords are currently stored directly in the iOS Keychain and
609 referenced from the rest of the metadata stored in a separate DB. The plan
610 there is to just store them in plain text in the DB, because iOS gives
611 strong guarantees about only Chrome being able to access its storage. See
612 [Issue 520437](https://crbug.com/520437) to follow this migration.
613
614<a name="TOC-I-found-a-phishing-or-malware-site-not-blocked-by-Safe-Browsing.-Is-this-a-security-vulnerability-"></a>
615## I found a phishing or malware site not blocked by Safe Browsing. Is this a security vulnerability?
616
617Malicious sites not yet blocked by Safe Browsing can be reported via
618[https://www.google.com/safebrowsing/report_phish/](https://www.google.com/safebrowsing/report_phish/).
619Safe Browsing is primarily a blocklist of known-unsafe sites; the feature warns
620the user if they attempt to navigate to a site known to deliver phishing or
621malware content. You can learn more about this feature in these references:
622
623* [https://developers.google.com/safe-browsing/](https://developers.google.com/safe-browsing/)
624* [https://www.google.com/transparencyreport/safebrowsing/](https://www.google.com/transparencyreport/safebrowsing/)
625
626In general, it is not considered a security bug if a given malicious site is not
627blocked by the Safe Browsing feature, unless the site is on the blocklist but is
628allowed to load anyway. For instance, if a site found a way to navigate through
629the blocking red warning page without user interaction, that would be a security
630bug. A malicious site may exploit a security vulnerability (for instance,
631spoofing the URL in the **Location Bar**). This would be tracked as a security
632vulnerability in the relevant feature, not Safe Browsing itself.
633
634<a name="TOC-What-is-the-security-story-for-Service-Workers-"></a>
635## What is the security story for Service Workers?
636
637See our dedicated [Service Worker Security
Eric Lawrence15fdea252017-08-09 19:37:41638FAQ](https://chromium.googlesource.com/chromium/src/+/master/docs/security/service-worker-security-faq.md).
Chris Palmer554c66e2017-07-29 01:02:56639
Mustafa Emre Acerfbff231b2019-07-01 19:28:59640<a name="TOC-What-about-URL-spoofs-using-Internationalized-Domain-Names-IDN-"></a>
641## What about URL spoofs using Internationalized Domain Names (IDN)?
642
643We try to balance the needs of our international userbase while protecting users
644against confusable homograph attacks. Despite this, there are a list of known
645IDN display issues we are still working on.
646
647* Please see [this document](https://docs.google.com/document/d/1_xJz3J9kkAPwk3pma6K3X12SyPTyyaJDSCxTfF8Y5sU)
648for a list of known issues and how we handle them.
649* [This document](https://www.chromium.org/developers/design-documents/idn-in-google-chrome)
650describes Chrome's IDN policy in detail.
651
Chris Palmer554c66e2017-07-29 01:02:56652## TODO
653
Chris Palmer554c66e2017-07-29 01:02:56654* https://dev.chromium.org/Home/chromium-security/client-identification-mechanisms