MON Authenticator Setup

Complete guide to setting up TOTP 2FA with MON Authenticator.

Overview

MON Authenticator is Moontraze's TOTP app. Users scan a QR code and get 6-digit codes.

const enroll = await moon.auth.enrollTotp();
// enroll.qrPayload = otpauth:// URL

import QRCode from 'react-qr-code';
 
<QRCode value={enroll.qrPayload} />

User opens MON Authenticator app and scans the QR code.

const code = await promptUser('Enter 6-digit code');
await moon.auth.confirmTotp(code);

The QR code contains an otpauth:// URL:

otpauth://totp/Moontraze:user@example.com?secret=BASE32&issuer=Moontraze&period=30&digits=6

const verify = await moon.auth.forgotPasswordVerify(
  'user@example.com',
  '123456',
);

await moon.auth.forgotPasswordReset(
  'user@example.com',
  verify.verifyToken,
  'newSecret123',
);

Problem	Solution
QR not scanning	Increase QR size, ensure good lighting
Code always invalid	Check device time is synced
Secret lost	Re-enroll from scratch