Improve 2 factor authentication (2FA) content [HC-1416] (#396)

* 2FA content fix * Grammar and structure changes * Last fixes * Shortened article titles * Add note with link to recovery article * Apply suggestions from code review Co-authored-by: seaxwi <[email protected]> * added drop shadow to images * Update content/About Arduino/My Arduino Account/Enable-2-Step-Verification-for-your-Arduino-account.md Co-authored-by: seaxwi <[email protected]> --------- Co-authored-by: seaxwi <[email protected]>
arduino · Aug 19, 2024 · 188119a · 188119a
1 parent 2213a35
commit 188119a
Show file tree

Hide file tree

Showing 18 changed files with 133 additions and 72 deletions.
diff --git a/...uino/My Arduino Account/Disable-2-Step-Verification-for-your-Arduino-account.md b/...uino/My Arduino Account/Disable-2-Step-Verification-for-your-Arduino-account.md
@@ -0,0 +1,25 @@
+---
+title: "Disable 2-Step Verification for your Arduino account"
+id: 360016759779
+---
+
+If you need to change your mobile device or perform a factory reset, you can disable 2-Step Verification for your Arduino account.
+
+> [!IMPORTANT]
+> To disable 2-Step Verification, you need to sign into your Arduino account. If you've lost access, see [Recover an account protected by 2-Step Verification](https://support.arduino.cc/hc/en-us/articles/360022029299).
+
+---
+
+1. Go to your [Arduino account profile](https://id.arduino.cc/).
+
+2. Click on **Disable** under the Security section. A message will be displayed stating that you will receive an email. It will send the email to the address listed in the account settings section.
+
+   ![Security section highlighted in the profile page](img/2factorAuth1.png)
+
+3. Check your email for a message with the subject **Disable Arduino 2-step verification**. Click the link.
+
+   !["Disable Arduino 2-step verification" email containing deactivation link](img/2factorAuth2.png)
+
+4. After clicking on the link, 2-step verification will be disabled.
+
+   !["The Two Factor authentication has been successfully disabled" written in profile page](img/2factorAuth3.png)
diff --git a/...duino/My Arduino Account/Enable-2-Step-Verification-for-your-Arduino-account.md b/...duino/My Arduino Account/Enable-2-Step-Verification-for-your-Arduino-account.md
@@ -0,0 +1,54 @@
+---
+title: "Enable 2-Step Verification for your Arduino account"
+id: 360018131120
+---
+
+By enabling 2-Step Verification for your Arduino account, you add an extra layer of security in case your password is stolen.
+
+---
+
+## About authenticator apps
+
+To use 2-step Verification, you will need an authenticator or password manager app with time-based one-time password (TOTP) support.
+
+These are some popular choices:
+
+* 1Password
+* Twilio Authy
+* Google Authenticator
+* Microsoft Authenticator
+* LastPass
+
+## Enable 2-Step Verification
+
+1. Log in to your account and go to [your profile](https://id.arduino.cc/).
+
+1. In the Security section, find the 2-Step Verification option and click on **Activate**.
+
+   ![Security section highlighted in the profile page](img/Profile_Security.png)
+
+1. Open your preferred authenticator app (e.g., Authy, Google Authenticator, Microsoft Authenticator).
+
+1. A window will display a QR code. This code is used to configure your account with an authenticator app.
+
+   ![QR code for configuration of Authenticator app](img/2FA_QRcode.png)
+
+   Add a new account in the authenticator app and scan the QR code displayed in the window and click **Next**.
+
+   > [!TIP]
+   > If you can't scan the QR code, click "Can't scan the barcode?" to view the code in text format. Save this code as a one-time password for Arduino in your authenticator app.
+
+1. Your authenticator app will generate a **six-digit code** that changes every 30 seconds. Enter this code into the text field in the window and click **Verify**.
+
+   ![Code box for configuration of Authenticator app](img/2FA_6digits.png)
+
+1. The window will now display a **Recovery Code**. Save this code in a secure location.
+
+   ![Recovery code written in code box and "I have safely recorded this code" check box](img/2FA_recoveryCode.png)
+
+   You will need the recovery code if you lose access to your authenticator app, such as if your phone is lost or broken.
+
+   > [!IMPORTANT]
+   > If you lose access to both your authenticator app and the recovery code, you will not be able to access your Arduino account, and Arduino support will be unable to assist you.
+
+1. Enter the code from your authenticator app one more time to complete the setup.
diff --git a/... Account/How-to-disable-the-two-steps-authentication-for-the-Arduino-account.md b/... Account/How-to-disable-the-two-steps-authentication-for-the-Arduino-account.md
diff --git a/...o Account/How-to-enable-the-two-steps-authentication-on-your-Arduino-account.md b/...o Account/How-to-enable-the-two-steps-authentication-on-your-Arduino-account.md
diff --git a/...cess-to-my-2-factor-authentication-app-how-do-I-log-in-to-my-Arduino-account.md b/...cess-to-my-2-factor-authentication-app-how-do-I-log-in-to-my-Arduino-account.md
diff --git a/...duino/My Arduino Account/Recover-an-account-protected-by-2-Step-Verification.md b/...duino/My Arduino Account/Recover-an-account-protected-by-2-Step-Verification.md
@@ -0,0 +1,54 @@
+---
+title: "Recover an account protected by 2-Step Verification"
+id: 360022029299
+---
+
+When you enable 2-Step Verification on your Arduino account, you're given a 24-digit recovery code. This code is crucial for accessing your account if you lose your verification app.
+
+## How to locate your recovery code
+
+If you downloaded the file when you received your recovery code, it should be named 'Arduino 2-step verification recovery code'.
+
+The easiest way to find your recovery code file is by searching for it across your computer.
+
+**Windows:**
+
+1. Open File Explorer by clicking the folder icon on your taskbar or press `Windows + E`.
+
+1. In the left sidebar, select **This PC** to search your entire computer.
+
+1. Type **Arduino 2 step verification recovery code** in the search box in the upper right corner of the File Explorer window and press Enter.
+
+1. Wait for Windows to complete the search and display the results.
+
+**Mac:**
+
+1. Click on the Spotlight icon (a magnifying glass) in the upper-right corner of your screen or press `Command + Space`.
+
+1. Type **Arduino 2 step verification recovery code**.
+
+1. Spotlight will display a list of matching files from your entire Mac.
+
+## How do I use my recovery code?
+
+1. Log into your Arduino account.
+
+1. When prompted for 2-Step Verification, click 'Use recovery code'.
+
+   ![2-step verification dialog with use recovery code button](img/Use_recovery_code.png)
+
+1. Enter your recovery code in the provided field.
+
+   ![2-step verification dialog to input recovery code](img/recovery_code_input.png)
+
+1. Save your new recovery code in a safe place.
+
+   ![Dialog box with new recovery code](img/New_recovery_code.png)
+
+1. Check the box confirming 'I have safely recorded this code'.
+
+1. Now that you've logged in, you should reset the 2-step verification by [removing the old connection](https://support.arduino.cc/hc/en-us/articles/360016759779) and [adding a new one](https://support.arduino.cc/hc/en-us/articles/360018131120).
+
+## What should I do if I can't find my recovery code?
+
+If you can't find your recovery code, you must create a new account, as your previous one will no longer be accessible. We do not have any means to provide a new code or access to the old account.
diff --git a/content/About Arduino/My Arduino Account/img/2FA_6digits.png b/content/About Arduino/My Arduino Account/img/2FA_6digits.png
diff --git a/content/About Arduino/My Arduino Account/img/2FA_QRcode.png b/content/About Arduino/My Arduino Account/img/2FA_QRcode.png
diff --git a/content/About Arduino/My Arduino Account/img/2FA_recoveryCode.png b/content/About Arduino/My Arduino Account/img/2FA_recoveryCode.png
diff --git a/content/About Arduino/My Arduino Account/img/2FA_success.png b/content/About Arduino/My Arduino Account/img/2FA_success.png
diff --git a/content/About Arduino/My Arduino Account/img/2factorAuth1.png b/content/About Arduino/My Arduino Account/img/2factorAuth1.png
diff --git a/content/About Arduino/My Arduino Account/img/2factorAuth2.png b/content/About Arduino/My Arduino Account/img/2factorAuth2.png
diff --git a/content/About Arduino/My Arduino Account/img/2factorAuth3.png b/content/About Arduino/My Arduino Account/img/2factorAuth3.png
diff --git a/content/About Arduino/My Arduino Account/img/Lost2FA.png b/content/About Arduino/My Arduino Account/img/Lost2FA.png
diff --git a/content/About Arduino/My Arduino Account/img/New_recovery_code.png b/content/About Arduino/My Arduino Account/img/New_recovery_code.png
diff --git a/content/About Arduino/My Arduino Account/img/Profile_Security.png b/content/About Arduino/My Arduino Account/img/Profile_Security.png
diff --git a/content/About Arduino/My Arduino Account/img/Use_recovery_code.png b/content/About Arduino/My Arduino Account/img/Use_recovery_code.png
diff --git a/content/About Arduino/My Arduino Account/img/recovery_code_input.png b/content/About Arduino/My Arduino Account/img/recovery_code_input.png