Partial update to the Guide.
[PrivacyBrowser.git] / app / src / main / assets / en / guide_local_storage_dark.html
1 <!--
2   Copyright © 2016-2018 Soren Stoutner <soren@stoutner.com>.
3
4   This file is part of Privacy Browser <https://www.stoutner.com/privacy-browser>.
5
6   Privacy Browser is free software: you can redistribute it and/or modify
7   it under the terms of the GNU General Public License as published by
8   the Free Software Foundation, either version 3 of the License, or
9   (at your option) any later version.
10
11   Privacy Browser is distributed in the hope that it will be useful,
12   but WITHOUT ANY WARRANTY; without even the implied warranty of
13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14   GNU General Public License for more details.
15
16   You should have received a copy of the GNU General Public License
17   along with Privacy Browser.  If not, see <http://www.gnu.org/licenses/>. -->
18
19 <html>
20     <head>
21         <meta charset="UTF-8">
22
23         <link rel="stylesheet" href="../css/dark_theme.css">
24     </head>
25
26     <body>
27         <h3><img class="title" src="../shared_images/cookie_blue_dark.png"> First-Party Cookies</h3>
28
29         <p>First-party cookies are set by the website in the URL bar at the top of the page.</p>
30
31         <p>From the early days of the internet, it became obvious that it would be advantageous for websites to be able to store information on a computer for future access.
32             For example, a website that displays weather information could ask the user for a zip code, and then store it in a cookie.
33             The next time the user visited the website, weather information would automatically load for that zip code, without the user having to enter it again.</p>
34
35         <p>Like everything else on the web, clever people figured out all types of ways to abuse cookies to do things that users would not approve of if they knew they were happening.
36             For example, a website can set a cookie with a unique serial number on a device.
37             Then, every time a user visits the website on that device, it can be linked to a unique profile the server maintains for that serial number,
38             even if the device connects from different IP addresses.</p>
39
40         <p>Almost all websites with logins require first-party cookies to be enabled for a user to log in.
41             That is how they make sure it is still you as you move from page to page on the site, and is, in my opinion, one of the few legitimate uses for cookies.</p>
42
43         <p>If first-party cookies are enabled but JavaScript is disabled, the privacy icon will be yellow <img class="inline" src="../shared_images/warning.png"> as a warning.</p>
44
45
46         <h3><img class="title" src="../shared_images/cookie_blue_dark.png"> Third-Party Cookies</h3>
47
48         <p>Third-party cookies are set by portions of a website that are loaded from servers different from the URL at the top of the page.
49             For example, most website that have advertisements load them from a third-party ad broker, like Google’s <a href="https://www.google.com/adsense/start/">Ad Sense</a>.
50             Every time the website loads, it requests the ad broker to display an ad.
51             The ad broker analyzes any information they may have about the user, looks at the current rate advertisers are willing to pay for their ads, and selects the one to display.
52             The section of the website that displays the ads is loaded from the third-party broker’s server instead of the main server.</p>
53
54         <p>Because most of the advertisements on the internet are processed by only a few brokers,
55             it didn’t take long for them to realize that they could set a tracking cookie on the user’s device and know every place that user goes.
56             Every time an ad loads from a broker, the first thing it does it check to see if if the device already has a unique serial number in a tracking cookie.
57             If it does, it looks up the profile for that serial number and makes a note of the new site.
58             This is why a user can do a search on one website for a product they typically don’t look for, like walnuts,
59             and then suddenly start seeing advertisements for walnuts on every website they visit.</p>
60
61         <p>In addition to ad brokers, social media sites discovered they could get in on the action.
62             A few years ago, the major social media sites like Facebook and Twitter convinced a large number of websites
63             that it would be in their best interest to place little social media icons on their pages.
64             These are not just images. They contain <a href="https://developers.facebook.com/docs/plugins/like-button/">embedded code</a> that links back to the social media site, and, among other things,
65             loads a third-party cookie on the device. These cookies are placed even if the user does not have an account with the social media platform.
66             Over time, companies like Facebook (which also runs an ad network) have built up quite a large number of detailed profiles about people who have
67             <a href="http://www.theverge.com/2016/5/27/11795248/facebook-ad-network-non-users-cookies-plug-ins">never even created an account on their site</a>.</p>
68
69         <p>There is no good reason to ever enable third-party cookies. On devices with Android KitKat or older (version <= 4.4.4 or API <= 20), WebView does not
70             <a href="https://developer.android.com/reference/android/webkit/CookieManager.html#setAcceptThirdPartyCookies(android.webkit.WebView, boolean)">differentiate
71             between first-party and third-party cookies</a>. Thus, enabling first-party cookies will also enable third-party cookies.</p>
72
73         <h3><img class="title" src="../shared_images/web_blue_dark.png"> DOM Storage</h3>
74
75         <p>Document Object Model storage, also known as web storage, is like cookies on steroids.
76             Whereas the maximum combined storage size for all cookies from a single URL is 4 kilobytes,
77             DOM storage can hold <a href="https://en.wikipedia.org/wiki/Web_storage#Storage_size">megabytes per site</a>.
78             Because DOM storage uses JavaScript to read and write data, it cannot be enabled unless JavaScript is also enabled.</p>
79
80
81         <h3><img class="title" src="../shared_images/subtitles_blue_dark.png"> Form Data</h3>
82
83         <p>Form data contains information typed into web forms, like user names, addresses, phone numbers, etc., and lists them in a drop-down box on future visits.
84             Unlike the other forms of local storage, form data is not sent to the web server without specific user interaction.
85             Beginning in Android Oreo (8.0), WebView’s form data was replaced by the the <a href="https://medium.com/@bherbst/getting-androids-autofill-to-work-for-you-21435debea1">Autofill service</a>.
86             As such, controls for form data no longer appear on newer Android devices.</p>
87     </body>
88 </html>