Support - Unable to register keys or sign a file while behind a proxy server

Summary

This article applies to the following:

BlackBerry® Java® Development Environment(BlackBerry JDE)

 

Problem

By default, the BlackBerry Signature Tool is unableto contact the registration server if you are working behind a proxyserver. When attempting to either register the signature keys orsign an application, you may see one of the following error messages:

Server unavailable at this time. Please contactyour system administrator.

OR

General failure. Please try again. Server may beunavailable.

Resolution

To resolve this issue, perform one of the following resolutions:

Resolution 1

Configure the BlackBerry JDE to use a proxy server when launchingthe BlackBerry SignatureTool. To do so, complete the followingsteps:

In the BlackBerry JDE, select the Edit menu.
Choose Preferences, and then select the CodeSigning tab.
Type the proxy information in the required fields.

Resolution 2

Register the signature keys by running the following command,instead of double-clicking on each .csi file:

Java -jar -Dhttp.proxyHost=myproxy.com -Dhttp.proxyPort=80 SignatureTool.jarSigKey.csi

In the preceding example, SigKey.csi refers tothe name of each signature key (.csi) file that was sent to you.The naming conventions for the keys are as follows:

client-RRT-*.csi
client-RBB-*.csi
client-RCR-*.csi

Dhttp.proxy is either the name or Internet Protocol(IP) address of the proxy server. The Dhttp.proxyPort isoptional because the default proxy port is 80. However, if the proxy serveris configured to use a different port, the Dhttp.proxyPort optionis required, where it specifies the configured port.

Make sure that you register each .csi file and that you doit only once. For security purposes, the BlackBerry Signature Toolprevents multiple registrations of the same set of keys.

Signing an application

Once the signature keys have been successfully registered,you will be able to sign a BlackBerry smartphone application byrunning the BlackBerry Signature Tool from a command prompt. TheBlackBerry Signature Tool is located within the following directory:

[Drive:]/Program Files/Research In Motion/BlackBerryJDE 3.x/bin

From a command line, change to the preceding directory, anduse the following command to run the BlackBerry Signature Tool:

Java -jar -Dhttp.proxyHost=myproxy.com -Dhttp.proxyPort=80 SignatureTool.jar

This will open a file selection window, which will allow youto select the .cod file(s) that you want to sign.

Additionally, the BlackBerry JDE has built-in support forthe proxy host and proxy port under the Code Signing tab. To accessthe Code Signing tab, click Edit > Preferences > CodeSigning. This can be used for future code signing requestsafter the initial registration.

Note: Proxy authentication support has been added to the BlackBerrySignatureTool in BlackBerry JDE 4.3.0 and later.