From f098f40e6f8776f199c8a8967aed86a8ba3973d1 Mon Sep 17 00:00:00 2001 From: akc3n Date: Sun, 15 Oct 2023 17:01:00 -0700 Subject: [PATCH] Update README.md Add more info and proper structure. Signed-off-by: akc3n --- README.md | 42 ++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 40 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 33c12e3..137f47f 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,41 @@ -# Banking Apps Compatibility Reports +# Banking apps compatibility with GrapheneOS -This repository is for reporting banking app compatibility with GrapheneOS only. If you want to suggest edits on the website, please do so in the [`PrivSec-dev/privsec.dev`](https://github.com/PrivSec-dev/privsec.dev) repository. +Report and track international banking app compatibility with GrapheneOS, including which workarounds may be required. +## Tablet of Contents + +- [Introduction](#introduction) +- [Usage](#usage) +- [Workarounds](#workarounds) +- [Notes](#notes) +# Introduction + +A crowd-sourced project dataset for [GrapheneOS](https://grapheneos.org/) users on [supported devices](https://grapheneos.org/faq#supported-devices), featuring a maintained compatibility [list of tested international banking apps](https://privsec.dev/posts/android/banking-applications-compatibility-with-grapheneos/#international-banking-apps), which is [reviewed](https://github.com/PrivSec-dev/banking-apps-compat-report/issues?q=is%3Aissue+is%3Aclosed) and [published](https://privsec.dev/banking). + +[PrivSec.dev](https://privsec.dev) hosts this 3rd-party community-sourced effort, offering detailed information and which[ workarounds](https://akc3n.page/posts/banking-app-issues/) may be required for banking apps compatibility with GrapheneOS. +## It is essential to note that GrapheneOS: +- **[does not](https://grapheneos.org/usage#banking-apps:~:text=grapheneos%20does%20not%20make%20any%20guarantees%20regarding%20the%20list's%20validity.) make any guarantees regarding the list's validity** +- users should read the [banking apps usage guide](https://grapheneos.org/usage#banking-apps) +- provides a detailed [attestation compatibility guide](https://grapheneos.org/articles/attestation-compatibility-guide) for banking app developers +# Usage + +- View [current list ](https://privsec.dev/posts/android/banking-applications-compatibility-with-grapheneos/#international-banking-apps)of working international banking apps compatibility with GrapheneOS. +- See [issue tracker](https://github.com/PrivSec-dev/banking-apps-compat-report/issues) for detailed banking app reports. As well as search, track, and/or update report status. +- Submit a banking app report by [opening a new issue and filling out the form](https://github.com/PrivSec-dev/banking-apps-compat-report/issues/new?assignees=&labels=app+report&projects=&template=app_report.yml&title=%5BReplace+this+with+the+name+of+your+banking+app%5D). +# Workarounds + +## Native code debugging +[Have you disabled native debugging](https://grapheneos.org/usage#banking-apps:~:text=grapheneos%20allows%20users%20to%20disable%20native%20code%20debugging)? Turn it back on and see if that may help. + +Enable native code debugging +`Owner profile` → `Settings` → `Security` → `Enable native code debugging` +## Exploit protection compatibility mode +[Have you tried enabling exploit protection compatibility mode for the app](https://grapheneos.org/usage#bugs-uncovered-by-security-features)? It could have memory corruption bugs may requiring this. + +Enable exploit protection compatibility mode +`Settings` → `Apps` → `` → `Advanced` → `Enable exploit protection compatibility` +## AuroraOSS is problematic +Have you installed it from the [Sandboxed Play Store](https://grapheneos.org/usage#sandboxed-google-play) or another app? +See [detailed info](https://akc3n.page/posts/banking-app-issues/#auroraoss-is-problematic) on problems using [another app](https://twitter.com/GrapheneOS/status/1712962862832865456#m) for downloading banking apps. +# Notes + +This repository is for reporting, tracking, and updating the status of banking app compatibility with GrapheneOS only. If you want to suggest [edits](https://github.com/PrivSec-dev/privsec.dev/blob/main/content/posts/android/Banking%20Applications%20compatibility%20with%20GrapheneOS.md) on the [banking apps web page](https://privsec.dev/posts/android/banking-applications-compatibility-with-grapheneos/), which are unrelated to the reports, please use [`PrivSec-dev/privsec.dev`](https://github.com/PrivSec-dev/privsec.dev/)'s repository [issue-tracker](https://github.com/PrivSec-dev/privsec.dev/issues).