PreviousNext

Request code signatures

Applications that use controlled classes or methods require signatures from the BlackBerry® Signing Authority Tool. Use the Signature Tool to request and receive signatures that you need in order to use the code.

Register for a RIM Signing Authority account

You must have HTTP access to the Internet to register for code signing.

    1. Complete the registration form on the BlackBerry® Developer Zone at
      http://www.blackberry.com/developers.
    2. Save the .csi file that Research In Motion emails you.
    3. Double-click the .csi file.

      If a dialog box appears that states that a private key cannot be found, complete the following steps before you continue:

      a) Click Yes to create a new key pair file.

      b) Type a password for your private key, and type it again to confirm.

      c) Click OK.

      d) Move your mouse to generate data for a new private key.

    4. In the Registration PIN field, type the PIN that RIM provided.
    5. In the Private Key Password field, type a password of at least eight characters. This is your private key password, which protects your private key.

      Note: Protect your private key password. If you lose this password, you must register again with RIM. If this password is stolen, contact RIM immediately to revoke your key to prevent others from requesting code signatures using your identity.

    6. Click Register.
    7. Click Exit.

See the BlackBerry Java Development Environment Fundamentals Guide for more information about registering for code signing.

Request a code signature

    1. Select a project.
    2. On the Build menu, click Request Signatures.
    3. To add additional .cod files to the request list, click Add.
    4. Select a .cod file.
    5. Click Open.
    6. Click Request.
    7. In the dialog box, type your private key password.
    8. Click OK. The signature tool appends your private key information to the request and sends your list of code files to the signing authority tool for approval.

      Note: The signature tool sends a hash of your code so that the signing authority tool can generate the necessary keys. Your actual code is not sent.

After the files are signed and returned to you, the Status column displays Signed. You can deploy the code on your BlackBerry device.

If any problems occur with the signature request, the Status column displays Failed - See Details. Refer to the Details column for more information.

Modify your private key password

    1. Open the signature tool.
    2. Click Change Password.
    3. In the Old Password field, type your current private key password.
    4. Click Verify.
    5. In the Change Private Key Password window, type a new password.
    6. Type it again to verify it.
    7. Click OK.

Related topic


   BlackBerry