diff options
| author | Daniel Micay <daniel.micay@grapheneos.org> | 2024-11-13 08:54:07 -0500 |
|---|---|---|
| committer | Daniel Micay <daniel.micay@grapheneos.org> | 2024-11-13 08:54:39 -0500 |
| commit | e629e0cc9eb079e47df0e472aa995266c4e4cc8e (patch) | |
| tree | 614251becf9056e3fb9c17178a2ef66173836979 | |
| parent | ae44e2374e6972cd60b413c3620286a8aa38fbe9 (diff) | |
replace obsolete USB peripherals section in usage guide
| -rw-r--r-- | static/js/redirect.js | 2 | ||||
| -rw-r--r-- | static/usage.html | 39 |
2 files changed, 24 insertions, 17 deletions
diff --git a/static/js/redirect.js b/static/js/redirect.js index 1f8edead..177c60c5 100644 --- a/static/js/redirect.js +++ b/static/js/redirect.js @@ -21,11 +21,11 @@ const redirects = new Map([ ["/usage#sandboxed-play-services-installation", "/usage#sandboxed-google-play-installation"], ["/usage#sandboxed-play-services-limitations", "/usage#sandboxed-google-play-limitations"], ["/usage#google-camera", "/usage#pixel-camera"], + ["/usage#usb-peripherals", "/usage#usb-c-port-and-pogo-pins-control"], ["/faq#dns", "/faq#custom-dns"], ["/faq#when-devices", "/faq#future-devices"], - ["/features#usb-c-port-control", "/features#usb-c-port-and-pogo-pins-control"], ["/hiring#qualitifations", "/hiring#qualifications"], diff --git a/static/usage.html b/static/usage.html index 5cba227f..115af984 100644 --- a/static/usage.html +++ b/static/usage.html @@ -67,7 +67,7 @@ <li><a href="#updates-sideloading">Sideloading</a></li> </ul> </li> - <li><a href="#usb-peripherals">USB peripherals (Pixel 5a and earlier)</a></li> + <li><a href="#usb-c-port-and-pogo-pins-control">USB-C port and pogo pins control</a></li> <li><a href="#web-browsing">Web browsing</a></li> <li> <a href="#camera">Camera</a> @@ -523,26 +523,33 @@ </section> </section> - <section id="usb-peripherals"> - <h2><a href="#usb-peripherals">USB peripherals (Pixel 5a and earlier)</a></h2> + <section id="usb-c-port-and-pogo-pins-control"> + <h2><a href="#usb-c-port-and-pogo-pins-control">USB-C port and pogo pins control</a></h2> - <p>GrapheneOS defaults to ignoring connected USB peripherals when the device is - already booted and the screen is locked. A USB device already connected at boot will - still work. The purpose is reducing attack surface for a locked device with active - login sessions to user profiles to protect data that's not at rest. This can be - controlled in <b>Settings <span aria-label="and then">></span> - Security <span aria-label="and then">></span> USB peripherals</b>. The options - are:</p> + <p>Our <b>USB-C port and pogo pins</b> setting protects against attacks through + USB-C or pogo pins while the OS is booted. For the majority of devices without pogo + pins, the setting is labelled <b>USB-C port</b>.</p> + + <p>The setting is available in <b>Settings <span aria-label="and then">></span> + Security <span aria-label="and then">></span> Exploit protection</b>.</p> + + <p>The setting has five modes:</p> <ul> - <li>Disallow new USB peripherals</li> - <li>Allow new USB peripherals when unlocked (default)</li> - <li>Allow new USB peripherals (like stock Android)</li> + <li>Off</li> + <li>Charging-only</li> + <li>Charging-only when locked</li> + <li>Charging-only when locked, except before first unlock</li> + <li>On</li> </ul> - <p>This option has no impact on the device acting as a USB peripheral itself when - connected to a computer. Android defaults to charge only mode and requires opt-in - to the device being used for file transfer, USB tethering, MIDI or PTP.</p> + <p>The default is <b>Charging-only when locked</b>, which significantly reduces + attack surface when the device is locked. After locking, it blocks any new USB + connections immediately and disables USB data once any current connections end.</p> + + <p>For technical details on how this feature works using a combination of hardware + and software protection, see the <a href="/features#usb-c-port-and-pogo-pins-control">section + on the features page</a>.</p> </section> <section id="web-browsing"> |