Skip to content

signing-in-with-a-passkey.md

Latest commit

 

History

History
42 lines (31 loc) · 3.49 KB

signing-in-with-a-passkey.md

File metadata and controls

42 lines (31 loc) · 3.49 KB
title Signing in with a passkey
intro You can use a passkey to sign in safely and easily to {% data variables.product.prodname_dotcom %} in your browser, without requiring a password and two-factor authentication. You can also sign in using a passkey on a nearby device.
permissions {% ifversion fpt or ghec%}Personal account owners who manage their own credentials{% endif %}
versions
fpt ghec ghes
*
*
*
shortTitle Sign in with a passkey
category
Sign in with SSO or a passkey
contentType how-tos

{% data reusables.passkeys.ghes-disable %}

About signing in with a passkey

You must first add a passkey to your account before you can use the passkey to sign in to {% data variables.product.prodname_dotcom %} in the browser. For more information, see AUTOTITLE.

Once you have added a passkey to your account, you can use the passkey to sign in safely and securely to {% data variables.product.prodname_dotcom %} without having to enter your password, perform two-factor authentication (2FA), or verify a new device. Once you have added a synced passkey on one device, the passkey is available to use across multiple devices. These devices must use the same passkey provider (such as iCloud).

Some authenticators allow passkeys to be used with nearby devices. For example, perhaps you want to sign in to {% data variables.product.prodname_dotcom %} using a Bluetooth-enabled laptop that's not set up with a passkey. If you have registered a passkey on your phone, you might opt to scan a QR code, or trigger a push notification to your phone, in order to complete the sign in securely. For more information, see Signing in with a passkey using a nearby device.

Signing in with a passkey linked to your primary device

  1. Navigate to the login page for {% data variables.product.prodname_dotcom %} at {% ifversion fpt or ghec %}https://github.com/login?passkey=true{% else %}https://HOSTNAME/login?passkey=true{% endif %}.
  2. Click {% octicon "passkey-fill" aria-hidden="true" aria-label="passkey-fill" %} Sign in with a passkey.
  3. Follow the prompts on your browser or platform to select a passkey that is accessible from the device you are using, and complete the authentication process. For example, when prompted, you might touch a fingerprint sensor or enter your PIN.

Signing in with a passkey using a nearby device

  1. Navigate to the login page for {% data variables.product.prodname_dotcom %} at {% ifversion fpt or ghec %}https://github.com/login?passkey=true{% else %}https://HOSTNAME/login?passkey=true{% endif %}.
  2. Click {% octicon "passkey-fill" aria-hidden="true" aria-label="passkey-fill" %} Sign in with a passkey.
  3. Follow the prompts on your browser or platform to select a passkey that is accessible as a nearby device (such as a phone or a tablet).
  4. Continue to follow the prompts to start the authentication process. For example, you might choose to scan a QR code, or trigger a push notification to the nearby device.
  5. On your nearby device, follow the prompts to complete the authentication process. For example, if you are using an iPhone, you might perform Face ID or enter your passcode.

Further reading