Skip to content

Commit ae86c16

Browse files
sabrowning1github-actionsisaacmbrownzacharysierakowski
authored
Add content for inline updates to 2FA settings (github#34230)
Co-authored-by: github-actions <[email protected]> Co-authored-by: Isaac Brown <[email protected]> Co-authored-by: Zachary Sierakowski <[email protected]>
1 parent 4ae6bb4 commit ae86c16

11 files changed

+66
-55
lines changed

Diff for: assets/images/help/2fa/2fa-switching-methods.png

-10.3 KB
Binary file not shown.
57.3 KB
Loading
-9.42 KB
Binary file not shown.

Diff for: content/authentication/securing-your-account-with-two-factor-authentication-2fa/accessing-github-using-two-factor-authentication.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ After you sign in to {% data variables.product.product_name %} using your passwo
3939

4040
If you chose to set up two-factor authentication using a TOTP application on your smartphone, you can generate an authentication code for {% data variables.product.product_name %} at any time. In most cases, just launching the application will generate a new code. You should refer to your application's documentation for specific instructions.
4141

42-
If you delete your authenticator application after configuring two-factor authentication, you'll need to provide your recovery code to get access to your account. Many TOTP apps support the secure backup of your authentication codes in the cloud and can be restored if you lose access to your device. For more information, see "[Recovering your account if you lose your two-factor authentication credentials](/articles/recovering-your-account-if-you-lose-your-2fa-credentials)"
42+
If you delete your authenticator application after configuring two-factor authentication, you'll need to provide your recovery code to get access to your account. Many TOTP apps support the secure backup of your authentication codes in the cloud and can be restored if you lose access to your device. For more information, see "[Recovering your account if you lose your two-factor authentication credentials](/articles/recovering-your-account-if-you-lose-your-2fa-credentials)."
4343

4444
{% ifversion fpt or ghec %}
4545

Diff for: content/authentication/securing-your-account-with-two-factor-authentication-2fa/changing-two-factor-authentication-delivery-methods-for-your-mobile-device.md

-35
This file was deleted.
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
title: Changing your preferred two-factor authentication method
3+
intro: You can switch your preferred two-factor authentication (2FA) method to complete 2FA prompts with the newly selected method.
4+
redirect_from:
5+
- /articles/changing-two-factor-authentication-delivery-methods
6+
- /articles/changing-two-factor-authentication-delivery-methods-for-your-mobile-device
7+
- /github/authenticating-to-github/changing-two-factor-authentication-delivery-methods-for-your-mobile-device
8+
- /github/authenticating-to-github/securing-your-account-with-two-factor-authentication-2fa/changing-two-factor-authentication-delivery-methods-for-your-mobile-device
9+
- /authentication/securing-your-account-with-two-factor-authentication-2fa/changing-two-factor-authentication-delivery-methods-for-your-mobile-device
10+
versions:
11+
feature: 2fa-reconfiguration-inline-update
12+
topics:
13+
- 2FA
14+
shortTitle: Change 2FA method
15+
---
16+
17+
{% note %}
18+
19+
**Note:** You can reconfigure your 2FA settings without disabling 2FA entirely, allowing you to keep both your recovery codes and your membership in organizations that require 2FA.
20+
21+
{% endnote %}
22+
23+
{% data reusables.user-settings.access_settings %}
24+
{% data reusables.user-settings.security %}
25+
1. In "Two-factor methods", find the method you want to set as your preferred 2FA method. Next to that method, select {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Set as preferred method**.
26+
![Screenshot of the "Set as preferred method" button in the 2FA settings](/assets/images/help/2fa/change-preferred-2fa-method.png)
27+
28+
A "Preferred" label is displayed next to the name of your preferred method.
29+
30+
## Further reading
31+
32+
- "[Configuring two-factor authentication](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication)"
33+
- "[Configuring two-factor authentication recovery methods](/articles/configuring-two-factor-authentication-recovery-methods)"

Diff for: content/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication-recovery-methods.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -28,12 +28,12 @@ To keep your account secure, don't share or distribute your recovery codes. We r
2828
- [1Password](https://1password.com/)
2929
- [LastPass](https://lastpass.com/)
3030

31-
If you generate new recovery codes or disable and re-enable 2FA, the recovery codes in your security settings automatically update.
31+
If you generate new recovery codes or disable and re-enable 2FA, the recovery codes in your security settings automatically update.{% ifversion 2fa-reconfiguration-inline-update %} Reconfiguring your 2FA settings without disabling 2FA will not change your recovery codes.{% endif %}
3232

3333
{% data reusables.user-settings.access_settings %}
3434
{% data reusables.user-settings.security %}
3535
{% data reusables.two_fa.show-recovery-codes %}
36-
4. Save your recovery codes in a safe place. Your recovery codes can help you get back into your account if you lose access.
36+
1. Save your recovery codes in a safe place. Your recovery codes can help you get back into your account if you lose access.
3737
- To save your recovery codes on your device, click **Download**.
3838
- To save a hard copy of your recovery codes, click **Print**.
3939
- To copy your recovery codes for storage in a password manager, click **Copy**.
@@ -57,7 +57,7 @@ You can set up a security key as a secondary two-factor authentication method, a
5757

5858
## Setting a fallback authentication number
5959

60-
You can provide a second number for a fallback device. If you lose access to both your primary device and your recovery codes, a backup SMS number can get you back in to your account.
60+
You can provide a second number for a fallback device. If you lose access to both your preferred device and your recovery codes, a backup SMS number can get you back in to your account.
6161

6262
You can use a fallback number regardless of whether you've configured authentication via text message or TOTP mobile application.
6363

@@ -71,11 +71,11 @@ You can use a fallback number regardless of whether you've configured authentica
7171

7272
{% data reusables.user-settings.access_settings %}
7373
{% data reusables.user-settings.security %}
74-
3. Next to "Fallback SMS number", click **Add**.
74+
1. Next to "Fallback SMS number", click **Add**.
7575
![Add fallback SMS number button](/assets/images/help/2fa/add-fallback-sms-number-button.png)
76-
4. Under "Fallback SMS number", click **Add fallback SMS number**.
76+
1. Under "Fallback SMS number", click **Add fallback SMS number**.
7777
![Add fallback SMS number text](/assets/images/help/2fa/add_fallback_sms_number_text.png)
78-
5. Select your country code and type your mobile phone number, including the area code. When your information is correct, click **Set fallback**.
78+
1. Select your country code and type your mobile phone number, including the area code. When your information is correct, click **Set fallback**.
7979
![Set fallback SMS number](/assets/images/help/2fa/2fa-fallback-number.png)
8080

8181
After setup, the backup device will receive a confirmation SMS.

Diff for: content/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication.md

+15-7
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,14 @@ If you're a member of an {% data variables.enterprise.prodname_emu_enterprise %}
3939

4040
{% endwarning %}
4141

42+
{% ifversion 2fa-reconfiguration-inline-update %}
43+
{% note %}
44+
45+
**Note:** You can reconfigure your 2FA settings without disabling 2FA entirely, allowing you to keep both your recovery codes and your membership in organizations that require 2FA.
46+
47+
{% endnote %}
48+
{% endif %}
49+
4250
## Configuring two-factor authentication using a TOTP mobile app
4351

4452
A time-based one-time password (TOTP) application automatically generates an authentication code that changes after a certain period of time. We recommend using cloud-based TOTP apps such as:
@@ -81,7 +89,7 @@ A time-based one-time password (TOTP) application automatically generates an aut
8189

8290
## Configuring two-factor authentication using text messages
8391

84-
If you're unable to authenticate using a TOTP mobile app, you can authenticate using SMS messages. You can also provide a second number for a fallback device. If you lose access to both your primary device and your recovery codes, a backup SMS number can get you back in to your account.
92+
If you're unable to authenticate using a TOTP mobile app, you can authenticate using SMS messages. You can also provide a second number for a fallback device. If you lose access to both your preferred device and your recovery codes, a backup SMS number can get you back in to your account.
8593

8694
Before using this method, be sure that you can receive text messages. Carrier rates may apply.
8795

@@ -94,7 +102,7 @@ Before using this method, be sure that you can receive text messages. Carrier ra
94102
{% data reusables.user-settings.access_settings %}
95103
{% data reusables.user-settings.security %}
96104
{% data reusables.two_fa.enable-two-factor-authentication %}
97-
4. Below "Setup authenticator app", select **SMS authentication**
105+
1. Below "Setup authenticator app", select **SMS authentication**
98106

99107
![2FA SMS alternative option](/assets/images/help/2fa/2fa_sms_alt_option.png)
100108

@@ -122,15 +130,15 @@ Authentication with a security key is *secondary* to authentication with a TOTP
122130
2. Ensure that you have a WebAuthn compatible security key inserted into your computer.
123131
{% data reusables.user-settings.access_settings %}
124132
{% data reusables.user-settings.security %}
125-
5. Next to "Security keys", click **Add**.
133+
1. Next to "Security keys", click **Add**.
126134
![Add security keys option](/assets/images/help/2fa/add-security-keys-option.png)
127-
6. Under "Security keys", click **Register new security key**.
135+
1. Under "Security keys", click **Register new security key**.
128136
![Registering a new security key](/assets/images/help/2fa/security-key-register.png)
129-
7. Type a nickname for the security key, then click **Add**.
137+
1. Type a nickname for the security key, then click **Add**.
130138
![Providing a nickname for a security key](/assets/images/help/2fa/security-key-nickname.png)
131-
8. Activate your security key, following your security key's documentation.
139+
1. Activate your security key, following your security key's documentation.
132140
![Prompt for a security key](/assets/images/help/2fa/security-key-prompt.png)
133-
9. Confirm that you've downloaded and can access your recovery codes. If you haven't already, or if you'd like to generate another set of codes, download your codes and save them in a safe place. For more information, see "[Downloading your 2FA recovery codes](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication-recovery-methods#downloading-your-two-factor-authentication-recovery-codes)."
141+
1. Confirm that you've downloaded and can access your recovery codes. If you haven't already, or if you'd like to generate another set of codes, download your codes and save them in a safe place. For more information, see "[Downloading your 2FA recovery codes](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication-recovery-methods#downloading-your-two-factor-authentication-recovery-codes)."
134142
{% ifversion ghes < 3.9 %}{% data reusables.two_fa.test_2fa_immediately %}{% endif %}
135143

136144
{% ifversion fpt or ghec %}

Diff for: content/authentication/securing-your-account-with-two-factor-authentication-2fa/index.md

+1-2
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,8 @@ children:
1818
- /configuring-two-factor-authentication-recovery-methods
1919
- /accessing-github-using-two-factor-authentication
2020
- /recovering-your-account-if-you-lose-your-2fa-credentials
21-
- /changing-two-factor-authentication-delivery-methods-for-your-mobile-device
21+
- /changing-your-preferred-two-factor-authentication-method
2222
- /countries-where-sms-authentication-is-supported
2323
- /disabling-two-factor-authentication-for-your-personal-account
2424
shortTitle: Secure your account with 2FA
2525
---
26-

Diff for: content/authentication/securing-your-account-with-two-factor-authentication-2fa/recovering-your-account-if-you-lose-your-2fa-credentials.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ shortTitle: Recover an account with 2FA
1919

2020
{% warning %}
2121

22-
**Warnings**:
22+
**Warnings**:
2323

2424
- {% data reusables.two_fa.support-may-not-help %}
2525

@@ -42,7 +42,7 @@ Use one of your recovery codes to automatically regain entry into your account.
4242
{% warning %}
4343

4444
**Warning**: {% data reusables.accounts.you-must-know-your-password %}
45-
45+
4646
{% endwarning %}
4747

4848
{% ifversion fpt or ghec %}
@@ -60,7 +60,7 @@ Use one of your recovery codes to automatically regain entry into your account.
6060
{% ifversion fpt or ghec %}
6161
## Authenticating with a fallback number
6262

63-
If you lose access to your primary TOTP app or phone number, you can provide a two-factor authentication code sent to your fallback number to automatically regain access to your account.
63+
If you lose access to your preferred TOTP app or phone number, you can provide a two-factor authentication code sent to your fallback number to automatically regain access to your account.
6464
{% endif %}
6565

6666
## Authenticating with a security key
@@ -85,7 +85,7 @@ You can use your two-factor authentication credentials or two-factor authenticat
8585
{% warning %}
8686

8787
**Warning**: {% data reusables.accounts.you-must-know-your-password %}
88-
88+
8989
{% endwarning %}
9090
1. Under "Having problems?", click **Use a recovery code or request a reset**.
9191

Diff for: data/features/2fa-reconfiguration-inline-update.yml

+6
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
# Reference: #9087
2+
3+
versions:
4+
fpt: '*'
5+
ghec: '*'
6+
ghes: '> 3.8'

0 commit comments

Comments
 (0)