expand default connections information

This commit is contained in:
Daniel Micay 2020-09-29 02:37:55 -04:00
parent dd16b1a49f
commit 6721710e5f

View File

@ -438,16 +438,25 @@
<p>Users are in control of which types of networks the Updater app will use <p>Users are in control of which types of networks the Updater app will use
and can disable the Updater app in extreme cases. It's strongly recommended to and can disable the Updater app in extreme cases. It's strongly recommended to
leave it enabled to quickly receive security updates including updates outside leave it enabled to quickly receive security updates including updates outside
the regular monthly schedule. See the <a href="/usage#updates">usage guide's the regular monthly schedule.</p>
section on updates</a> for more information.</p> <p>The update client avoids trusting the data obtained from the update server
via signature verification with downgrade protection. Verified boot provides
another layer of signature verification with downgrade protection. GrapheneOS
servers do not have access to GrapheneOS signing keys.</p>
<p>See the <a href="/usage#updates">usage guide's section on updates</a> for
more information.</p>
</li> </li>
<li> <li>
<p>An HTTPS connection is made to https://time.grapheneos.org/ to update the <p>An HTTPS connection is made to https://time.grapheneos.org/ to update the
time from the date header field. This is a full replacement of Android's time from the date header field. This is a full replacement of Android's
standard network time update implementation, which uses the cellular network standard network time update implementation, which uses the cellular network
when available with a fallback to SNTP when it's not available. We plan to when available with a fallback to SNTP when it's not available. Network time
offer a toggle to use the standard functionality instead of HTTPS-based time updates are security sensitive since certificate validation depends on having
updates in order to blend in with other devices.</p> an accurate time, but the standard NTP / SNTP protocols used across most OSes
have no authentication.</p>
<p>We plan to offer a toggle to use the standard functionality instead of
HTTPS-based time updates in order to blend in with other devices.</p>
<p>Network time can be disabled with the toggle at Settings ➔ System ➔ Date <p>Network time can be disabled with the toggle at Settings ➔ System ➔ Date
&amp; time ➔ Use network-provided time. Unlike AOSP or the stock OS on the &amp; time ➔ Use network-provided time. Unlike AOSP or the stock OS on the
@ -458,7 +467,7 @@
</li> </li>
<li> <li>
<p>On devices with a Qualcomm baseband (which provides GPS), when location <p>On devices with a Qualcomm baseband (which provides GPS), when location
functionality is being used, functionality is enabled and being used,
<a href="https://en.wikipedia.org/wiki/GPS_signals#Almanac">GPS almanacs</a> <a href="https://en.wikipedia.org/wiki/GPS_signals#Almanac">GPS almanacs</a>
are downloaded from https://xtrapath1.izatcloud.net/xtra3grc.bin, are downloaded from https://xtrapath1.izatcloud.net/xtra3grc.bin,
https://xtrapath2.izatcloud.net/xtra3grc.bin or https://xtrapath2.izatcloud.net/xtra3grc.bin or
@ -489,17 +498,21 @@
privacy by giving your device a more unique fingerprint. GrapheneOS aims to privacy by giving your device a more unique fingerprint. GrapheneOS aims to
appear like any other common mobile device on the network.</p> appear like any other common mobile device on the network.</p>
<p>Standard frozen AOSP user agent for the GET request:</p>
<p>Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.32 Safari/537.36</p>
<p>No query / data is sent to the servers and the response is unused beyond
checking the response code.</p>
<p>Standard URLs used by Android and when blending in with other devices on
GrapheneOS:</p>
<ul> <ul>
<li>HTTPS: https://www.google.com/generate_204</li> <li>HTTPS: https://www.google.com/generate_204</li>
<li>HTTP: http://connectivitycheck.gstatic.com/generate_204</li> <li>HTTP: http://connectivitycheck.gstatic.com/generate_204</li>
<li>HTTP fallback: http://www.google.com/gen_204</li> <li>HTTP fallback: http://www.google.com/gen_204</li>
<li>HTTP other fallback: http://play.googleapis.com/generate_204</li> <li>HTTP other fallback: http://play.googleapis.com/generate_204</li>
</ul> </ul>
<p>Standard AOSP user agent for the GET request:</p>
<p>Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.32 Safari/537.36</p>
<p>No query / data is sent to the servers and the response is unused beyond
checking the response code.</p>
<p>Similar connectivity checks are also performed by Vanadium.</p>
<p>We have our own connectivitycheck.grapheneos.org server as an alternative <p>We have our own connectivitycheck.grapheneos.org server as an alternative
to using the standard URLs. This can currently be enabled by users interested to using the standard URLs. This can currently be enabled by users interested
in using it via the developer tools. Providing a toggle in the Settings app in using it via the developer tools. Providing a toggle in the Settings app
@ -509,6 +522,19 @@
important and must remain supported for people who need to be able to blend in important and must remain supported for people who need to be able to blend in
rather than getting the nice feeling that comes from using GrapheneOS rather than getting the nice feeling that comes from using GrapheneOS
servers.</p> servers.</p>
<ul>
<li>HTTPS: https://connectivitycheck.grapheneos.org/generate_204</li>
<li>HTTP: http://connectivitycheck.grapheneos.org/generate_204</li>
</ul>
<p>We do not currently provide a separate fallback domain so the fallback HTTP
fallback should be set to
http://connectivitycheck.grapheneos.org/generate_204.</p>
<p>Similar connectivity checks are also performed by Vanadium. Configuration
will need to be extended to these, likely by reusing the OS configuration
instead of it being separate.</p>
</li> </li>
<li> <li>
<p>DNS connectivity and functionality tests</p> <p>DNS connectivity and functionality tests</p>