Skip to content

Commit

Permalink
Add device integrity/verification tools (#2315)
Browse files Browse the repository at this point in the history
Signed-off-by: Daniel Gray <dngray@privacyguides.org>
Signed-off-by: Freddy <freddy@privacyguides.org>
  • Loading branch information
jonaharagon authored and dngray committed Nov 12, 2023
1 parent d9ff083 commit d5a31c8
Show file tree
Hide file tree
Showing 24 changed files with 418 additions and 212 deletions.
350 changes: 175 additions & 175 deletions Pipfile.lock

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion config/mkdocs-common.yml
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@ theme:
- search.highlight

extra_css:
- assets/stylesheets/extra.css?v=3.15.0
- assets/stylesheets/extra.css?v=3.17.0
extra_javascript:
- assets/javascripts/mathjax.js

Expand Down
2 changes: 2 additions & 0 deletions config/mkdocs.en.yml
Original file line number Diff line number Diff line change
Expand Up @@ -126,6 +126,8 @@ nav:
- 'android.md'
- 'desktop.md'
- 'router.md'
- Advanced:
- 'device-integrity.md'
- About:
- 'about/index.md'
- 'about/criteria.md'
Expand Down
2 changes: 2 additions & 0 deletions config/mkdocs.es.yml
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,8 @@ nav:
- 'android.md'
- 'desktop.md'
- 'router.md'
- Advanced:
- 'device-integrity.md'
- Acerca de:
- 'about/index.md'
- 'about/criteria.md'
Expand Down
2 changes: 2 additions & 0 deletions config/mkdocs.fr.yml
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,8 @@ nav:
- 'android.md'
- 'desktop.md'
- 'router.md'
- "Advanced":
- 'device-integrity.md'
- "À propos":
- 'about/index.md'
- 'about/criteria.md'
Expand Down
2 changes: 2 additions & 0 deletions config/mkdocs.he.yml
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,8 @@ nav:
- 'android.md'
- 'desktop.md'
- 'router.md'
- "Advanced":
- 'device-integrity.md'
- "על אודות":
- 'about/index.md'
- 'about/criteria.md'
Expand Down
2 changes: 2 additions & 0 deletions config/mkdocs.it.yml
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,8 @@ nav:
- 'android.md'
- 'desktop.md'
- 'router.md'
- "Advanced":
- 'device-integrity.md'
- Informazioni:
- 'about/index.md'
- 'about/criteria.md'
Expand Down
2 changes: 2 additions & 0 deletions config/mkdocs.nl.yml
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,8 @@ nav:
- 'android.md'
- 'desktop.md'
- 'router.md'
- "Advanced":
- 'device-integrity.md'
- Over ons:
- 'about/index.md'
- 'about/criteria.md'
Expand Down
2 changes: 2 additions & 0 deletions config/mkdocs.ru.yml
Original file line number Diff line number Diff line change
Expand Up @@ -126,6 +126,8 @@ nav:
- 'android.md'
- 'desktop.md'
- 'router.md'
- Advanced:
- 'device-integrity.md'
- О сайте:
- 'about/index.md'
- 'about/criteria.md'
Expand Down
2 changes: 2 additions & 0 deletions config/mkdocs.zh-Hant.yml
Original file line number Diff line number Diff line change
Expand Up @@ -126,6 +126,8 @@ nav:
- 'android.md'
- 'desktop.md'
- 'router.md'
- Advanced:
- 'device-integrity.md'
- 關於:
- 'about/index.md'
- 'about/criteria.md'
Expand Down
34 changes: 0 additions & 34 deletions docs/android.md
Original file line number Diff line number Diff line change
Expand Up @@ -216,40 +216,6 @@ We recommend a wide variety of Android apps throughout this site. The apps liste

When using Shelter, you are placing complete trust in its developer, as Shelter acts as a [Device Admin](https://developer.android.com/guide/topics/admin/device-admin) to create the Work Profile, and it has extensive access to the data stored within the Work Profile.

### Auditor

!!! recommendation

![Auditor logo](assets/img/android/auditor.svg#only-light){ align=right }
![Auditor logo](assets/img/android/auditor-dark.svg#only-dark){ align=right }

**Auditor** is an app which leverages hardware security features to provide device integrity monitoring by actively validating the identity of a device and the integrity of its operating system. Currently, it only works with GrapheneOS or the stock operating system for [supported devices](https://attestation.app/about#device-support).

[:octicons-home-16: Homepage](https://attestation.app){ .md-button .md-button--primary }
[:octicons-eye-16:](https://attestation.app/privacy-policy){ .card-link title="Privacy Policy" }
[:octicons-info-16:](https://attestation.app/about){ .card-link title=Documentation}
[:octicons-code-16:](https://attestation.app/source){ .card-link title="Source Code" }
[:octicons-heart-16:](https://attestation.app/donate){ .card-link title=Contribute }

??? downloads

- [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=app.attestation.auditor.play)
- [:simple-github: GitHub](https://github.com/GrapheneOS/Auditor/releases)
- [:material-cube-outline: GrapheneOS App Store](https://github.com/GrapheneOS/Apps/releases)

Auditor performs attestation and intrusion detection by:

- Using a [Trust On First Use (TOFU)](https://en.wikipedia.org/wiki/Trust_on_first_use) model between an *auditor* and *auditee*, the pair establish a private key in the [hardware-backed keystore](https://source.android.com/security/keystore/) of the *Auditor*.
- The *auditor* can either be another instance of the Auditor app or the [Remote Attestation Service](https://attestation.app).
- The *auditor* records the current state and configuration of the *auditee*.
- Should tampering with the operating system of the *auditee* happen after the pairing is complete, the auditor will be aware of the change in the device state and configurations.
- You will be alerted to the change.

No personally identifiable information is submitted to the attestation service. We recommend that you sign up with an anonymous account and enable remote attestation for continuous monitoring.

If your [threat model](basics/threat-modeling.md) requires privacy, you could consider using [Orbot](tor.md#orbot) or a VPN to hide your IP address from the attestation service.
To make sure that your hardware and operating system is genuine, [perform local attestation](https://grapheneos.org/install/web#verifying-installation) immediately after the device has been installed and prior to any internet connection.

### Secure Camera

!!! recommendation
Expand Down
Loading

2 comments on commit d5a31c8

@privacyguides-bot
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This commit has been mentioned on Privacy Guides. There might be relevant details there:

https://discuss.privacyguides.net/t/iverify-ios-device-scanning-tool/14579/30

@privacyguides-bot
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This commit has been mentioned on Privacy Guides. There might be relevant details there:

https://discuss.privacyguides.net/t/hypatia-android-anti-malware/14755/7

Please sign in to comment.