NC系統(tǒng)身份認證方式實現(xiàn)說明文檔

1、nc系統(tǒng)身份認證方式實現(xiàn)說明文檔概述：nc系統(tǒng)是應(yīng)用于高端企業(yè)集團erp應(yīng)用的產(chǎn)品，其地位決定了其系統(tǒng)安全性的重要，包括登錄身份的認證和各種數(shù)據(jù)的安全。nc系統(tǒng)對數(shù)據(jù)的安全性的處理不在本文描述，本文主要闡述系統(tǒng)登錄的身份認證的安全性及認證方式的實現(xiàn)。nc系統(tǒng)默認的身份認證方式是基于靜態(tài)密碼的認證方式。目前，在身份認證領(lǐng)域，也有許多廠家能提供更為安全可靠的認證方式，如ca認證，動態(tài)密碼認證。為了提高nc系統(tǒng)本身在登錄認證方面的安全性，nc系統(tǒng)提供了一套用于集成第三方認證方式的接口，能夠方便地將更為安全的身份認證方式集成到nc系統(tǒng)中，進而加強nc系統(tǒng)在登錄時身份認證的安全性。nc系統(tǒng)身份認證實現(xiàn)說

2、明nc系統(tǒng)的身份認證集成接口主要包含：l 后臺的認證接口：nc.bs.sm.identityverify.iamodel 前臺的預(yù)處理接口：nc.bs.sm.identityverify.iloginpretreatmentl 前臺的認證結(jié)果消息接口：nc.bs.sm.identityverify.iloginresultmessage一般實現(xiàn)某種身份認證方式即實現(xiàn)上述接口。一后臺的認證接口是實現(xiàn)一個身份認證方式必須要實現(xiàn)的一個接口，不過在實際的代碼中，一般都是繼承nc.bs.sm.identityverify.abstractiamode抽象類，它實現(xiàn)了nc.bs.sm.identityve

3、rify.iamode接口。程序員需要實現(xiàn)verify方法，在該方法中進行用戶的身份認證。int verify(nc.vo.sm.login.loginsessbean lsb, nc.vo.sm.uservo uservo);參數(shù)：loginsessbean lsb 主要存儲登錄用戶的一些信息，如用戶編碼，用戶密碼，或其他一些信息（可以有l(wèi)oginsessbean.put（）方法和loginsessbean.get()方法存?。?。uservo uservo 利用lsb中的公司信息和用戶編碼信息在數(shù)據(jù)庫中查找到的nc用戶對象，包含了nc用戶的信息。返回值 int 表示身份認證的結(jié)果，如果身份認

4、證成功，請返回nc.vo.sm.login.iloginresult.login_legalidentity。如果不合法，返回其他自定義的int值，但是自定義的返回值必須大于200 （小于200的返回值分配給系統(tǒng)自己使用）nc.bs.sm.identityverify.abstractiamode類有一個方法是object getparameter(string key)，它的是返回定義在配置文件中的參數(shù)，關(guān)于配置文件，后面將有描述。二前臺的預(yù)處理接口是在前臺運行的，它提供了在調(diào)用后臺認證功能之前進行一些預(yù)處理操作的機會。例如一般在實現(xiàn)某種ca認證方式時，需要從usbkey中讀取用戶信息，以及

5、對挑戰(zhàn)碼進行簽名的操作等等，并將這些挑戰(zhàn)碼傳輸?shù)胶笈_，供身份認證使用，此時即可實現(xiàn)該接口。該接口定義了一個方法void pretreatment(loginsessbean lsb) throws exception，在該方法中進行上述的操作，一些需要傳輸?shù)胶笈_的信息利用lsb傳遞，例如用戶編碼，需要利用lsb.setusercode方式設(shè)置。對于其他用于外系統(tǒng)進行認證的數(shù)據(jù)，如挑戰(zhàn)碼，應(yīng)該使用lsb.put方法設(shè)置到lsb中，供后臺調(diào)用void pretreatment(nc.vo.sm.login.loginsessbean lsb) throws exception參數(shù)：loginses

