← All Plugins/Security & Authentication/v0.1.0Official

Veap Auth TOTP

Time-based One-Time Password (TOTP) two-factor authentication plugin compatible with Google Authenticator, Authy, and 1Password.

bun veap add @veap/auth-totp-plugin

[See clean architecture layers, Knex migrations & configuration below]

Purpose & Overview

Provides 2FA enrollment with QR codes, recovery codes, and verification challenges during login for elevated account security.

Installation & Setup

Install the package

bash

bun veap add @veap/auth-totp-plugin

Register in lib/veap.ts (or auto via lib/plugins.gen.ts)

lib/veap.ts

typescript

// lib/veap.ts
import { Application } from "@veap/kernel";
import authTotpPlugin from "@veap/auth-totp-plugin";

export const app = Application.configure()
  .withAuth()
  .withPlugins([authTotpPlugin])
  .create();

Start application

bash

bun dev

Migrations run automatically on boot via MigrationServiceProvider.

Keep in mind

Generates secure QR codes compatible with Google Authenticator, 1Password, Microsoft Authenticator, etc.
Requires entering a 6-digit verification code during sign-in when two-factor authentication is active.
Generates single-use recovery codes in case the user loses access to their authenticator device.