OTP authentication

Bugster authenticates to your app like a real user to run tests. Besides username/password, Bugster supports OTP (One-Time Password)—temporary codes sent via email during login.

Bugster provides a managed email address with access to incoming OTPs. You create an account in your app using this email.

Setup

Get your Bugster OTP email

Contact Bugster support or check your dashboard to obtain your dedicated OTP email address.

Create an account in your app

Add OTP credential to config.yaml

credentials:
  - id: otp-user
    email: ${BUGSTER_OTP_EMAIL}
    auth_type: otp

Set the environment variable

# .bugster/.env
BUGSTER_OTP_EMAIL=your.bugster.email@...

(Optional) Add to CI/CD

If using CI/CD, go to Projects → Settings → Environment Variables and add:

BUGSTER_OTP_EMAIL=your.bugster.email@...

Use OTP in tests

Add these fields to any test requiring OTP authentication:

name: Dashboard access
page: /dashboard
credential_id: otp-user
requires_login: true
task: Verify dashboard loads after OTP login
steps:
  - Navigate to dashboard
  - Verify content is displayed
expected_result: Dashboard renders successfully

All tests with the same credential_id and requires_login: true share one authenticated session. Bugster logs in once, then reuses the session for subsequent tests. See Session Persistence for details.

GETTING STARTED

GUIDES

USING THE CLI

HOSTING AND CI/CD

OTP authentication

Setup

Use OTP in tests

Next steps

Credentials & roles

Session persistence

​Setup

​Use OTP in tests

​Next steps

Credentials & roles

Session persistence

Setup

Use OTP in tests

Next steps