Authenticating with PingID using a YubiKey
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.
Before you begin
Pair your YubiKey with your account to enable authentication. For more information, see Using a YubiKey (OTP) for authentication with PingID.
About this task
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.
-
Web
-
VPN
-
Windows login
-
Mac login
Authenticating using a YubiKey
Authenticate using your YubiKey hardware token.
About this task
In a browser, sign on to your account and then use your YubiKey hardware token to authenticate.
Steps
-
Sign on to your account or access an application that requires authentication.
Result:
The YubiKey Authentication window appears, prompting you to enter a YubiKey passcode.
-
Insert the YubiKey into your computer USB port. Press the YubiKey button.
Make sure the YubiKey Authentication window is selected as the active screen before you press the YubiKey button.
Result:
A one-time passcode (OTP) automatically generates and enters into the YubiKey Authentication window.
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:
-
Download the YubiClip application to your mobile device and enable NFC.
-
Place the YubiKey next to your mobile device. The verification code is copied to the device clipboard.
-
Paste the code into the YubiKey Authentication field in your browser. Tap Verify.
-
-
Click Sign On.
Result:
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.
About this task
In a browser, sign on to your account to use your YubiKey hardware token to authenticate.
Steps
-
From your web browser or application, sign on to your VPN with your username and password and then:
-
Enter your username and password.
-
For multiple devices only: A message displays showing a numbered list of all your devices. Enter the number for YubiKey.
-
Click Sign In.
Result:
The text entry field displays.
-
-
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.
Result:
An OTP populates the text field.
-
Click Sign In.
Result:
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.
Steps
-
Sign on to your Windows machine.
Result:
The YubiKey Authentication window appears, prompting you to enter a YubiKey passcode.
-
Insert the YubiKey into your computer USB port and press the YubiKey button.
Make sure the YubiKey Authentication window is selected as the active window before you press the YubiKey button.
Result:
A OTP is automatically generated and inserted into the YubiKey Authentication window.
-
Click Sign On.
Result
The green Authenticated message appears with a check mark, indicating authentication is successful. You are signed on to your Windows machine.
Authenticating using a YubiKey (Mac Login)
Use your YubiKey hardware token to authenticate when you sign on to your Mac machine.
About this task
Make sure your Apple Mac is running Mac OS 10.13 or later.
Steps
-
Sign on to your Mac machine.
Result:
You’ll see the YubiKey Authentication window, prompting you to enter a YubiKey passcode.
-
Insert the YubiKey into your computer USB port, and then press the YubiKey button.
window is selected as the active window before you press the YubiKey button.
Result:
A OTP is automatically generated and inserted into the YubiKey Authentication window.
-
Click Sign On.
Result:
You’ll see the green check mark indicating authentication is successful, and you’ll be signed on to your machine.
