How to apply for and install the BlackBerry code signing Tool

For security and exit control, RIM must track the usage of some sensitive BlackBerry Application programming interfaces (APIS. 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. your application must use a signature tool (provided by RIM) to sign the cod file before it is loaded to the BlackBerry smartphone. 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 Blackberry 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 signature, prepare:

1) email address for receiving the key

2) credit card with USD consumption function (domestic credit card, 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 credit Card Holder refers to the English Name on the front of the credit Card. Card Holder Phone refers to the Phone number of the Credit Card Holder. Generally, you can enter your personal Phone number directly. Card Holder Email refers to the Email of the Credit Card Holder, which can be the same as the above form, the front of the Credit Card can be found; Credit Card Number, Expiration Date Credit Card Expiration time can be found on the front of the Credit Card, Credit Cardsecurity Number Credit Card security Number 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 you submit the ticket, the general domestic credit card payment USD will be sent to you by phone for confirmation (if this occurs, the application is likely to be successful ).

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

The ini tial $3 0 ch arg e is a h o ld in g fe e p la ced by t h e cr edi t card c o m p an y to v erify t h at th e fund s are av ail AB le f o r the t ran s acti on, t h is a mo un t I s high er tha n t h e li st ed $2 0 fe e t o acc oun t fo r curr ency chang es, tax es et c. this is a t e m p o rar y v alu e an d will n o t r em ain o n y o u r bi ll, t h e actual a mo un t fo r t h e key s is $2 0 US.

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,Environment Construction

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

In the client-RBB-XXXXXXXXXX.csiclient-RCR-XXXXXXXXXX.csiclient-RRT-XXXXXXXXXX.csi, XXXXXXXXXX refers to the clientID requesting the 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:

Th e followin g attach m en t wil l all o w th e B l ackBerr y Sig n atureTo o l t o registe r with th e Signin g A uthorit y. pleas e ens u r e tha t th e BlackBer r y devel o pmen t too l Choic e ha s B e n inst a lle d ont o th e workst a tio n tha t wi l B e us e d t o sig n yo u r BlackBerr y a p plicati o ns. T o registe r t h e atta c hment, pleas e follo w th e instruct I on s bel o w: I f yo u pla n t o us e B o t h th e Black B err y jd e an d BlackBe r y jd e p lu g-I n fo r E c lipse instal l th e s ignatur ekey s usin g t h e Blac k Berr y JDE. T hi s sho u l d allo w yo u Sig n fro m ei t he r too l. BlackBerr y j d e o r Bl a ckBerr y jd e c omponen t Packag e Use r s: 1) Double-c lic k o n th e attachme n t. 2) I f a di a lo g bo x appear s tha t state s t ha t a privat e ke y ca n no t B e found, Complet e ste p s 3 thr o ug h 6 befor e yo u con t inue. Otherw I se, pro c ee d t o ste p 7. 3) Clic k "Y es" t o c reat e a ne w k e y pai r file. 4) Typ e a p asswor d fo r you r pri v at e ke y o f a t leas t 8 charac t ers, an d typ e I t agai n t o con f Sert. T h I s you r p r ivat e k e y password, w hic h pr o tect s you r p r ivate key. pleas e r emembe r thi s passwor d a s yo u wil l B e prom p te d fo r I t eac h time Signin g I s a t tempte d o r a signatu r e ke y I s installed. 5) Clic k "O k" 6) Mov e yo u r mous e t o generat e d at e fo r a ne w privat e key. 7) I n th e "Registr a tio n PIN" fi e ld, typ e th e pi n num B e r tha t yo u supplie d on Th e signatur e ke y or d e r form. 8) I n th e P rivat e K e y passwor d f ield, t y p e th e pa s sw o r d crea t e d I n ste p 4. 9) Clic k "R egister ". 10) Clic k "E x it ". 11) Repea t h I s proc e s fo r th e o t he r. cs I files. BlackBerr y j d e Plug-I n fo r Eclips e Users: 1) Sav e al l 3. cs I file s I n th e sam e di r ector y (eac h on e wil l B e sen t I n Separat e ema I l messa g e ). 2) Star t E c lipse. 3) Clic k o n th e Bl a ckBerr y men u an d cho o s e Instal l S I gnatur e Keys. 4) Selec t on e o f t h e 3. cs I fi l e s save d I n ste p 1 a n d clic k Open. 5) Clic k "Y es" t o c reat e a ne w k e y pai r file. 6) Typ e a p asswor d fo r you r pri v at e ke y o f a t leas t 8 charac t ers, an d typ e it agai n t o con f Sert. T h I si s you r p r ivat e k e y password, w hic h pr o tect s you r p r ivate key. pleas e r emembe r thi s passwor d a s yo u wil l B e prom p te d fo r I t eac h time Signin g I s a t tempte d o r a signatu r e ke y I s installed. 7) Mov e yo u r mous e t o generat e d at e fo r a ne w privat e key. 8) I n th e R egistra t io n PIN "fie l d, typ e th e PI N numb e r tha t y o u supplie d o n Signatur e ke y orde r f orm. 9) I n th e P r ivat e K e y passwor d f I eld, ty p e th e passwo r d creat e d I n ste p 6. 10) Clic k "R e gister ". 11) Clic k "E x it ". 12) Repea t h I s proc e s fo r th e o t he r cs I files. BlackBerr y W I dge t sd k, BlackBerr y We B Dev e lopmen t Plu g-I n fo r E clips e or BlackBerr y P l ug-I n f o r Microsof t V isua l S t udi o Users: 1) A t th e co m man d pr o mpt, navigat e t o th e bi n folde r w I t h I n th e BlackBerr y W idge t Package r ins t allatio n directory. Defaul t directorie s a re: BlackBerr y W I dge t sd k an d BlackBe r y Plu g-I n fo r Micro s of t Vis u a l Studio: C: \ Progra m F I les \ Res e arc h I n Moti on \ Black B err y Widge t P ackage r \ bi n BlackBe r ry We B Developm e n t Plug-I n fo r Eclip s e: \ Plugins \ n e t. rim. B r owser. tools. w cp c \ wc p c \ bi n C: \ Pro g ra m Files \ Resear c h I n Mo t io n \ BlackBer r y Widge t Package r \ bin 2) Typ e th e f ollowin g command, in c ludin g t h e ful l pat h o f th e. cs I file: Jav a-ja r Si g natureT o ol. ja r <. cs I fil e pa t h> 3) I f a dia l o g tha t a privat e ke y canno t B e foun d app e ars, pe r for m th e fol l owing Actions: A. Clic k Yes. B. Typ e a pa s swor d f o r th e privat e key. c. Typ e th e p asswor d t o confir m I t. D. Clic k OK. E. Mov e th e m ous e t o generat e dat a fo r th e ne w privat e key. 4) I n th e Re g istrati o n PI N field, typ e th e PI N tha t RI M. provi d ed. 5) I n th e Pr I vat e Ke y Passwor d fi e ld, typ e a passwor d o f a t le a s t eight Characters. T hi s I s t h e privat e k e y passw o rd. 6) Clic k Reg I ster. 7) Clic k Exi t. Importan t in f ormatio n fo r al l use r s: Note: Al l 3 k ey s (rb B, RCR, RRT) r eceive d nee d t o B e I n stalle d o n th e sam e P C. Th e sam e pas s wor d mu s t B e specifi e d fo r a l key s o n th e sam e P C. yo u shoshould receiv e eac h key /. cs I file I n a s e parat e mai l message. Fo r furth e r inf o rmat I o n on B lackBerr y Con t rolle d ap I s an d sign I n g o f a pplicati o ns, pleas e refe r t o th e BlackBerr y Si g natur e T oo l Develope r Guid e v ersio n 4.2.0, Foun d a t th e followi n g link: Http://www. B l ackberr y. com/knowled g ecenter p ublic/liveli n k.exe/f e tch/200 0/806 7/6450 45/8655/8656/1271077/BlackBerry_S I gnature _ Tool_Develop e r_Guide. pdf? Nodeid = 1 2 71325 & Vernum = 0 Pleas e note: Whe n r e gisterin g wi t h th e s I gnin g author I ty, ens u r e tha t yo u h ave Correctl y en t ere d yo u r registrati o n pi n n u mber. I f yo u ente r t h e incor r ec t PI N 5 Times, you r k ey s wil l B e deactiva t ed. Troubleshoot I ng: I f yo u ar e h a vin g di f ficult y inst a llin g o r registerin g you r si g natur e key s p lease chec k th e Si g natur e K e y an d Cod e s ignin g s ectio n o f th e Develo p e r Knowledg e Base foun d here: http://www. B l ackberr y. com/knowled g ecenter public/liveli n k.exe? Fu nc = ll & objId = 8 00989 & ObjAction = B r owse & so r t = name I f yo u conti n u e t o e x perienc e iss u e s plea s e contac t de v support @ rim. co m. Bes t o f luc k wit h yo u r developmen t an d th a n k yo u fo r y o u r inte r es t I n Black B erry. Regards, BlackBerr y A p plicati o n Developmen t Suppor t Team Http://www. B l ackberr y developer.com Dat e Issued: Tuesday, Marc h 16, 2 0 1 0 @ 14: 54: 1 5 Key s I s sued: R T Recipient: y o uremail @ rim.com < > --------------------------------------------------------------------- Thi s transmi s SiO2 n (I n cludin g an y a ttachme n ts) ma y cont a I n conf I dential Information, privile g e d materia l (includi n g materia l p r otecte d B y th e solic I to r- Clien t o r ot h e r appl I cabl e pridevil e ges), o r constitut e n o n-publ I c in formatio n. any us e o f t hi s in f ormat I o n B y a n yon e o t he r t h a n th e I ntende d reci p ien t I s prohibit e d. I f yo u hav e r eceive d thi s transmi s sio n I n error, pleas e immedi a tel y repl y t o the sende r an d e let e th I s informatio n fro m y o u r system. U s e, diss e mination, distribution, o r rep r oductio n o f t hi s tra n smissio n B y u nintend e d recipient s is No t authoriz e d an d m a y B e unlawfu l.

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.