How to apply for and install the code signing tool for BlackBerry Development

This article focuses on the application and installation of the Black Berry code signing tool. For security and exit control reasons, Research In Motion (RIM) must track sensitive Black Berry®Application Programming Interface API) usage.

Introduction to application and installation of the Black Berry code signing Tool

Black Berry development background

Research In Motion (RIM) must track sensitive Black berries for security and exit control reasons®Application Programming Interface API) usage. The sensitive category or method is indicated by the "Lock" icon or "Signed" in the API reference document. If you use these controlled classes in the application. before the cod file is loaded to the Black Berry smartphone, your application must use the signature tool provided by RIM) for signature. A valid credit card is required to complete the registration process, and a management fee of $20 will be charged. Official Website: http://cn.blackberry.com/developers/javaappdev/codekeys.jsp

I. Overview

During Black Berry development, if your application uses a controlled API, you must use the signature key provided by RIM to sign it before loading it to the Blackberry smartphone, the key used for the signature must be applied to RIM. This document describes the application process of RIM signature and the establishment of an environment where the company shares a signature.

Note: You must register and sign the application only when you want to run the application on the BlackBerry smartphone. You do not need to sign an application when using the Blackberry smartphone simulator.

Ii. Signature Application

To register for BlackBerry runtime, application, and encrypted API, enter this Web form. After registration, you will receive a series of key and installation instructions via email, which can be used to sign your application using the BlackBerry signature tool. A valid credit card is required to complete the registration process, and a management fee of $20 will be charged.

Note: Generally, keys are sent to your email within 48 hours after the necessary forms are submitted, but sometimes this process may take up to 10 working days. The signature applied by China generally takes 5 to 10 business days. Because the key is sent to the mailbox as an attachment, you must avoid filtering the email as a spam or automatically deleting the attachment.

Before applying for a BlackBerry development signature:

1) email address for receiving the key

2) domestic credit cards with USD consumption functions, Vista and Master)

Signed request URL: https://www.blackberry.com/SignedKeys/

Enter the following form 1:

For Chinese names, firstname is generally the first name and lastname is the last name. This signature application is not critical. In the following example, enter the company name in English, Email enter the Email Address for receiving the key, phone enter the personal phone number, Address and city as the company, and enter the company Address, generally, province remains unchanged. china, postal, and zipcode are selected for country to enter the zip code, and Quantity is not required.

Next, enter Form 2:

 

PIN refers to your own password, which is a 10-digit number. Remember this password and will be used after receiving RIM's key. Next, the options about YES/NO are related to RIM's reference to the encrypted API. For more information, select NO.

The next step is the credit card information. Be sure to enter the correct information. The name of the CardHolderName credit card holder refers to the English name on the front of the credit card. CardHolderPhone refers to the phone number of the credit card holder. Generally, you can enter your personal phone number directly. CardHolderEmail refers to the Email address of the credit card holder. It can be found on the front of the credit card, just like in the form above; creditCardNumber: Credit card number. ExpirationDate: expiration time of the credit card. You can find it on the front of the credit card. CreditCardsecurityNumber is only three digits on the back of the credit card. If you are not clear about the credit card content, you can seek help from the Bank's website or bank's credit card phone number.

After you fill in the submission, a summary page will appear. on this page, ask the user to confirm, it is best to copy or record the information, there is a final submit button under the page, the press will not be undone. After the submission, the general domestic credit card payment USD will give you a call to confirm if this occurs, the possibility of successful application will be great ).

Note: after the application is successfully submitted, a $30 credit card transaction will appear. RIM's answer is as follows:

Theinitial $30 seconds, thisamountishigherthanthelisted $20 feetoaccountforcurrencychanges, taxesetc. Thisisatemporaryvalueandwillnotremainonyourbill, theactualamountforthesis key$ 20.

It means that $30 is similar to the frozen funds when you use a credit card to stay in the hotel. The actual amount is settled at $20 after the deal.

At this point, the application process is complete, and you need to wait for RIM to reply. Note that 5-10 days refers to the working day rather than the natural day.

Iii. setup of the BlackBerry signature development tool environment

After successful application, RIM will send several emails, including at least three emails containing attachments. The three attachments are:

Client-RBB-XXXXXXXXXX.csi

Client-RCR-XXXXXXXXXX.csi

Client-RRT-XXXXXXXXXX.csi

XXXXXXXXXX indicates the clientID for the request signature. The three attachments are RBB and RRTandRCRkeys.

