Appendix M: AlertProcessor Password Encryption

 Overview

AlertProcessor is a .NET application that uses a similar configuration file to the Transaction Insight Web (ASP.NET) application.

 Procedure

The following procedure encrypts the entire appSetting portion of the configuration file, including the database connection string.

Access Aspnet_regiis.exe.

Microsoft provides the Aspnet_regiis.exe tool that encrypts and decrypts portions of the configuration file. The tool is located in the %windows%\Microsoft.NET\Framework\versionNumber directory. 

For example:

C:\windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe.

Find the directory where AlertProcessor.exe and AlertProcessor.config are installed. 

By default this is "C:\tibco\TransactionInsight\<n.n>\Environments\<env>\bin" where <env> is the name of your Transaction Insight environment.

Microsoft provides the Aspnet_regiis.exe tool that encrypts and decrypts portions of the configuration file. The tool is located in the %windows%\Microsoft.NET\Framework\versionNumber directory. 

For example: C:\windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe.

Find the directory where AlertProcessor.exe and AlertProcessor.config are installed. 

By default this is "C:\tibco\TransactionInsight\<n.n>\Environments\<env>\bin" where <env> is the name of your Transaction Insight environment.

Back up the unencrypted AlertProcessor.config file to another location, since the encrypted file works only on the current machine.

Encrypt:

  1. Open your "C:\tibco\TransactionInsight\<n.n>\Environments\<env>\bin" directory in Windows explorer.

  2. Rename AlertProcessor.config to Web.config.

  3. Open a command prompt.

  4. Type and run this command:

    C:\windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -pef "appSettings" "C:\tibco\TransactionInsight\<n.n>\Environments\<env>\bin"

    (Replace <env> with your Transaction Insight environment name.)

    Look for this message:

    Encrypting configuration section...
    Succeeded!
    
  5. Rename Web.config back to AlertProcessor.config.

    The appSettings section is now encrypted.

    The appSettings section is now encrypted.

Decrypt:

  1. Open the "C:\tibco\TransactionInsight\<n.n>\Environments\<env>\bin" directory in Windows explorer.

  2. Rename AlertProcessor.config to Web.config.

  3. Open a command prompt.

  4. Type and run this command:

    C:\windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -pdf "appSettings" "C:\tibco\TransactionInsight\<n.n>\Environments\<env>\bin"

    (Replace <env> with your Transaction Insight environment name.)

    Look for this message:

    Decrypting configuration section...
    Succeeded!
  5. Rename Web.config back to AlertProcessor.config.

    The appSettings section is now decrypted.