Add Step-up Authentication

With step-up authentication, applications that allow access to different types of resources can require users to authenticate with a stronger authentication mechanism to access sensitive resources.

You can add step-up authentication to your app with Auth0's extensible MFA support. Your app can verify that the user has logged in using MFA and, if not, require the user to step-up to access certain resources.

How it works

As an example, Fabrikam's Intranet requires users to authenticate with their username and password to access customer data. However, a request for access to employee data (which may contain sensitive salary information) triggers a stronger authentication mechanism like MFA.

MFA Step-up Authentication flow diagram

Step-up Authentication for APIs

When your audience is an API, you can implement step-up authentication with Auth0 using scopes, access tokens, and rules. You can use a rule to trigger the step-up authentication mechanism (for example, prompt MFA) whenever the user requests scopes that map to sensitive resources.

A user signs into Fabrikam's web app. The standard login gives to this user the ability to interact with their API and fetch the user's account list. This means that the Access Token that the application receives after the user authentication contains a scope like read:accounts. Now the user wishes to transfer funds from one account to another, which is deemed a high-value transaction. In order to perform this action, the API requires the scope transfer:funds.

The access token that the user currently has does not include this scope and the application knows it since it knows the set of scopes it requested in the initial authentication call. The solution is that the application performs another authentication call, but this time it requests the required scope. The browser redirects to Auth0 and a rule is used to challenge the user to authenticate with MFA since a high-value scope was requested. Once the user successfully authenticates with MFA, a new access token which includes the high-value scope is generated and sent. The application will pass the Access Token to the API which will discard it after verification, thereby treating it as a single-use token.

To learn more, read Step-up Authentication for APIs.

Step-up Authentication for web apps

If it is a web app that verifies the authentication level, and not an API, then you do not have an access token. In this case, you can check if a user has logged in with MFA by reviewing the contents of their ID token. You can then configure your application to deny access to pages with sensitive information if the ID token indicates that the user did not log in with MFA, and use a rule to trigger the step-up authentication mechanism (for example, prompt MFA). For example, you might have an employee app that authenticates users with usernames and passwords, but if a user wants to access salary information, they have to provide a second factor, using for example a mobile push notification.

You can implement this by checking the ID token when the user tries to access that screen. If the claims show that the user has authenticated with MFA already then display the sensitive information. Otherwise, trigger authentication again, and using a rule, prompt the user to authenticate with MFA.

To learn more, read Step-up Authentication for Web Apps.

Learn more