Each email introduces how to use attachments. you can install the signature according to the steps in the email. The content is as follows:

 
 

  
  
ThefollowingattachmentwillallowtheBlackBerrySignatureTooltoregisterwiththeSigningAuthority.  
  
  
 
  
  
PleaseensurethattheBlackBerrydevelopmenttoolofchoicehasbeeninstalledontotheworkstationthatwillbeusedtosignyourBlackBerryapplications.  
  
  
 
  
  
Toregistertheattachment,pleasefollowtheinstructionsbelow:  
  
  
 
  
  
 
  
  
IfyouplantouseboththeBlackBerryJDEandBlackBerryJDEPlug-inforEclipseinstallthesignaturekeysusingtheBlackBerryJDE.  
  
  
 
  
  
Thisshouldallowyoutosignfromeithertool.  
  
  
 
  
  
BlackBerryJDEorBlackBerryJDEComponentPackageUsers:  
  
  
 
  
  
1)Double-clickontheattachment.  
  
  
 
  
  
2)Ifadialogboxappearsthatstatesthataprivatekeycannotbefound,completesteps3through6beforeyoucontinue.Otherwise,proceedtostep7.  
  
  
 
  
  
3)Click"Yes"tocreateanewkeypairfile.  
  
  
 
  
  
4)Typeapasswordforyourprivatekeyofatleast8characters,andtypeitagaintoconfirm.Thisisyourprivatekeypassword,  
  
  
 
  
  
whichprotectsyourprivatekey.Pleaserememberthispasswordasyouwillbepromptedforiteachtimesigningisattemptedorasignaturekeyisinstalled.  
  
  
 
  
  
5)Click"Ok"  
  
  
 
  
  
6)Moveyourmousetogeneratedateforanewprivatekey.  
  
  
 
  
  
7)Inthe"RegistrationPIN"field,typethePINnumberthatyousuppliedonthesignaturekeyorderform.  
  
  
 
  
  
8)InthePrivateKeypasswordfield,typethepasswordcreatedinstep4.  
  
  
 
  
  
9)Click"Register".  
  
  
 
  
  
10)Click"Exit".  
  
  
 
  
  
11)Repeatthisprocessfortheother.csifiles.  
  
  
 
  
  
 
  
  
BlackBerryJDEPlug-inforEclipseUsers:  
  
  
 
  
  
1)Saveall3.csifilesinthesamedirectory(eachonewillbesentinaseparateemailmessage).  
  
  
 
  
  
2)StartEclipse.  
  
  
 
  
  
3)ClickontheBlackBerrymenuandchooseInstallSignatureKeys.  
  
  
 
  
  
4)Selectoneofthe3.csifilessavedinstep1andclickOpen.  
  
  
 
  
  
5)Click"Yes"tocreateanewkeypairfile.  
  
  
 
  
  
6)Typeapasswordforyourprivatekeyofatleast8characters,andtypeitagaintoconfirm.  
  
  
 
  
  
Thisisyourprivatekeypassword,whichprotectsyourprivatekey.Pleaserememberthispasswordasyouwillbepromptedforiteachtimesigningisattemptedorasignaturekeyisinstalled.  
  
  
 
  
  
7)Moveyourmousetogeneratedateforanewprivatekey.  
  
  
 
  
  
8)IntheRegistrationPIN"field,typethePINnumberthatyousuppliedonthesignaturekeyorderform.  
  
  
 
  
  
9)InthePrivateKeypasswordfield,typethepasswordcreatedinstep6.  
  
  
 
  
  
10)Click"Register".  
  
  
 
  
  
11)Click"Exit".  
  
  
 
  
  
12)Repeatthisprocessfortheothercsifiles.  
  
  
 
  
  
 
  
  
 
  
  
BlackBerryWidgetSDK,BlackBerryWebDevelopmentPlug-inforEclipseorBlackBerryPlug-inforMicrosoftVisualStudioUsers:  
  
  
 
  
  
1)Atthecommandprompt,navigatetothebinfolderwithintheBlackBerryWidgetPackagerinstallationdirectory.Defaultdirectoriesare:  
  
  
 
  
  
BlackBerryWidgetSDKandBlackBerryPlug-inforMicrosoftVisualStudio:  
  
  
 
  
  
C:\ProgramFiles\ResearchInMotion\BlackBerryWidgetPackager\binBlackBerryWebDevelopmentPlug-inforEclipse:  
  
  
 
  
  
