BlackBerry代碼簽名工具申請(qǐng)及安裝介紹
出于安全和出口控制的原因，RIM必須跟蹤一些敏感BlackBerry應(yīng)用程序編程接口(API)的使用情況。敏感類別或方法在API參考文檔中使用“鎖定”圖標(biāo)或“Signed”字樣表示。如果您在應(yīng)用程序中使用了這些受控類，在您將應(yīng)用程序.cod文件加載到BlackBerry智能手機(jī)之前，您的應(yīng)用程序必須使用簽名工具(由RIM提供)進(jìn)行簽名。完成注冊(cè)流程需要提供有效的信用卡，將收取管理費(fèi)20美元。官網(wǎng)介紹:http://cn.blackberry.com/developers/javaappdev/codekeys.jsp
一、概述
在Blackberry的開(kāi)發(fā)中，如果您的應(yīng)用程序使用了受控API，在加載到Blackberry智能手機(jī)之前，必須使用RIM提供的簽名密鑰對(duì)其進(jìn)行簽名，簽名所用的key需要向RIM申請(qǐng)。本文檔介紹RIM簽名的申請(qǐng)過(guò)程及在公司共用一個(gè)簽名情況下的環(huán)境搭建。
注意：僅當(dāng)要在BlackBerry智能手機(jī)上運(yùn)行應(yīng)用程序時(shí)，才需要對(duì)應(yīng)用程序進(jìn)行注冊(cè)和簽名。使用Blackberry智能手機(jī)模擬器運(yùn)行應(yīng)用程序時(shí)不需要對(duì)其進(jìn)行簽名。
二、簽名申請(qǐng)
要注冊(cè)以獲得BlackBerry運(yùn)行時(shí)、應(yīng)用程序和加密API，您需要填寫(xiě)這一Web表單。注冊(cè)完成后，您將會(huì)通過(guò)電子郵件收到一系列密鑰和相關(guān)安裝說(shuō)明，可用于使用BlackBerry簽名工具對(duì)您的應(yīng)用程序進(jìn)行簽名。完成注冊(cè)流程需要提供有效的信用卡，將收取管理費(fèi)20美元。
注意：通常，密鑰會(huì)在提交必要表單后的48小時(shí)內(nèi)發(fā)送到您的電子郵箱，但有時(shí)這一過(guò)程也會(huì)花費(fèi)長(zhǎng)達(dá)10個(gè)工作日的時(shí)間。中國(guó)申請(qǐng)的簽名，一般需要5到10個(gè)工作日的時(shí)間。因?yàn)槊荑€會(huì)作為附件發(fā)送到郵箱，因此所使用的郵箱需要避免將該郵件作為垃圾郵件過(guò)濾或者自動(dòng)刪除附件。
簽名申請(qǐng)前請(qǐng)準(zhǔn)備：
1)接收密鑰的郵箱
2)具有美元消費(fèi)功能的信用卡(國(guó)內(nèi)的信用卡，Vista和Master)
簽名申請(qǐng)的URL為：https://www.blackberry.com/SignedKeys/
需要填寫(xiě)以下表單1：
對(duì)于中國(guó)的姓名，一般來(lái)說(shuō)，firstname是名，lastname是姓，這個(gè)對(duì)簽名的申請(qǐng)不是關(guān)鍵。接下來(lái)的company填寫(xiě)公司的英文名稱，Email填寫(xiě)要接收密鑰的郵箱，phone填寫(xiě)個(gè)人的電話號(hào)碼，Address、city作為公司的話，填寫(xiě)公司的地址，province一般保持原樣，country選擇china，postal/zipcode填寫(xiě)郵政編碼，Quantity不需要填寫(xiě)。
接下來(lái)填寫(xiě)第二個(gè)表單2：
PIN是指自己定義的密碼，10位數(shù)字，請(qǐng)牢記該密碼，在后續(xù)接收到RIM的密鑰后會(huì)用到。接下去關(guān)于YES/NO的選項(xiàng)是關(guān)于RIM引用加密API相關(guān)，可以進(jìn)一步了解，一般選擇NO就可以。
再接下去是信用卡信息，注意要填寫(xiě)正確，Card Holder Name信用卡持有人的姓名是指信用卡正面的英文名。Card Holder Phone指信用卡持有人的電話，一般直接填寫(xiě)個(gè)人的電話號(hào)碼即可，Card Holder Email指信用卡持有人的Email，可以和上面表單一樣，Credit Card Type信用卡的類型，信用卡正面可以找到;Credit Card Number信用卡號(hào)碼，Expiration Date信用卡過(guò)期時(shí)間，在信用正面可以找到，Credit Cardsecurity Number信用卡安全號(hào)只信用卡背面的三位數(shù)字。如果對(duì)信用卡各項(xiàng)內(nèi)容不清楚，可以從發(fā)卡行的網(wǎng)站或者銀行信用卡電話尋求幫助。
。
填寫(xiě)提交之后，會(huì)出現(xiàn)一個(gè)總結(jié)性的頁(yè)面，在這個(gè)頁(yè)面要求用戶確認(rèn)，最好拷貝或者記錄各項(xiàng)信息，頁(yè)面下面有最終的提交按鈕，按下之后將不可撤銷。在提交之后，一般國(guó)內(nèi)的信用卡消費(fèi)美元會(huì)給你電話確認(rèn)(如果出現(xiàn)這個(gè)，申請(qǐng)成功的可能性就會(huì)很大)。
注意：在申請(qǐng)成功提交之后，會(huì)出現(xiàn)$30的信用卡交易，RIM的回答如下：
| 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. |
大概意思是$30類似于在用信用卡入住酒店時(shí)的凍結(jié)資金，實(shí)際金額在成交之后按照$20結(jié)算。到此，申請(qǐng)的過(guò)程完結(jié)，接下去需要等待RIM答復(fù)，注意，5-10天是指工作日，而非自然日。
三、環(huán)境搭建
在成功申請(qǐng)后，RIM會(huì)發(fā)若干封郵件，其中至少有三封包含附件的郵件，三個(gè)附件分別為：
client-RBB-XXXXXXXXXX.csiclient-RCR-XXXXXXXXXX.csiclient-RRT-XXXXXXXXXX.csi其中XXXXXXXXXX是指申請(qǐng)簽名的clientID。三個(gè)附件為RBB,RRTandRCRkeys.
每封郵件都介紹有附件的使用方法，按照里面的步驟安裝簽名就可以了。內(nèi)容如下：
|
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 of choic e ha s b e e n inst a lle d ont o th e workst a tio n tha t wi l 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 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 to 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 irm . T h i s 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 t h i s proc e s 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 a 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 irm . 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 the 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 t h i s proc e s 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 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: 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 l key s o n th e sam e P C . Yo u should receiv e eac h key/.cs i file i n a s e parat e 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?f u 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 R T Recipient : y o uremail @ rim.com < ------------ - ------- - ----------- -- ------- - ------------ - ------- - ----- - Thi s transmi s sio 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 privil 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 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 . |
注意事項(xiàng)：
1.如果希望簽名工具能夠同時(shí)支持BlackBerryJDE和BlackBerryJavaPluginforEclipse，需要先為BlackBerryJDE安裝.
2.每次要簽名應(yīng)用的時(shí)候，就拷貝cod和csl文件到該機(jī)器，打開(kāi)cod文件完成簽名。
3.如果需要卸載JDE重新安裝，一定要預(yù)先備份以下三個(gè)文件.
【編輯推薦】
