Welcome to OTP-Manager

OTP-Manager is a secure, easy-to-use tool designed to manage one-time passwords (OTP) for various applications. It supports TOTP (Time-based One-Time Password) and is built to integrate seamlessly with various authentication systems.

GitHub View on GitHub

How to Install OTP-Manager

Prerequisites

Steps

  1. Clone the repository:
    git clone https://github.com/Migrim/OTP-Manager.git
  2. Navigate to the project directory:
    cd OTP-Manager
  3. Install the required dependencies:
    pip install -r requirements.txt
  4. Run the application:
    python app.py

How to Configure OTP-Manager

  1. Open the configuration file config.ini located in the project directory.
  2. Update the following settings:
  3. [server]
    port = 5002
    secret_key = your-secret-key
    
    [database]
    path = instance/otp.db
  4. Save the changes and restart the application.

How to Use OTP-Manager

  1. Open your web browser and navigate to http://localhost:5002 (or the port you set in the config).
  2. Log in with the pre-configured admin credentials:
    • Username: admin
    • Password: 1234
  3. Change the admin password and create a new user for yourself. Note that new users can only be created by the "admin" user.
  4. To add a company:
    • Open Management > Company Settings.
    • Enter the following details:
      • Name: The name of the company or folder (you can use companies as folders as well).
      • Kundennummer: Your company identification number (set a random ID if you don't have specifics).
      • Web-Password: If this option is displayed, type in whatever you want. This will be removed later on as the Web-API is deprecated and the OTP-Manager is completely offline.
    • Click "Save".
  5. To add a new OTP entry:
    • Click on "Add".
    • Enter the service name (must be at least 4 letters), the secret key, and optionally an email.
    • Choose a company. If no company exists, you need to create one first under Management > Company Settings.
    • Click "Save".
  6. To view the OTP for a service, navigate to the service entry and the OTP will be displayed.