Last updated March 14, 2022

Multi-factor authentication (MFA) is an effective way to increase protection for your account against common threats like phishing attacks, credential stuffing, and account takeovers.

Quick Start

If you are already familiar with MFA, follow these quick steps to enable MFA:

• Select your preferred MFA verification method:
  • Salesforce Authenticator or a third-party authenticator app installed on your phone OR
  • a portable security key such as Yubikey or Google Titan Key OR
  • a device with a built-in authenticator such as Touch ID or Windows Hello
• Start at Account Settings, select Setup Multi-Factor Authentication and follow the prompts

You are done!

Want to know more? Read on.

What is MFA

With MFA, users are required to prove they’re who they say they are by providing two or more pieces of evidence—or factors—when they log in.

One factor is the user’s username and password combination. The requirement for additional factors is satisfied through the use of a verification method that the user has in their possession, such as an authenticator app or security key. Even if hackers steal the user’s password, they can’t log in because they don’t have access to the user’s verification method.

What does this mean for you?

When you log in to Heroku after enabling MFA, you enter your email and password as usual and then complete MFA verification using one of your registered verification methods.

MFA verification can be as simple as tapping a notification on your phone, entering a code from a mobile authenticator app or using your fingerprint.

Enabling MFA and Registering Verification Methods

There are two ways you can enable MFA: from Account Settings or by responding to the MFA enablement reminder on Dashboard. As part of the enablement process, you register at least one MFA verification method.

From Account Settings

• Start at Account Settings and select Setup Multi-Factor Authentication.

• Click Add to select a verification method of your choice and follow on-screen instructions.

• Repeat for registering additional verification methods. We highly recommend adding a backup verification method.

• Click Done to finish.

You will receive an email notification confirming the addition of a new MFA verification method.

MFA Enablement Reminder

Heroku will occasionally remind you to enable MFA by displaying a reminder on Dashboard. You can enable MFA by clicking Continue on the reminder screen and selecting a verification method.

With this option, you can register only Salesforce Authenticator or a Third-party Authenticator Apps as a verification method.

Don’t forget to add a secondary verification method later through Account Settings.

Log In with MFA

When logging in to Heroku Dashboard after MFA is enabled, you enter your username and password as usual. You are then prompted to complete MFA verification using a registered verification method. For example, you receive a notification on your phone if you’re using Salesforce Authenticator as your method. You tap on the notification and approve in the app to complete logging in. When you have multiple verification methods registered, you can pick the verification method that you want to use.

Logging in to Heroku CLI after MFA is enabled requires you to open a browser and log in to Dashboard first. The --interactive option cannot be used due to technical dependency on web browsers for MFA verification.

MFA Verification Methods

You can use any (or even all!) of the following MFA verification methods.

• Salesforce Authenticator - a mobile app from Salesforce for secure, fast and frictionless MFA via push notifications
• Third-party Authenticator Apps - Google Authenticator or similar third-party authenticator apps
• Security Key - a physical security key such as Yubikey or Google Titan Key
• Built-in Authenticator - built-in verification via an operating system’s biometric service, such as Windows Hello or Touch ID
• Recovery Codes - a set of one-time use codes that a user can generate for backup purposes, when other verification methods are not available
• SMS (deprecated) - a phone that can receive text messages via SMS. This option is available until November 2021 only for users that had 2FA enabled prior to January 2021 and had a mobile number configured as a backup. Read More

Managing Verification Methods

We strongly recommend registering multiple verification methods. For adding or removing verification methods:

• Start at Account Settings and select Manage Multi-Factor Authentication.
• To add a verification method, click Add for the verification method of your choice, and follow on-screen instructions.
• To delete a verification method, click the Trash icon and confirm.
• Click Done to finish.

See MFA Verification Methods for additional information about each verification method.

Session Lengths for MFA-Enabled Users

For security reasons, users can stay logged into the Heroku Dashboard for a limited time. The default web session length is 24 hours. Sessions automatically extend up to 10 days if there is activity on your Dashboard session within a 24-hour period.

The default session length for the Heroku CLI is 30 days.