Skip to main content
this document is for:

Deployment: Invicti Platform on-premises

Reset passwords without SMTP

When an SMTP server isn't configured or available in your Invicti Platform on-premises installation, you can reset user passwords directly through the PostgreSQL database.

tip

To change your own password through the UI, see Change password instead.

Prerequisites​

You are going to need:

  • Access to the PostgreSQL database
  • Database credentials with update permissions on the identity schema
  • The email address of the user account requiring a password reset

Understanding password storage​

User passwords in the database are hashed using a one-way cryptographic function, not encrypted. This means passwords can't be retrieved or decrypted. The only option is to reset them to a new value.

Reset a password​

To reset a user's password:

  1. Connect to your PostgreSQL database using your preferred client.
  2. Execute the following SQL query, replacing <user_email_address_here> with the target user's email address:
UPDATE identity.user_credentials uc
SET password_hash = 'AQAAAAIAAYagAAAAEEf2QKdmoJkYdKUmKowx5NCtSE0Khz+4O+bUduSsdkrDRmb7gKTorusA2C0s3rYGkg==',
password_hash_algorithm = 'UnifiedPlatform'
FROM identity."user" u
WHERE uc.user_id = u.user_id
AND email_address = '<user_email_address_here>';
  1. Confirm the update was successful (the query should return the number of rows updated).
  2. Notify the user that their password has been reset to the temporary password: Password123#
  3. Require the user to change this password immediately upon their first login.

Security best practices​

  • Restrict database access to authorized system administrators only
  • Force users to change temporary passwords on first login
  • Keep a record of password reset operations for compliance and auditing
  • Never share database credentials with end users

Troubleshooting​

Password reset doesn't work:

  • Verify the email address is correct and matches an existing user account
  • Check your database connection and confirm you have sufficient permissions
  • Ensure the identity service is operational

No rows updated:

  • This typically occurs when the user has never had a password set (for example, if they were originally configured for SSO authentication)
  • In this case, the user has no record in the user_credentials table
  • If the user was configured for SSO, they should continue using SSO to log in or use the SSO password reset flow Contact support if you need to create a password record for a user who doesn't have one

Get help​

If you encounter issues with this procedure, contact support and provide:

  • The user's email address
  • The exact error message received
  • The time you attempted the reset

Need help?​

Invicti Support team is ready to provide you with technical help. Go to Help Center

Was this page useful?