6、sbean lsb 這里的lsb主要用來存儲一些后臺認證需要的數(shù)據(jù)，可以使用lsb的相關(guān)方法進行設(shè)置，這個lsb對象將傳遞給后臺的認證方法verify(nc.vo.sm.login.loginsessbean lsb, nc.vo.sm.uservo uservo);中的參數(shù)lsb。異常：出現(xiàn)一些需要終止操作的異常，可以拋出如果認證方式中不需要前臺的預(yù)處理過程，可以不實現(xiàn)該接口。三前臺的認證結(jié)果消息接口nc.bs.sm.identityverify.iloginresultmessage的作用主要在于，在我們的認證方法中返回的是int型數(shù)據(jù)，不能直接反饋給用戶，故利用此接口進行認證結(jié)果的映射，

7、將int型的認證結(jié)果翻譯為用戶能夠理解的文字信息，這些文字信息將提示用戶認證失敗的原因。該接口方法定義如下：string getresultmessage(int intresult);參數(shù)： int intresult 該值由后臺認證接口方法返回，返回值 string 返回給用戶的對應(yīng)intresult的提示文字四對于代碼開發(fā)來說，實現(xiàn)上面的接口后，就完成了開發(fā)工作。緊接著就是需要進行一些配置工作，即可在nc系統(tǒng)中使用新的身份認證方式。對于nc3x的版本配置文件為./ierp/bin/iaconfig.xml，它的一般格式為：（例子）nc.bs.uap.ca.camodeca認證nccaus

8、eridmodeusercodetruenc.ui.uap.ca.caloginpretreatmentnc.ui.uap.ca.caloginresult對于nc5x的版本配置文件為./ierp/bin/iaconfig.xml，它的一般格式為：（例子） staticpwdnc.bs.uap.ca.camodeca認證nccauseridmodeusercodetruenc.ui.uap.ca.caloginpretreatmentnc.ui.uap.ca.caloginresult對于，如果程序中不需要額外的參數(shù)配置，可以不需要配置對于，如果認證方式中不需要前臺的預(yù)處理過程，也可以不配置該

9、項對于，如果沒有額外的信息返回，也可以不配置該項附錄：nc系統(tǒng)登錄身份認證相關(guān)包及類nc.bs.sm.identityverify |abstractiamode#身份認證方式抽象類，一般實現(xiàn)某種認證方式都要實現(xiàn)該類|iaconfigfiletool #讀寫身份認證配置文件的工具類|iaconfsetupdlg#和iasetupframe類一起配置身份認證配置文件|iamode#身份認證方式接口類，由abstractiamode實現(xiàn)|iamodefactory#在系統(tǒng)運行時根據(jù)身份認證配置文件構(gòu)造一個認證方式對象|iasetupframe#配置身份認證配置文件的工具|iasetuppanel#

10、配置身份認證配置文件|staticpasswordiamode#系統(tǒng)默認的靜態(tài)密碼認證方式類，它實現(xiàn)了abstractiamodenc.ui.sm.identityverify|defaultloginpretreatment#默認的登錄預(yù)處理類|iloginpretreatment#登錄預(yù)處理接口類。凡在登錄前需要做的工作可實現(xiàn)該類來完成|iloginresultmessage #登錄返回信息類。根據(jù)返回的int值得到string值。nc.vo.sm.identityverify|iaconfigfilevo#對應(yīng)于身份認證方式配置文件的vo類|iaconfvo#對應(yīng)于一種身份認證方式的vo類|iacontext#身份認證上下文類，可以通過該類獲取身份認證方式需要的參數(shù)|iaparametervo #對應(yīng)于身份認證方式的參數(shù)vo類nc.vo.sm.login.loginsessbean的相關(guān)方法：方法名稱方法描述get(string)獲取通過put方法設(shè)置的屬性值put(string, object)設(shè)置key-value屬性值對getpk_crop()獲取公司主鍵值setpk_corp(string)設(shè)置公司主鍵值getusercode()獲取用戶編碼setusercode(