[fractal] docs: Improve explanation of how credentials are stored
- From: Julian Sparber <jsparber src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [fractal] docs: Improve explanation of how credentials are stored
- Date: Mon, 26 Sep 2022 13:41:08 +0000 (UTC)
commit d6024184c02154209fc799924e84fcbfcd7561b9
Author: Julian Sparber <julian sparber net>
Date: Mon Sep 26 13:41:07 2022 +0000
docs: Improve explanation of how credentials are stored
README.md | 15 ++++++++++++---
1 file changed, 12 insertions(+), 3 deletions(-)
---
diff --git a/README.md b/README.md
index f62609d7c..35f562188 100644
--- a/README.md
+++ b/README.md
@@ -84,9 +84,18 @@ flatpak install --user gnome-nightly org.gnome.Fractal.Devel
### Runtime Dependencies
Fractal doesn't store your **password** but uses [Secret
Service](https://www.freedesktop.org/wiki/Specifications/secret-storage-spec/)
-to store your other **credentials** so you should have something providing that service on your
-system. If you're using GNOME or KDE this should work for you out of the box with gnome-keyring or
-ksecretservice.
+to store your **access token** and **passphrase** used to encrypt the local cache.
+Therefore, you need to have software providing that service on your system.
+If you're using GNOME this should work for you out of the box and gnome-keyring or ksecretservice
+should already be installed and setup.
+
+## Security Best Practices
+
+Additionally to setting up the [Secret
Service](https://www.freedesktop.org/wiki/Specifications/secret-storage-spec/),
+make sure to use a strong **password** for the keyring, or for the user session if used to unlock the keyring
+(normally it's the case), since it will be used to encrypt secrets in **Secret Service**.
+Furthermore, make sure to lock your system when stepping away from the computer since an unlocked computer
+gives other people access to your private communications and stored secrets.
## Contributing
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]