What is a Verifier?
A verifier is a piece of information about the OAuth provider being used by the application, which is queried by web3auth auth network nodes from a smart contract deployed on the Ethereum blockchain to verify the JWT token.
There are two types of
Verifiers at Web3Auth:
Default Verifiers: These are the verifiers associated with OAuth providers(Google, Facebook, Apple etc.) which are owned and managed by Web3Auth's account.
Custom Verifiers: If you want to manage your OAuth providers(Google, Facebook, Apple etc.) yourself or to use some Federated Identity Providers like Auth0, Firebase, AWS Cognito, Okta etc., or even your Custom JWT Authentication, you'll need to create a verifier under a project on the Web3Auth's dashboard.
For users to be able to log in using your custom authentication flow, you will need to use a Custom Verifier. The Wallet that is generated for each user is specific to a verifier. Verifier scripts determine the access structure to your users' wallets, and the set of Verifier scripts you choose will determine which logins your application will ultimately use.
Custom Authentication tab of a project looks something like this:
Once you click on the
Create Verifier button, you'll see a toggle similar to this:
To create a verifier, you need to input the following details:
The identifier for your verifier. You'll need this while initializing the
Web3AuthNoModal SDK for setting up the custom authentication.
Choose a Login Provider
Select the Login Provider from the provided options.
The following is the list we have on our Dashboard:
- Social Login Providers
- Custom Providers
- Aggregate Multiple Providers
If something you're looking for is not available in the list, choose
Custom Provider and provide the JWT details.
Can XXXX authenticator/login be supported?
The list above is only comprehensive to some of the logins our system can support. If you'd like support for a particular login system, send your query to firstname.lastname@example.org.
If you have created a verifier under your project, you'll see it under the custom authentication tab.
Click on the three dots next to the verifier you wish to edit and click on
Update Verifier in the dropdown.
Edit Verifier modal will appear. Make the necessary changes and click on save at the bottom right.
Developers can create
Aggregate Verifiers from the Web3Auth Dashboard. Combining multiple login methods to create a verifier to get the same address
for your user regardless of their login providers is possible while creating a verifier, for example, combining a
GitHub via Auth0 to access the same key for your user. These login methods should share the same Verifier ID, e.g.,
Single ID Verifiers.
Check out Aggregate Verifier page to set up your verifier.