Skip to content

Commit 21a3dea

Browse files
joshuawalkerCopilotjules-p
authored
Update 2FA recovery language post-UX changes (#56832)
Co-authored-by: Copilot <[email protected]> Co-authored-by: Jules <[email protected]>
1 parent f13d84e commit 21a3dea

File tree

11 files changed

+61
-61
lines changed

11 files changed

+61
-61
lines changed

content/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/unlinking-your-email-address-from-a-locked-account.md

Lines changed: 8 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Unlinking your email address from a locked account
3-
intro: 'If you have lost your two-factor authentication (2FA) credentials and are unable to recover access, you can remove the connection between your email address and a 2FA locked account. The email address is then available for you to link it to a new or existing account, maintaining your commit history.'
3+
intro: 'If you have lost your two-factor authentication (2FA) credentials and are unable to recover access, you can remove the connection between your email address and a 2FA locked account.'
44
redirect_from:
55
- /early-access/account-and-profile/unlinking-your-email-address-from-a-locked-account
66
- /account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/unlinking-your-email-address-from-a-locked-account
@@ -26,30 +26,23 @@ Be aware that nothing else associated with your 2FA locked account, including yo
2626

2727
Unlinking email addresses is only available for accounts with 2FA enabled. If you do not have 2FA enabled, you can sign in and remove your email address from your account settings.
2828

29+
Educational benefits cannot be transferred after an email address is unlinked and associated with a different account. To keep these benefits, you must continue using the original account that was used to apply.
30+
2931
> [!WARNING]
30-
> Following these steps will not disable 2FA or provide access to a locked account, but will instead unlink the associated email address so it may be used for a different account. If you cannot regain access to the 2FA locked account, these steps will permanently break the link between the account and the linked email address. Before continuing with this article, be sure you have lost all access to your account. See [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/recovering-your-account-if-you-lose-your-2fa-credentials).
31-
>
32-
> Educational benefits and discounts cannot be transferred after an email address is unlinked and associated with a different account. To keep these benefits, you must continue using the original account that was used to apply.
32+
> Following these steps will not disable 2FA or provide access to a locked account, but will instead unlink the associated email address so it may be used for a different account. If you cannot regain access to the 2FA locked account, these steps will permanently break the link between the account and the linked email address. Before continuing, be sure you have lost all access to your account. See [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/recovering-your-account-if-you-lose-your-2fa-credentials).
3333
3434
### Unlinking with your password
3535

36-
If you know your password, you can sign in with your password to unlink your email address
36+
If you know your password, you can sign in with your password to unlink your email address.
3737

38-
1. Navigate to [https://github.com/login](https://github.com/login).
39-
1. To prompt two-factor authentication, type your username and password, then click **Sign in**.
40-
1. Under "Having problems?", click **Use a recovery code or begin 2FA account recovery**.
41-
1. Under "Locked out?", click **Try 2FA account recovery, or unlink your account email address(es)**.
42-
1. In the modal that appears, click **I understand, get started**.
43-
1. You may be required to verify an email address. To send an email containing a one-time password to each email address associated with your account, click **Send one-time password**.
44-
1. To verify your identity, type the one-time password from your email in the "One-time password" text field, then click **Verify email address**.
38+
{% data reusables.accounts.prompt-for-2fa-recovery-code %}
39+
{% data reusables.accounts.start-automated-recovery-with-password %}
4540
{% data reusables.accounts.unlinking-email-address %}
4641

4742
### Unlinking without your password
4843

4944
If you do not know your account password, you can request a password reset link to unlink your email address.
5045

5146
{% data reusables.accounts.request-password-reset-link %}
52-
53-
1. On {% data variables.product.prodname_dotcom %}, you will be prompted for your 2FA credentials. Under "Having problems?", click **Start a 2FA recovery request or unlink your account email address(es)**.
54-
1. In the modal that appears, click **I understand, get started**.
47+
{% data reusables.accounts.start-automated-recovery-without-password %}
5548
{% data reusables.accounts.unlinking-email-address %}

content/authentication/keeping-your-account-and-data-secure/updating-your-github-access-credentials.md

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Updating your GitHub access credentials
3-
intro: '{% data variables.product.github %} credentials include not only your password, but also the access tokens, SSH keys, and application API tokens you use to communicate with {% data variables.product.github %}. Should you have the need, you can reset all of these access credentials yourself.'
3+
intro: '{% data variables.product.github %} credentials include your password, access tokens, SSH keys, and application API tokens used to communicate with {% data variables.product.github %}. You can reset all of these access credentials yourself.'
44
redirect_from:
55
- /articles/rolling-your-credentials
66
- /articles/how-can-i-reset-my-password
@@ -27,18 +27,16 @@ shortTitle: Update access credentials
2727
{% data reusables.accounts.request-password-reset-link %}
2828

2929
1. If you have enabled two-factor authentication, you will be prompted for your 2FA credentials:
30-
{% ifversion fpt or ghec %}
31-
* If you have {% data variables.product.prodname_mobile %}, you will be sent a push notification to verify your identity. Open the push notification or the {% data variables.product.prodname_mobile %} app and enter the two-digit code shown to you on the password reset page in your browser.
32-
* To skip using {% data variables.product.prodname_mobile %} to verify, click **Enter two-factor authentication or recovery code**.
33-
{% endif %}
34-
* Type your authentication code or one of your recovery codes and click **Verify**.
35-
* If you have added a security key to your account, click **Use security key** instead of typing an authentication code.
36-
{% ifversion fpt or ghec %}
37-
* If you have set up [{% data variables.product.prodname_mobile %}](https://github.com/mobile), click **Authenticate with {% data variables.product.prodname_mobile %}** instead.
38-
{% endif %}
39-
{% ifversion 2fa-recovery-flow %}
40-
* If you've lost access to your two-factor authentication credentials and your recovery codes, you can start account recovery request. See [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/recovering-your-account-if-you-lose-your-2fa-credentials#recovering-without-your-password-or-two-factor-authentication-credentials).
41-
{% endif %}
30+
* If you have added a passkey or a security key to your account, click **Use passkey or security key**.
31+
{% ifversion fpt or ghec %}
32+
* If you have set up [{% data variables.product.prodname_mobile %}](https://github.com/mobile), you will be sent a push notification to verify your identity. If you didn't receive a notification, click "More options", then **Authenticate with {% data variables.product.prodname_mobile %}**.
33+
{% endif %}
34+
* Alternatively, type your TOTP or SMS authentication code, or one of your recovery codes, and click **Verify**.
35+
36+
{% ifversion 2fa-recovery-flow %}
37+
> [!NOTE]
38+
> If you've lost access to your two-factor authentication credentials and your recovery codes, you can start account recovery request. See [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/recovering-your-account-if-you-lose-your-2fa-credentials#recovering-without-your-password-or-two-factor-authentication-credentials).
39+
{% endif %}
4240
1. In the text field under **Password**, type a new password. Then, in the text field under **Confirm password**, type the password again.
4341
1. Click **Change password**. For help creating a strong password, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-strong-password).
4442

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

Lines changed: 19 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -29,12 +29,10 @@ shortTitle: Recover an account with 2FA
2929

3030
Use one of your recovery codes to automatically regain entry into your account. You may have saved your recovery codes to a password manager or your computer's downloads folder. The default filename for recovery codes is `github-recovery-codes.txt`. For more information about recovery codes, see [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication-recovery-methods#downloading-your-two-factor-authentication-recovery-codes).
3131

32-
1. Type your username and password to prompt authentication.
33-
34-
> [!NOTE]
35-
> If you do not know your password, you can use a recovery code after requesting a new password. See [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/updating-your-github-access-credentials#requesting-a-new-password).
32+
> [!NOTE]
33+
> If you do not know your password, you can use a recovery code after requesting a new password. See [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/updating-your-github-access-credentials#requesting-a-new-password).
3634
37-
1. Under "Having problems?," click **Use a recovery code{% ifversion fpt or ghec %} or begin 2FA account recovery{% endif %}**.
35+
{% data reusables.accounts.prompt-for-2fa-recovery-code %}
3836
1. Type one of your recovery codes, then click **Verify**.
3937

4038
## Authenticating with a passkey
@@ -63,43 +61,41 @@ If you know your password for {% data variables.product.prodname_dotcom %} but d
6361
6462
You can use your two-factor authentication credentials or two-factor authentication recovery codes to regain access to your account anytime during the 3-5 day waiting period.
6563

66-
1. Type your username and password to prompt authentication.
64+
> [!WARNING]
65+
> {% data reusables.accounts.you-must-know-your-password %}
6766
68-
> [!WARNING]
69-
> {% data reusables.accounts.you-must-know-your-password %}
67+
{% data reusables.accounts.prompt-for-2fa-recovery-code %}
68+
{% data reusables.accounts.start-automated-recovery-with-password %}
69+
{% data reusables.accounts.choose-recovery-verification-factor %}
7070

71-
1. Under "Having problems?," click **Use a recovery code or begin 2FA account recovery**.
72-
1. Under "Locked out?," click **Try 2FA account recovery, or unlink your account email address(es)**.
73-
1. Click **I understand, get started** to request a reset of your authentication settings.
74-
1. Click **Send one-time password** to send a one-time password to all eligible addresses associated with your account. Only verified emails are eligible for account recovery. If you've restricted password resets to your primary and/or backup addresses, these addresses are the only addresses eligible for account recovery.
75-
1. Under "One-time password," type the temporary password from the recovery email {% data variables.product.prodname_dotcom %} sent, then click **Verify email address**.
76-
1. {% data reusables.accounts.alternative-authentication %}
77-
{% data reusables.accounts.alternative-authentication-note %}
78-
1. {% data reusables.accounts.support-request-recovery %}
71+
{% data reusables.accounts.automated-recovery-review-period-notice %}
7972

8073
{% endif %}
8174

8275
{% ifversion 2fa-recovery-flow %}
8376

8477
## Recovering without your password
8578

86-
If you have forgotten your password, you can request a new password. During the password reset process, you can use one of your two-factor authentication credentials or a recovery code. See [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/updating-your-github-access-credentials#requesting-a-new-password).
79+
If you have forgotten your password, you can request a new password and recover your account during the password reset process.
80+
81+
### Using a two-factor authentication recovery code to reset your password
82+
83+
If you have your recovery codes, you can use them to complete the password reset process. See [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/updating-your-github-access-credentials#requesting-a-new-password).
8784

8885
### Recovering without your password or two-factor authentication credentials
8986

9087
If you have lost access to your two-factor authentication credentials and your recovery codes, you can start account recovery request. You'll need to verify your identity using a recovery authentication factor, such as an SSH key or previously verified device.
9188

9289
{% data reusables.accounts.request-password-reset-link %}
9390

94-
1. On {% data variables.product.prodname_dotcom %}, you will be prompted for your 2FA credentials. Under "Having problems?," click **Start a 2FA recovery request or unlink your account email address(es)**.
95-
1. To complete your recovery request, you'll need to verify an alternative authentication factor.
96-
{% data reusables.accounts.alternative-authentication %}
97-
{% data reusables.accounts.alternative-authentication-note %}
98-
1. {% data reusables.accounts.support-request-recovery %}
91+
{% data reusables.accounts.start-automated-recovery-without-password %}
92+
{% data reusables.accounts.choose-recovery-verification-factor %}
93+
94+
{% data reusables.accounts.automated-recovery-review-period-notice %}
9995

10096
## Unlinking your email address
10197

102-
If you have exhausted your recovery options, you can unlink your email address from your account. The email address is then available for you to link it to a new or existing account, maintaining your commit history. See [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/unlinking-your-email-address-from-a-locked-account#unlinking-without-your-password).
98+
If you have exhausted your recovery options, you can unlink your email address from your account. The email address is then available for you to link it to a new or existing account, maintaining your commit history. See [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/unlinking-your-email-address-from-a-locked-account).
10399

104100
{% endif %}
105101

data/reusables/accounts/alternative-authentication-note.md

Lines changed: 0 additions & 2 deletions
This file was deleted.

data/reusables/accounts/alternative-authentication.md

Lines changed: 0 additions & 4 deletions
This file was deleted.
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
A member of {% data variables.contact.github_support %} will review your request and email you within three business days. If your request is approved, you'll receive a link to complete your account recovery process. If your request is denied, the email will include a way to contact support with any additional questions.
1+
A member of {% data variables.contact.github_support %} will review your request and email you within three business days. If your request is approved, you'll receive a link to complete your account recovery process. If your request is denied, the email will include a way to contact support.
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
1. Choose a recovery verification factor.
2+
3+
* If you've used your current device to log into this account before and would like to use the device for verification, click **Verify with this device**.
4+
* If you've previously set up an SSH key on this account and would like to use the SSH key for verification, click **SSH key**.
5+
* If you've previously set up a {% data variables.product.pat_generic %} and would like to use the {% data variables.product.pat_generic %} for verification, click **{% data variables.product.pat_generic_caps %}**.
6+
7+
> [!NOTE]
8+
> For security reasons, an authentication factor may not be available for recovery, even if you've used that authentication method with the account before. For example, SSH keys are removed from accounts after a period of inactivity.
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
1. Navigate to [https://github.com/login](https://github.com/login).
2+
1. To prompt two-factor authentication, type your username and password, then click **Sign in**.
3+
> [!NOTE]
4+
> If you have linked a Google account to your {% data variables.product.prodname_dotcom %} account, you can sign-in with your social login instead of using your password.
5+
1. Under "More options", click **2FA recovery code**.
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
1. Under "More options", click **Begin account or email recovery**.
2+
1. In the modal that appears, click **I understand, get started**.
3+
1. You may be required to verify an email address. To send an email containing a one-time password to each email address associated with your account, click **Send one-time password**.
4+
> [!NOTE]
5+
> The one-time password will be sent to your primary and backup email addresses. Unless you have previously chosen a specific backup email address, all verified emails are considered backup email addresses.
6+
1. Type the one-time password from your email in the "One-time password" text field, then click **Verify email address**.
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
1. You will be prompted for your 2FA credentials. Under "More options", click **Begin account or email recovery**.
2+
1. In the modal that appears, click **I understand, get started**.

0 commit comments

Comments
 (0)