Resetting the Teaming admin password

  • 7005393
  • 25-Feb-2010
  • 17-Apr-2013

Environment

Novell Teaming 2.0
Novell Teaming 2.1
Novell Vibe OnPrem 3
Novell Vibe OnPrem 3.1

Situation

This describes the procedure for resetting the administrator password if user "admin" cannot log in because the password has been forgotten.

Resolution

  1. Novell Teaming allows 3 different password encryption algorithms:
    1. SHA
    2. SHA-256
    3. MD5
  2. You must know which encryption mechanism is being used by your Teaming installation. If you are unsure, you can easily find out by looking at the ssf-ext.properties file located in your Teaming installation's \webapps\ssf\WEB-INF\classes\config directory. Look for the setting 'user.password.encryption.algorithm'. It should be set to one of the 3 mentioned encryption mechanisms listed above.
  3. Using either a graphic query browser or a SQL command window, locate the schema "sitescape". Locate the table called "ss_principals".
  4. This table should contain a row (or multiple rows in case you have more than one zones) where the "name" column is "admin". Change the "password" column in this row of the "ss_principals" table to the encrypted string value corresponding to your encryption mechanism:

    SHA: bc8f3945a1466d220df9c91b655fb864b2664421
    SHA-256: 8555762fd938b78942d25747d24ff4025be0cb8a6d13846340ebd896ab0165e0
    MD5: 691cb01e9aafd958339fc2768eff016

    The exact mechanism for changing a table entry varies depending on the database server and database software you use. 
  5. Restart Teaming / Vibe
  6. Log in as

    username: admin
    password: admin

    and then change the password to something which is harder to guess.

Additional Information

Root Cause:
In order to change a password in Teaming a login is necessary. Admin can change other users' passwords but only admin can change the admin password, so if this password is forgotten, it is necessary to reset it manually by setting it in the appropriate database table entry, as outlined above.

The values bc8f3945a1466d220df9c91b655fb864b2664421, 8555762fd938b78942d25747d24ff4025be0cb8a6d13846340ebd896ab0165e0 and 691cb01e9aafd958339fc2768eff016 are the encrypted value of "admin" using SHA, SHA-256 and MD5 encryption algorithms respectively, so setting it into the database effectively resets the admin password to "admin". Please ensure that you know which encryption algorithm is being used in your Teaming installation.

For security reasons,  log in and change the admin password to something more secure.