Auth0.swift Touch ID Authentication

Here's the scenario: After user authentication, you want to store the user's credentials and use them as long as they are valid. Once they expire, you would want to renew them using the refreshToken in order to avoid presenting the login page again. Rather than doing this automatically you require the user to validate with their fingerprint.

You will be using the Credentials Manager utility in Auth0.swift to streamline the management of user credentials and perform the Touch ID authentication.

Getting Started

First, import the Auth0 module:

Credentials Manager

Before retrieving credentials, you can also engage the biometric authentication (Face ID or Touch ID) supported by your iOS device.

Begin by setting up the Credentials Manager. Then enable biometrics. You can also pass in a title to show in the prompt.

We also strongly recommend that you add the NSFaceIDUsageDescription setting to your project's Info.plist to display a reason for using Face ID. In some cases, if you do not provide a description string and the user attempts Face ID authentication, the user's attempt may fail.


Present the login page and pass the credentials upon successful authentication to the Credentials Manager.

Renew User Credentials

When you need to renew the user's credentials, you can call the credentials method from the Credentials Manager.

There is no need manually store the new credentials as this is handled by the Credentials Manager during the renewal.

Next Steps

You can download a sample project and follow the instructions in the iOS quickstart section on Touch ID and Face ID in iOS.