Authenticating with PingID using a YubiKey - PingID

PingID End User Guide

bundle
pingid-user-guide
ft:publication_title
PingID End User Guide
Product_Version_ce
PingID
category
ContentType
Product
Productdocumentation
pingid
ContentType_ce
Product documentation

You can use a YubiKey to access your account using a web browser, to access your company's VPN, or to access a Windows login or Mac login machine.

Pair your YubiKey with your account to enable authentication. For more information, see Using a YubiKey (OTP) for authentication with PingID.

.

If you are using a virtual machine (VM) to connect to your accessing device and to authenticate with your YubiKey, configure your VM to recognize a USB device.

Authenticating using a YubiKey

Authenticate using your YubiKey hardware token.

In a browser, sign on to your account and then use your YubiKey hardware token to authenticate.

  1. Sign on to your account or access an application that requires authentication.

    The YubiKey Authentication window appears, prompting you to enter a YubiKey passcode.

    A screen capture of the YubiKey Authentication window with the request message to insert your Yubikey to authenticate.
  2. Insert the YubiKey into your computer USB port. Press the YubiKey button.
    Note:

    Make sure the YubiKey Authentication window is selected as the active screen before you press the YubiKey button.

    A one-time passcode (OTP) automatically generates and enters into the YubiKey Authentication window.

    Note:

    If you are using a YubiKey Neo and need to register using a browser on your mobile device through NFC, the process is different. To complete the registration process:

    1. Download the YubiClip application to your mobile device and enable NFC.
    2. Place the YubiKey next to your mobile device. The verification code is copied to the device clipboard.
    3. Paste the code into the YubiKey Authentication field in your browser. Tap Verify.
  3. Click Sign On.

    A green check mark appears, indicating authentication is successful and your access is approved.

Authenticating using a YubiKey (VPN)

Use your YubiKey hardware token to authenticate.

In a browser, sign on to your account to use your YubiKey hardware token to authenticate.

  1. From your web browser or application, sign on to your VPN with your username and password and then:
    1. Enter your username and password.
    2. For multiple devices only: A message displays showing a numbered list of all your devices. Enter the number for YubiKey.
    3. Click Sign In.

    The text entry field displays.

  2. Insert your YubiKey into the USB port on your computer, and tap your YubiKey.

    Place your mouse cursor in the text entry field to ensure the OTP is entered into the field automatically.

    An OTP populates the text field.

  3. Click Sign In.

    After you have authenticated successfully, you are signed on to your VPN.

Authenticating using a YubiKey (Windows login)

Use your YubiKey hardware token to authenticate to sign on to your Windows machine.

  1. Sign on to your Windows machine.

    The YubiKey Authentication window appears, prompting you to enter a YubiKey passcode.

    A screen capture of the YubiKey Authentication window, prompting you to use your YubiKey to authenticate.
  2. Insert the YubiKey into your computer USB port and press the YubiKey button.
    Note:

    Make sure the YubiKey Authentication window is selected as the active window before you press the YubiKey button.

    A OTP is automatically generated and inserted into the YubiKey Authentication window.

  3. Click Sign On.

The green Authenticated message appears with a check mark, indicating authentication is successful. You are signed on to your Windows machine.


A screen capture of the Windows home desktop page.

Authenticating using a YubiKey (Mac Login)

Use your YubiKey hardware token to authenticate when you sign on to your Mac machine.

Make sure your Apple Mac is running Mac OS 10.13 or later.

  1. Sign on to your Mac machine.

    You'll see the YubiKey Authentication window, prompting you to enter a YubiKey passcode.

    A screen capture of the Authentication window showing the passcode field.
  2. Insert the YubiKey into your computer USB port, and then press the YubiKey button.
    Note:

    Make sure the YubiKey Authentication window is selected as the active window before you press the YubiKey button.

    A OTP is automatically generated and inserted into the YubiKey Authentication window.

  3. Click Sign On.

    You'll see the green check mark indicating authentication is successful, and you'll be signed on to your machine.


    A screen capture of the Mac login desktop following successful sign-on.