Password Migration

Notes:

This procedure is to be done for old instances of OpenELIS that are using an outdated method of storing passwords. To check if the old method is used, follow these steps:

  1. Connect to running database
  2. Query login_user table
    1. SELECT * FROM clinlims.login_user;
  3. Check the password column values

If all passwords start with something similar to $2a$12$ then the passwords have been migrated, if not, then this procedure must be completed for OE2 to function.

It is recommended for all users to change their password after this tool is run. This is because the old method of storing passwords was insecure so it is possible that an attacker compromised their old password.

Migrating Passwords

Install Python tools on computer with connection to DB

  1. Run the following commands
    1. sudo apt install python-pip
    2. sudo apt-get update
    3. sudo apt-get install libpq-dev python-dev
    4. pip install bcrypt
    5. pip install pycrypto
    6. pip install psycopg2

Run the Password Migration tool

  1. Download the Password Migration tool and unpack it
    1. wget https://github.com/I-TECH-UW/Password-Migrator/archive/master.tar.gz
    2. tar -xvzf master.tar.gz
  2. Run the tool and follow instructions
    1. python PasswordMigrator-master/migrator/migrate.py
    2. Provide DB connection info
  3. Confirm that no errors occurred