Last updated July 06, 2021

Security keys are small physical devices that are easy to use because there’s nothing to install and no codes to enter. This is a great option if you are unable to use a mobile device for logging in to Heroku.

Options for security keys include Yubikey or Google Titan Key.

Choosing a Security Key

You can use any USB, Lightning, or NFC security key that’s compatible with the FIDO WebAuthn (FIDO2) standard, including Yubico’s YubiKey or Google’s Titan Key.

Security keys require a supported browser such as Chrome™, Firefox®, Edge™, Safari® to act as an intermediary between the key and Salesforce.

Heroku has verified security key functionality in multiple environments. Be sure to consult vendor documentation for specific questions related to security key support in your environment to ensure compatibility.

As always, we strongly recommend configuring a secondary MFA verification method such as Recovery Codes to avoid loss of access if you don’t have your primary method available.

Registering a Security Key

To register a security key as an MFA verification method:

Go to Account Settings and select Setup Multi-Factor Authentication (or Manage Multi-Factor Authentication if you have already enabled other verification methods).

Choose Add Security Key option on the next page and follow the prompts to complete registration. Your registration experience may vary based on the browser and the form factor of the key in use but generally involves these steps -

• Click Register to add a security key.
• When prompted, ensure that the security key is inserted in the appropriate port or connected via NFC and activate it.
• Name your key and complete registration.

MFA Verification with a Security Key

To log in using a security key:

• After entering your email and password, you are prompted to verify your login using your security key.
• Insert or connect the key, then click Verify. (Your specific experience to complete logging in may vary based on the browser and the form factor of the key.)