KBEC-00358 - CorruptCredential error after server data transfer

Problem

After importing data from an old Electric Flow server to a new one, errors like these started to appear:

Step error [CorruptCredential]: corrupted credentials, possibly due to a mismatched passkey file

Solution

Credentials are encrypted using the server passkey. When data is directly transported from one server to another, either through a database dump or ectool import, you will need to transfer the previous server's passkey as well to decrypt these credentials.

Note that if you switch out the passkey, any credentials and passwords on the server created using the current passkey will be invalidated.

1. Back up the current <data_dir>/conf/passkey file, and copy over the passkey from the old server instance.
2. Run ectool setDatabaseConfiguration to enforce the new passkey and re-configure the database password with it, then restart the server.
   ectool setDatabaseConfiguration --databaseType <DBtype> --hostName <DBhost> --databaseName <DBname> --userName <DBuser> --password <pw> --ignoreServerMismatch true --ignorePasskeyMismatch true
3. Alternatively, restart the server right after replacing the file, and wait for prompts to come up to set your DB configs in the UI. You will need to first re-enter the DB configurations, then ignore passkey mismatch after that to push this passkey file to the DB.
4. After the passkey change, encrypted sessions will be invalidated, which you may need to clear. You can do this manually, or by restarting the server again.