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.

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:

     [server]
     port = 5002
     secret_key = your-secret-key
        
     [restart]
     time = The time of day (in HH:MM format) when the application will restart automatically.
     interval_days = The number of days between each restart.
        
     [database]
     path = instance/otp.db
    
  3. 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.