Handling Passwords

You can use the obfuscate utility installed with TIBCO Runtime Agent to encrypt confidential information, such as passwords in property files, with an encryption key. The obfuscate utility rewrites a Java property file by encrypting property values that start with a #!! or #! prefix. The utility is located in the TIB_TRA_HOME/bin directory.

If you want to run the adapter locally, specify the runtime password value to be a module property. Before starting the adapter, include the runtime password as a client variable in the properties file and obfuscate it by using the obfuscate utility.

The following example shows how to encrypt a password.

For more information about how to use the obfuscate utility, see "Obfuscate Utility" in TIBCO Runtime Agent Installation.

Procedure

  1. Specify the password to be myPassword as a module property without a value.
  2. Include the following entry in the TRA properties file of the adapter at run time:
    tibco.clientVar.myPassword=#!!passwordValue
  3. On the command line, enter the following commands:
    TIB_TRA_HOME/bin/obfuscate TRAFileName