Introducing VIDA Identity Stack: All of VIDA, in one place 🎉
For the complete documentation index, see llms.txt. This page is also available as Markdown.

API Reference

TOTP-Based Authentication APIs

These APIs enable TOTP (Time-based One-Time Password) authentication using authenticator apps like Google Authenticator. The process is divided into Initiation and Completion phases for both provisioning and authentication.

Phase
API Name
Description
API Reference Link

Initiation

TOTP Provisioning Initiation

Begins the TOTP provisioning process. Returns a session ID, bearer token, and a TOTP secret as part of challenge.

TOTP Authentication Initiation

Initiates authentication using TOTP. Returns a session ID, bearer token, and a challenge.

Completion

TOTP Provisioning Completion

Completes provisioning by verifying the OTP generated from the shared TOTP secret. Returns JWT and credential ID.

TOTP Authentication Completion

Completes authentication by validating the OTP provided by the user. Returns access tokens upon success.

Last updated