From 5f34a1bc924578aeaa2b6d85ef3f3a6415d49ba6 Mon Sep 17 00:00:00 2001 From: Laurent Cozic Date: Fri, 28 Jun 2024 19:43:59 +0200 Subject: [PATCH] Doc: Add Multi-factor authentication guide --- readme/apps/mfa.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 readme/apps/mfa.md diff --git a/readme/apps/mfa.md b/readme/apps/mfa.md new file mode 100644 index 000000000..df48b7d2a --- /dev/null +++ b/readme/apps/mfa.md @@ -0,0 +1,45 @@ +# Multi-factor authentication + +Multi-Factor Authentication (MFA), also known as Two Factor Authentication (2FA), enhances your account security by requiring more than just a password to log in. + + +## How to enable MFA + +- [Access your profile](https://joplincloud.com/users/me) +- Go to the **Multi-factor authentication** section +- Click the link to **Enable Multi-Factor Authentication** +- Follow the instructions shown in the page + +## How to disable MFA + +- [Access your profile](https://joplincloud.com/users/me) +- Go to the **Multi-factor authentication** section +- Click the link **I want to disable it** and follow the instructions + +## Recovery codes + +When you enable MFA, Joplin Cloud will show you a list of codes that you should save somewhere safe. Each code can only be used once but you can generate new codes from your profile page. + +If you cannot generate your authentication codes because you have lost access to your smartphone, for example, you will need to use one of the recovery codes to login. + +## I forgot to copy my recovery codes, how do I find them? + +- [Access your profile](https://joplincloud.com/users/me) +- Go to the **Multi-factor authentication** section +- Click the **Recovery codes** link +- Follow the instructions shown in the page + +## How do I generate new recovery codes? + +- [Access your profile](https://joplincloud.com/users/me) +- Go to the **Multi-factor authentication** section +- Click the **Recovery codes** link +- After finishing the process you should see your list of recovery codes and a button at the bottom to generate new codes + +> The new codes will invalidate the old ones, so remember to save them. + +## How to login with my recovery code + +- Proceed to Joplin Cloud login page and follow the usual login process +- When prompted for an authentication code click in the link **Use a recovery code** bellow the input field +- Add your code to login