<EclipseInstallation>\plugins\net.rim.browser.tools.wcpc\wcpc\binC:\ProgramFiles\ResearchInMotion\BlackBerryWidgetPackager\bin  
  
  
 
  
  
2)Typethefollowingcommand,includingthefullpathofthe.csifile:  
  
  
 
  
  
java-jarSignatureTool.jar<.csifilepath> 
  
  
 
  
  
3)Ifadialogthataprivatekeycannotbefoundappears,performthefollowingactions:  
  
  
 
  
  
a.ClickYes.  
  
  
 
  
  
b.Typeapasswordfortheprivatekey.  
  
  
 
  
  
c.Typethepasswordtoconfirmit.  
  
  
 
  
  
d.ClickOK.  
  
  
 
  
  
e.Movethemousetogeneratedataforthenewprivatekey.  
  
  
 
  
  
4)IntheRegistrationPINfield,typethePINthatRIM.provided.  
  
  
 
  
  
5)InthePrivateKeyPasswordfield,typeapasswordofatleasteightcharacters.Thisistheprivatekeypassword.  
  
  
 
  
  
6)ClickRegister.  
  
  
 
  
  
7)ClickExit.  
  
  
 
  
  
 
  
  
Importantinformationforallusers:  
  
  
 
  
  
Note:All3keys(RBB,RCR,RRT)receivedneedtobeinstalledonthesamePC.ThesamepasswordmustbespecifiedforallkeysonthesamePC.Youshouldreceiveeachkey/.csifileinaseparateemailmessage.  
  
  
 
  
  
ForfurtherinformationonBlackBerryControlledAPIsandsigningofapplications,pleaserefertotheBlackBerrySignatureToolDeveloperGuideversion4.2.0,foundatthefollowinglink:  
  
  
 
  
  
http://www.blackberry.com/knowledgecenterpublic/livelink.exe/fetch/2000/8067/645045/8655/8656/1271077/BlackBerry_Signature_Tool_Developer_Guide.pdf?nodeid=1271325&vernum=0 
  
  
 
  
  
Pleasenote:Whenregisteringwiththesigningauthority,ensurethatyouhavecorrectlyenteredyourregistrationPINnumber.IfyouentertheincorrectPIN5times,yourkeyswillbedeactivated.  
  
  
 
  
  
Troubleshooting:  
  
  
 
  
  
IfyouarehavingdifficultyinstallingorregisteringyoursignaturekeyspleasechecktheSignatureKeyandCodesigningsectionoftheDeveloperKnowledgeBasefoundhere:http://www.blackberry.com/knowledgecenterpublic/livelink.exe?func=ll&objId=800989&objAction=browse&sort=name 
  
  
 
  
  
Ifyoucontinuetoexperienceissuespleasecontactdevsupport@rim.com.  
  
  
 
  
  
BestofluckwithyourdevelopmentandthankyouforyourinterestinBlackBerry.  
  
  
 
  
  
Regards,BlackBerryApplicationDevelopmentSupportTeamhttp://www.blackberrydeveloper.com  
  
  
 
  
  
DateIssued:Tuesday,March16,2010@14:54:15KeysIssued:RRT  
  
  
 
  
  
Recipient:youremail@rim.com  
  
  
 
  
  
<<client-RRT-207634362.csi>> 
  
  
 
  
  
---------------------------------------------------------------------  
  
  
 
  
  
Thistransmission(includinganyattachments)maycontainconfidentialinformation,privilegedmaterial(includingmaterialprotectedbythesolicitor-clientorotherapplicableprivileges),orconstitutenon-publicinformation.Anyuseofthisinformationbyanyoneotherthantheintendedrecipientisprohibited.Ifyouhavereceivedthistransmissioninerror,  
  
  
 
  
  
pleaseimmediatelyreplytothesenderanddeletethisinformationfromyoursystem.  
  
  
 
  
  
Use,dissemination,distribution,orreproductionofthistransmissionbyunintendedrecipientsisnotauthorizedandmaybeunlawful.  
  
  
 
 
 

Note:

1. If you want the signing tool to support both BlackBerryJDE and BlackBerryJavaPluginforEclipse, you must first install BlackBerryJDE

2. Each time you sign the application, copy the cod and csl files to the machine and open the cod file to complete the signature.

3. If you need to uninstall JDE and reinstall it, you must back up the following three files in advance.