Skip to content
serifpersiaPublic

About

Local Secure 2FA Web App

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

Repository files navigation

vault2fa

image

A secure, local-first, web-based two-factor authenticator application.

Features

  • Encryption:
  • Account Management: Easily add, edit, and delete accounts.
  • Bulk Import: Supports importing accounts from a decrypted Bitwarden JSON export.

Getting Started

Prerequisites

  • Node.js (v16 or later is recommended)
  • npm (comes with Node.js)

Installation & Running

  1. Clone the repository:

    git clone https://github.com/serifpersia/vault2fa.git
    cd vault2fa
  2. Install dependencies: This project has a simple Node.js/Express backend to serve the files.

    npm install
  3. Run the server:

    node server.js
  4. Open the application: Open your web browser and navigate to http://localhost:3000.

vault2fa Usage

  1. Create a Vault: On your first visit, you will be prompted to create a master password. This password is the only way to access your vault. Do not forget it!
  2. Unlock: On subsequent visits, enter your master password to decrypt and unlock your vault.
  3. Add Accounts:
    • Click the + button to open the menu.
    • Manual Entry: Provide an account name and the Base32 secret key from your service provider.
    • Import: Select a decrypted Bitwarden JSON file to bulk-import your existing 2FA accounts.
  4. Manage Accounts:
    • Click the ... button on any account card to edit its name or delete it.
    • Important: Before deleting an account, ensure you have disabled 2FA on the corresponding website first to avoid being locked out.

License

This project is licensed under the MIT License. See the LICENSE file for details.

About

Local Secure 2FA Web App

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages