Skip to content

Commit 2d2ad59

Browse files
N-UshafrancisfuzzsubatoiCopilotcandyho
authored
Update about-authentication-to-github.md (#56532)
Co-authored-by: francisfuzz <[email protected]> Co-authored-by: Ben Ahmady <[email protected]> Co-authored-by: Copilot <[email protected]> Co-authored-by: Candy Ho <[email protected]> Co-authored-by: Kevin Heis <[email protected]> Co-authored-by: sunbrye <[email protected]>
1 parent 6457d10 commit 2d2ad59

File tree

4 files changed

+30
-4
lines changed

4 files changed

+30
-4
lines changed

content/authentication/keeping-your-account-and-data-secure/about-authentication-to-github.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ To keep your account secure, you must authenticate before you can access certain
2020
You can access your resources in {% data variables.product.github %} in a variety of ways: in the browser, via {% data variables.product.prodname_desktop %} or another desktop application, with the API, or via the command line. Each way of accessing {% data variables.product.github %} supports different modes of authentication.
2121
{%- ifversion not fpt %}
2222
* Your identity provider (IdP){% endif %}
23-
* Username and password with two-factor authentication, or a passkey
23+
* Username and password (or social login) with two-factor authentication, or a passkey ({% data variables.product.prodname_free_user %}, and {% data variables.product.prodname_ghe_cloud %} only)
2424
* {% data variables.product.pat_generic_caps %}
2525
* SSH key
2626

@@ -46,9 +46,13 @@ If you need to use multiple accounts on {% data variables.location.product_locat
4646

4747
* **Username and password only**
4848
* You'll create a password when you create your account on {% data variables.product.github %}. We recommend that you use a password manager to generate a random and unique password. For more information, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-strong-password).{% ifversion fpt or ghec %}
49-
* If you have not enabled 2FA, {% data variables.product.github %} may ask for additional verification when you first sign in from a new or unrecognized device, such as a new browser profile, a browser where the cookies have been deleted, or a new computer. For more information, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/verifying-new-devices-when-signing-in).{% endif %}
49+
* If you have not enabled 2FA, {% data variables.product.github %} may ask for additional verification when you first sign in from a new or unrecognized device, such as a new browser profile, a browser where the cookies have been deleted, or a new computer. For more information, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/verifying-new-devices-when-signing-in).{% endif %} {% ifversion fpt or ghec %}
50+
* **Social login**
51+
* You'll authenticate with one of the supported social login providers (currently only Google is supported) when you create your account on {% data variables.product.github %}. We recommend that you also configure 2FA and add a passkey or a password as an additional account recovery mechanism.
52+
* If you have an existing account created with a password, you can add your social login email to the account. This allows you to use your social login identity as a first-factor (password) replacement when you sign in to {% data variables.product.github %}.
53+
* You can unlink your social login identities from your {% data variables.product.github %} email settings page. For more information, 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) {% endif %}
5054
* **Two-factor authentication (2FA)** (recommended)
51-
* If you enable 2FA, after you successfully enter your username and password, we'll also prompt you to provide a code that's generated by a time-based one time password (TOTP) application on your mobile device{% ifversion fpt or ghec %} or sent as a text message (SMS).{% endif %}{% ifversion 2fa-check-up-period %}
55+
* If you enable two-factor authentication (2FA), after you sign in with social login or your username and password, you'll be prompted to enter a code from a time-based one-time password (TOTP) application on your mobile device{% ifversion fpt or ghec %} or sent as a text message (SMS).{% endif %}{% ifversion 2fa-check-up-period %}
5256
* After you configure 2FA, your account enters a check up period for 28 days. You can leave the check up period by successfully performing 2FA within those 28 days. If you don't perform 2FA in that timespan, you'll then be asked to perform 2FA inside one of your existing {% data variables.product.prodname_dotcom %} sessions.
5357
* If you cannot perform 2FA to pass the 28th day checkup, you will be provided a shortcut that lets you reconfigure your 2FA settings. You must reconfigure your settings before you can access the rest of {% data variables.product.prodname_dotcom %}{% endif %}. For more information, see [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/accessing-github-using-two-factor-authentication#providing-a-2fa-code-when-signing-in-to-the-website){% ifversion 2fa-check-up-period %} and [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication){% endif %}.
5458
* In addition to authentication with a TOTP application{% ifversion fpt or ghec %} or a text message{% endif %}, you can optionally add an alternative method of authentication with {% ifversion fpt or ghec %}{% data variables.product.prodname_mobile %} or{% endif %} a security key using WebAuthn. See {% ifversion fpt or ghec %}[Configuring two-factor authentication using {% data variables.product.prodname_mobile %}](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-github-mobile) or {% endif %}[Configuring two-factor authentication using a security key](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-security-key).

content/authentication/keeping-your-account-and-data-secure/sudo-mode.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,7 @@ To confirm access for sudo mode, you can authenticate with your password. Option
5252
{%- endif %}
5353
* [Confirming access using a 2FA code](#confirming-access-using-a-2fa-code)
5454
* [Confirming access using your password](#confirming-access-using-your-password)
55+
* [Confirming access using your social login email](#confirming-access-using-your-social-login-email)
5556

5657
### Confirming access using a passkey
5758

@@ -87,3 +88,9 @@ When prompted to authenticate for sudo mode, type the authentication code from y
8788
### Confirming access using your password
8889

8990
When prompted to authenticate for sudo mode, type your password, then click **Confirm**.
91+
92+
### Confirming access using your social login email
93+
94+
Before you can access sudo mode, you must first configure social login. For more information, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/about-authentication-to-github).
95+
96+
When prompted to authenticate for sudo mode, type the authentication code sent to your social login email account, then click **Verify**.

content/get-started/start-your-journey/creating-an-account-on-github.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ topics:
2222

2323
To get started with {% data variables.product.prodname_dotcom %}, you'll need to create a free personal account and verify your email address.
2424

25+
You can also authenticate with the supported social login providers (currently only Google is supported) when you create your account on {% data variables.product.prodname_dotcom %}.
26+
2527
{% data reusables.accounts.your-personal-account %}
2628

2729
Later, you can explore the different types of accounts that {% data variables.product.prodname_dotcom %} offers, and decide if you need a billing plan. For more information, see [AUTOTITLE](/get-started/learning-about-github/types-of-github-accounts) and [AUTOTITLE](/get-started/learning-about-github/githubs-plans).
@@ -32,6 +34,7 @@ Note that the steps in this article don't apply to {% data variables.product.pro
3234

3335
1. Navigate to https://github.com/.
3436
1. Click **Sign up**.
37+
1. Alternatively, click on **Continue with Google** to sign up using social login.
3538
1. Follow the prompts to create your personal account.
3639

3740
During sign up, you'll be asked to verify your email address. Without a verified email address, you won't be able to complete some basic {% data variables.product.prodname_dotcom %} tasks, such as creating a repository.

content/get-started/using-github/github-mobile.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,18 @@ You can be simultaneously signed into mobile with multiple accounts on {% data v
5252

5353
{% data variables.product.prodname_mobile %} may not work with your enterprise if you're required to access your enterprise over VPN.
5454

55+
### Signing in with social login
56+
57+
> [!NOTE]
58+
> Social login is only available for {% data variables.product.prodname_free_user %} and {% data variables.product.prodname_ghe_cloud %} users
59+
60+
You can sign in to {% data variables.product.prodname_mobile %} using a supported social login provider. Currently, only Google is supported for social login on the {% data variables.product.prodname_mobile %} for Android. To use this option, make sure you originally created your {% data variables.product.github %} account using Google.
61+
62+
For iOS users, social login with Google is not supported in {% data variables.product.prodname_mobile %}. Follow the steps below to sign in to {% data variables.product.prodname_mobile %} on iOS using an account that was created with Google:
63+
1. Open the native web browser Safari and sign in to your {% data variables.product.github %} account.
64+
1. Authorize {% data variables.product.prodname_mobile %} in your browser when prompted.
65+
1. If you are unable to sign in through your browser, you can set a password or passkey for your {% data variables.product.github %} account on {% data variables.product.github %}. After setting a password or passkey, use your username and password with two-factor authentication, or a passkey, to sign in to {% data variables.product.prodname_mobile %}.
66+
5567
### Prerequisites for {% data variables.enterprise.data_residency_site %} accounts
5668

5769
To access accounts on {% data variables.enterprise.data_residency %} using {% data variables.product.prodname_mobile %}, you need to install {% data variables.product.prodname_mobile %} with at least version iOS 1.182.0 or Android 1.178.0.
@@ -105,5 +117,5 @@ You can submit feature requests or other feedback for {% data variables.product.
105117
If you're testing a {% data variables.release-phases.public_preview %} release of {% data variables.product.prodname_mobile %} for iOS using TestFlight, you can leave the {% data variables.release-phases.public_preview %} at any time.
106118

107119
1. On your iOS device, open the TestFlight app.
108-
1. Under "Apps", tap **{% data variables.product.prodname_dotcom %}**.
120+
1. Under "Apps," tap **{% data variables.product.prodname_dotcom %}**.
109121
1. At the bottom of the page, tap **Stop Testing**.

0 commit comments

Comments
 (0)