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 unable to contact the registration server if you are working behind a proxy server. When attempting to either register the signature keys or sign an application, you may see one of the following error messages:

Server unavailable at this time. Please contact your system administrator.

OR

General failure. Please try again. Server may be unavailable.

Resolution

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

Resolution 1

Configure the BlackBerry JDE to use a proxy server when launching the BlackBerry SignatureTool. To do so, complete the following steps:

1. • In the BlackBerry JDE, select the Edit menu.
   • Choose Preferences , and then select the Code Signing 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.jar SigKey.csi

In the preceding example, SigKey.csi refers to the 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 is optional because the default proxy port is 80. However, if the proxy server is configured to use a different port, the Dhttp.proxyPort option is required, where it specifies the configured port.

Make sure that you register each .csi file and that you do it only once. For security purposes, the BlackBerry Signature Tool prevents 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 by running the BlackBerry Signature Tool from a command prompt. The BlackBerry Signature Tool is located within the following directory:

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

From a command line, change to the preceding directory, and use 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 you to select the .cod file(s) that you want to sign.

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

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