金仕達(dá)衛(wèi)寧統(tǒng)一認(rèn)證及單點登錄接口規(guī)范

1、1 / 19Winning3Qfl金仕達(dá)衛(wèi)寧單點登錄及統(tǒng)一認(rèn)證接口規(guī)范目錄第一章 單點登錄4一、概述4二、業(yè)務(wù)流程說明4第二章 統(tǒng)一認(rèn)證5一、概述5二、 交互流程圖5第三章 統(tǒng)一權(quán)限管理7一、概述7二、交互流程圖7第四章 服務(wù)接口說明75 / 19Winning3Qfl文檔修訂日期版本描述作者2014-05-201.0初稿更龍Win n 麗 依第一章單點登錄一、概述用戶只需登錄一次，即可通過單點登錄系統(tǒng)，訪問醫(yī)院的多個應(yīng)用系統(tǒng)，二次登陸時無需 重新輸入用戶名和密碼。、業(yè)務(wù)流程說明結(jié)束登錄單點登錄系統(tǒng)：用戶首先啟動單點登錄系統(tǒng)，并輸入平臺用戶名和密碼進(jìn)入單點登錄系 統(tǒng)。平臺用戶名及密碼的維護(hù)可在

2、平臺管理界面中進(jìn)行維護(hù)。帶參啟動業(yè)務(wù)系統(tǒng)：單點登錄系統(tǒng)啟動業(yè)務(wù)系統(tǒng)的程序， 并傳入相應(yīng)的參數(shù)。業(yè)務(wù)系統(tǒng)可以 是C/S或者B/S結(jié)構(gòu)的程序，分別采用啟動EXE帶參和調(diào)用URL地址的方式。具體的參數(shù)如 下：序號參數(shù)符號參數(shù)值備注1ptflagPTSSO固定值2appid業(yè)務(wù)系統(tǒng)的ID業(yè)務(wù)系統(tǒng)在單點登錄系統(tǒng)中注冊時分配白程序ID,由單點登錄系統(tǒng)管理員提供3userid單點登錄系統(tǒng)中用戶ID4loginid業(yè)務(wù)系統(tǒng)中用戶登錄ID5captcha驗證碼6loginflag登錄標(biāo)志首次登錄時為1,非首次登錄為27extendparam可擴(kuò)展參數(shù)XML格式，key、value 的形式 實現(xiàn)，空的參數(shù)會傳入-

3、'符 號。暫空判斷l(xiāng)oginflag值：業(yè)務(wù)系統(tǒng)讀取參數(shù)中的loginflag值，根據(jù)不同的值進(jìn)行不同的業(yè)務(wù)流轉(zhuǎn)。驗證本地用戶名和密碼：業(yè)務(wù)系統(tǒng)根據(jù)loginflag判斷是否彈出登錄界面，當(dāng) loginflag 為1時彈出登錄界面。用戶輸入業(yè)務(wù)系統(tǒng)本地的用戶名和密碼，業(yè)務(wù)系統(tǒng)按照本地的驗證邏輯驗證成功后進(jìn)入下面的步驟。不成功則再次彈出登錄界面。調(diào)用注冊用戶信息： 首次登錄時，業(yè)務(wù)系統(tǒng)驗證本地系統(tǒng)的用戶名和密碼成功后，將登錄的用戶ID和用戶名稱通過服務(wù)注冊到平臺。如果業(yè)務(wù)系統(tǒng)采用的用戶信息和單點登錄系統(tǒng)是同一套則此過程可以省略。詳見 注冊用戶信息服務(wù)。調(diào)用登錄安全驗證：業(yè)務(wù)系統(tǒng)被啟動之后

4、需調(diào)用認(rèn)證服務(wù)的驗證服務(wù)，以確保此次啟動是合法的。詳見登錄安全驗證服務(wù)。調(diào)用通知關(guān)閉服務(wù)：業(yè)務(wù)系統(tǒng)關(guān)閉前需要調(diào)用平臺服務(wù)關(guān)閉通知服務(wù)通知單點登錄系統(tǒng)。詳見關(guān)閉通知服務(wù)。關(guān)閉程序：單點登錄系統(tǒng)根據(jù)通知進(jìn)行相應(yīng)處理，并返回結(jié)果。業(yè)務(wù)系統(tǒng)根據(jù)此結(jié)果選擇關(guān)閉系統(tǒng)與否。第二章統(tǒng)一認(rèn)證一、概述對用戶的用戶名進(jìn)行統(tǒng)一的管理和維護(hù)，對各個業(yè)務(wù)系統(tǒng)的用戶名和密碼的管理。同時能夠提供服務(wù)的方式與各業(yè)務(wù)系統(tǒng)進(jìn)行數(shù)據(jù)交換。注意：本章節(jié)只考慮從業(yè)務(wù)系統(tǒng)直接登錄的情況，如果采用單點登錄方式登錄請參考第早。交互流程圖7 / 19平臺用戶維護(hù)：平臺管理員在平臺管理界面中對平臺的用戶進(jìn)行維護(hù)，包括新增、修改和刪除。業(yè)務(wù)系統(tǒng)信息

5、注冊：業(yè)務(wù)系統(tǒng)通過調(diào)用平臺的 業(yè)務(wù)系統(tǒng)信息注冊服務(wù) 將業(yè)務(wù)系統(tǒng)的信息注冊到平臺統(tǒng)一認(rèn)證系統(tǒng)中。業(yè)務(wù)系統(tǒng)用戶登錄（平臺用戶名和密碼）：在業(yè)務(wù)系統(tǒng)彈出的登錄界面中輸入平臺用戶名和密碼。注意緩存平臺的用戶名。調(diào)用平臺認(rèn)證服務(wù)：業(yè)務(wù)系統(tǒng)通過調(diào)用平臺的 統(tǒng)一認(rèn)證服務(wù) 驗證用戶名及密碼。調(diào)用此服務(wù)可能有三種返回值的情況， 詳見服務(wù)描述。當(dāng)業(yè)務(wù)系統(tǒng)的用戶與平臺用戶采用同一套時，返回值中是不會出現(xiàn) AR的情況，接下來的流程可以省略。業(yè)務(wù)系統(tǒng)用戶登錄（業(yè)務(wù)系統(tǒng)用戶名和密碼）：業(yè)務(wù)系統(tǒng)再次彈出登錄界面，但是與“業(yè)務(wù)系統(tǒng)用戶登錄（平臺用戶名和密碼） ”情況不同。在此登錄界面輸入業(yè)務(wù)系統(tǒng)的用戶名和密碼，并且驗證是業(yè)務(wù)

6、系統(tǒng)本地的驗證。本地驗證：業(yè)務(wù)系統(tǒng)采用本系統(tǒng)的用戶名和密碼驗證邏輯。調(diào)用用戶注冊服務(wù)：業(yè)務(wù)系統(tǒng)調(diào)用平臺的 業(yè)務(wù)系統(tǒng)用戶注冊服務(wù) 上傳本地用戶并與平臺用戶 進(jìn)行綁定。進(jìn)入業(yè)務(wù)系統(tǒng)：業(yè)務(wù)系統(tǒng)通過驗證后加載數(shù)據(jù)。修改平臺密碼： 業(yè)務(wù)系統(tǒng)調(diào)用平臺的統(tǒng)一修改密碼服務(wù)，修改平臺中的密碼。修改本地密碼：業(yè)務(wù)系統(tǒng)修改平臺密碼成功后修改本地密碼，保持本地密碼與平臺密碼同步。第三章統(tǒng)一權(quán)限管理一、概述對業(yè)務(wù)系統(tǒng)的所有權(quán)限點進(jìn)行統(tǒng)一的管理和維護(hù)，業(yè)務(wù)系統(tǒng)通過平臺服務(wù)進(jìn)行權(quán)限點信息的交互。二、交互流程圖上傳權(quán)限點：業(yè)務(wù)系統(tǒng)調(diào)用平臺的業(yè)務(wù)系統(tǒng)權(quán)限信息注冊服務(wù)，將業(yè)務(wù)系統(tǒng)的權(quán)限信息上傳到平臺中進(jìn)行統(tǒng)一管理。角色與權(quán)限點維

7、護(hù)：平臺管理員通過管理程序?qū)巧蜋?quán)限的信息進(jìn)行維護(hù)。用戶與角色維護(hù)：平臺管理員通過管理程序?qū)巧蜋?quán)限的信息進(jìn)行維護(hù)。調(diào)用用戶權(quán)限信息：業(yè)務(wù)系統(tǒng)在成功通過平臺的統(tǒng)一驗證之后，調(diào)用獲取用戶權(quán)限服務(wù)來加載權(quán)限信息。具體詳見獲取用戶在業(yè)務(wù)系統(tǒng)的權(quán)限服務(wù)第四章 服務(wù)接口說明采用WEBSERVICE方式提供服務(wù)。有如下服務(wù)：業(yè)務(wù)系統(tǒng)信息注冊痂Win n 麗 依業(yè)務(wù)系統(tǒng)權(quán)限信息注冊業(yè)務(wù)系統(tǒng)用戶注冊獲取用戶在業(yè)務(wù)系統(tǒng)的權(quán)限登錄安全驗證獲取已注冊的業(yè)務(wù)系統(tǒng)列表獲取已注冊的業(yè)務(wù)系統(tǒng)權(quán)限列表統(tǒng)一認(rèn)證時登錄驗證關(guān)閉單點登錄窗口修改用戶密碼平臺服務(wù)主要分為三大類：注冊服務(wù)：1、業(yè)務(wù)系統(tǒng)信息注冊。函數(shù)名Applica

8、tionRegister(string inputdata)應(yīng)用場景啟用統(tǒng)一登錄及統(tǒng)一認(rèn)證前，業(yè)務(wù)系統(tǒng)將系統(tǒng)信息注冊到平臺。輸入?yún)?shù)說明appidvarchar(30)業(yè)務(wù)系統(tǒng)ID?？捎舍t(yī)院預(yù)先分配好appnamevarchar(40)業(yè)務(wù)系統(tǒng)的名稱appversionvarchar(10)業(yè)務(wù)系統(tǒng)的版本companynamevarchar(50)所屬公司的名稱decriptionvarchar(100)系統(tǒng)的描述信息格式<?xml version="1.0" encoding="GB2312" standalo<data><ap

9、pid>業(yè)務(wù)系統(tǒng) ID</appid><appname>系統(tǒng)名稱 </appname>ne="yes"?><appversion >系統(tǒng)版本號 </appversion ><companyname"公司名稱 </companynam><decription >系統(tǒng)的描述信息 </decription >Winning3Qfl<technicaltype >程序架構(gòu) 0:C/S 1:B/S</technicaltype ><

10、/data>返回值參數(shù)retcodeString狀態(tài)碼，AA成功AE:失敗msgstring失敗原因格式<?xml version="1.0" encoding="GB2312" standalone="yes"?><output><retcode> 狀態(tài)碼 </retcode><msg>失敗原因</msg></ output >函數(shù)PermissionRegister (string inputdata)應(yīng)用場景啟用統(tǒng)一登錄及統(tǒng)一認(rèn)證前，業(yè)務(wù)系

11、統(tǒng)將系統(tǒng)的權(quán)限信息注冊到平臺。便于平臺統(tǒng)一維護(hù)用戶權(quán)限。輸入?yún)?shù)說明appidvarchar(30)業(yè)務(wù)系統(tǒng)注冊后被分配的IDpermissionidvarchar(30)業(yè)務(wù)系統(tǒng)分配的權(quán)限IDpermissionnamevarchar(255)權(quán)限名稱permissiondescvarchar(255)權(quán)限描述permissiontypevarchar(20)權(quán)限類型，由業(yè)務(wù)系 統(tǒng)自己定義，如菜單、 控件等。parentidvarchar(20)父權(quán)限ID無父權(quán)限時傳空havechildpermissionVarchar(1)是否后于權(quán)限，0:無1：有業(yè)務(wù)系統(tǒng)權(quán)限信息注冊。2、operati

12、ontypeVarchar操作類別：0增加1修改2刪除格式<?xml version="1.0" encoding<data><appid >業(yè)務(wù)系統(tǒng) ID </app<permissionid > 權(quán)PM ID</permissionname > 權(quán)限:="GB2312" standalone="yes"?>id > permissionid >各稱 </permissionname ><permissiondesc >權(quán)限寸苗述

13、</permissiondesc >permissiontype >權(quán)限類型 </ permissiontype ><parentid >父權(quán)限 ID</parentid ><havechildpermission是含有子權(quán)限 </havechildpermission >operationtype >操作英另1J </operationtype ></data>返回值參數(shù)retcodeString狀態(tài)碼，AA:成功AE:失敗msgstring失敗原因格式<?xml version=&q

14、uot;1.0" encoding="GB2312" standalone="yes"?><output><retcode>狀態(tài)力馬 </retcode><msg>失敗原因</msg></output >3、業(yè)務(wù)系統(tǒng)用戶注冊。函數(shù)LoginInfoRegister (string inputdata)應(yīng)用場景首次使用單點登錄系統(tǒng)登錄業(yè)務(wù)系統(tǒng)時調(diào)用。目的是映射業(yè)務(wù)系統(tǒng)用戶與平臺用戶輸入?yún)?shù)說明Appidvarchar(30)業(yè)務(wù)系統(tǒng)注冊后被分配的IDUseridvarc

15、har(20)平臺中統(tǒng)一用戶的IDLoginidvarchar(20)業(yè)務(wù)系統(tǒng)中登錄的ID。LoginnameVarchar(40)業(yè)務(wù)系統(tǒng)中的用戶名Passwordvarchar(40)暫不用，傳空格式<?xml version="1.0" encoding="GB2312" standalone="yes"?><data><appid>系統(tǒng) ID</appid><userid >平臺用戶 ID</userid ><loginid >業(yè)務(wù)系統(tǒng)的用戶

16、ID</loginid ><loginname >業(yè)務(wù)系統(tǒng)的用戶名稱 </loginname >password >密碼 </ password ></data>返回值參數(shù)RetcodeString狀態(tài)碼，AA成功AE:失敗Msgstring失敗原因格式<?xml version="1.0" encoding="GB2312" standalone="yes"?><output><retcode> 狀態(tài)碼 </retcode&g

17、t;<msg>失敗原因</msg></ output >4、用戶密碼修改函數(shù)UpdatePassword (string inputdata)應(yīng)用場景業(yè)務(wù)系統(tǒng)修改平臺用戶密碼時調(diào)用此方法。輸入?yún)?shù)說明appidvarchar(30)業(yè)務(wù)系統(tǒng)注冊后被分配的IDloginidvarchar(20)業(yè)務(wù)系統(tǒng)中登錄的ID。oldpasswordvarchar(40)newpasswordvarchar(40)格式<?xml version="1.0" encoding="GB2312" standalone="

18、yes"?><data><appid>系統(tǒng) ID</appid><loginid >業(yè)務(wù)系統(tǒng)的用戶 ID</loginid ><oldpassword >舊密碼 </old password ><new password>新密碼 </new password ></data>返回值參數(shù)RetcodeString狀態(tài)碼，AA成功AE:失敗Msgstring失敗原因格式<?xml version="1.0" encoding="

19、GB2312" standalone="yes"?><output><retcode> 狀態(tài)碼 </retcode><msg>失敗原因</msg></ output >查詢服務(wù)：1、獲取用戶在業(yè)務(wù)系統(tǒng)的權(quán)限。函數(shù)QueryUserPermissionList(string inputdata)應(yīng)用場景通過單點登錄系統(tǒng)登錄業(yè)務(wù)系統(tǒng)后，調(diào)用此函數(shù)獲取用戶在本系統(tǒng)的權(quán)限。例如：登錄 HIS系統(tǒng)后，可先獲取最頂層權(quán)限 （用戶能進(jìn)入哪些子系統(tǒng)）；進(jìn) 入子系統(tǒng)時，冉族取用戶能進(jìn)入哪些菜單的權(quán)限。傳入

20、參數(shù)說明applicationidvarchar(30)業(yè)務(wù)系統(tǒng)注冊后被分配的IDuseridvarchar(10)業(yè)務(wù)系統(tǒng)的用戶IDparentidVarchar(30)父權(quán)限ID-1是返回所有權(quán)限、為空時返回A級權(quán)限、其他則返回其對應(yīng)的子權(quán)限permissiontypeVarchar(20)權(quán)限類別ID為空時返回所有權(quán)限格式<?xml version="1.0" encoding="GB2312" standalone="yes"?><data><applicationid>系統(tǒng) ID</

21、applicationid ><userid >業(yè)務(wù)系統(tǒng)的用戶 ID</userid ><parentid >父權(quán)限 ID</ parentid >permissiontype >權(quán)限類另ij ID</permissiontype ></data>返回值參數(shù)retcodeString狀態(tài)碼，AA成功AE:失敗msgstring失敗原因格式<?xml version="1.0" encoding="GB2312" standalone="yes"?

22、><output><retcode> 狀態(tài)碼 </retcode><msg>失敗原因</msg><dataset><row><perimssionid>權(quán)PM ID</perimssionid><perimssionname>權(quán)限名稱 </perimssionname><perimssiondesc>權(quán)限寸苗述 </perimssiondesc><fatherpermissionid>父權(quán)限 ID</fatherpe

23、rmissionid>permissiontype>權(quán)限類型 ID</permissiontype></row><row><perimssionid>權(quán)PM ID</perimssionid><perimssionname>權(quán)限名稱 </perimssionname >15 / 19Winning3Qfl<perimssiondesc<fatherpermissionidpermissiontype</row>權(quán)限才苗述 </perimssiondesc>>

24、父權(quán)限 ID</fatherpermissionid>權(quán)限類型 ID</permissiontype>></dataset></ output >2、獲取已注冊的業(yè)務(wù)系統(tǒng)列表。函數(shù)QueryApplicationList(string inputdata)應(yīng)用場景查詢本系統(tǒng)是否已注冊，獲取所有史注冊的系統(tǒng)。輸入?yún)?shù)說明格式<?xml version="1.0" encoding="GB2312" standalone="yes"?><data></da

25、ta>返回值參數(shù)retcodeString狀態(tài)碼，AA:成功AE:失敗msgString失敗原因格式<?xml version="1.0" encoding="GB2312" standalone="yes"?><output><retcode> 狀態(tài)碼 </retcode><msg>失敗原因</msg><dataset><row><systemid>系統(tǒng) ID</systemid >systemname &g

26、t;系統(tǒng)名稱 </systemname ><systemdescript>系統(tǒng)描述 </systemdescript><version >版本號 </version ><company >公司名稱 </company ></row><row><systemid>系統(tǒng) ID</systemid><systemname >系統(tǒng)名稱 </systemname ><systemdescript>系統(tǒng)描述 </systemdescr

27、ipt>version>版本號 </version>company >公司名稱 </company ></row></dataset></ output >3、獲取已注冊的業(yè)務(wù)系統(tǒng)權(quán)限列表。函數(shù)QueryPermissionList(string inputdata)應(yīng)用場景查詢本系統(tǒng)已注冊過的權(quán)限，在不確定已注冊過哪些權(quán)限的情況下可調(diào)用本 服務(wù)。傳入?yún)?shù)說明applicationidvarchar(30)業(yè)務(wù)系統(tǒng)注冊的ID格式<?xml version="1.0" encoding=&qu

28、ot;GB2312" standalone="yes"?><data>applicationid>系統(tǒng) ID</applicationid ></data>返回值參數(shù)retcodeString狀態(tài)碼，AA:成功AE：失敗msgString失敗原因格式<?xml version="1.0" encoding="GB2312" standalone="yes"?><output><retcode> 狀態(tài)碼 </retco

29、de><msg>失敗原因</msg><dataset><row><systemid>業(yè)務(wù)系統(tǒng) ID</systemid><permissionid >權(quán)5M ID</permissionid ><permissionname >權(quán)限名稱 </permissionname >< permissiondesc >權(quán)限寸苗述 </permissiondesc >< permissiontype >權(quán)限類型 ID</permission

30、type >< permissiontypename>權(quán)限類型名稱 </permissiontypename >< fatherpermissionid >父權(quán)限 ID</fatherpermissionid >< inputtime> 注冊時間 </inputtime></row><row><systemid>系統(tǒng) ID</systemid ><permissionid >權(quán)PM ID</permissionid ><permission

31、name >權(quán)限名稱 </permissionname >< permissiondesc >權(quán)限寸苗述 </permissiondesc >< permissiontype >權(quán)限類型 ID</permissiontype >< permissiontypename>權(quán)限類型名稱 </permissiontypename >< fatherpermissionid >父權(quán)限 ID</fatherpermissionid >< inputtime> 注冊時間 </

32、inputtime></row></dataset>< / output >驗證服務(wù)：Winning3Qfl1、登錄安全驗證。函數(shù)LoginVerify (string inputdata)應(yīng)用場景從單點登錄窗口登錄業(yè)務(wù)系統(tǒng)時， 會以參數(shù)形式傳遞給業(yè)務(wù)系統(tǒng)一個驗證碼，然后再調(diào)用此函數(shù)驗證是否是安全登錄，返回值為AA時應(yīng)成功登錄，否則應(yīng)拒絕登錄。傳入?yún)?shù)說明applicationidvarchar(20)當(dāng)前登錄的業(yè)務(wù)系統(tǒng)IDloginidvarchar(10)當(dāng)前登錄的業(yè)務(wù)系統(tǒng)用戶IDmacaddressVarchar(40)當(dāng)前做登錄操作的電腦mac

33、地址captchaVarchar(40)登錄時平臺傳入的驗證碼格式<?xml version="1.0" encoding="GB2312" standalone="yes"?><data><applicationid>系統(tǒng) ID</applicationid ><loginid >當(dāng)前登錄的業(yè)務(wù)系統(tǒng)用戶ID</loginid ><macaddress >當(dāng)前彳出登錄操作的電腦mac地址</macaddress ><captcha &

34、gt;登錄時平臺傳入的驗證碼</captcha ></data>返回值參數(shù)retcodeString狀態(tài)碼，AA:成功AE:失敗msgstring失敗原因格式<?xml version="1.0" encoding="GB2312" standalone="yes"?><output><retcode>狀態(tài)力馬 </retcode><msg>失敗原因</msg></output >2、統(tǒng)一認(rèn)證時登錄驗證。函數(shù)CertificationLoginVerify(string inputdata)應(yīng)用場景業(yè)務(wù)系統(tǒng)登錄時調(diào)用此服務(wù)，驗證用戶名、密碼。返回值A(chǔ)A時驗證成功，可登錄系統(tǒng)；返回 AR時未映射平臺用戶與業(yè)務(wù)系統(tǒng)用戶；返回AE時表示驗證失敗。傳入?yún)?shù)說明applicationidvarchar(20)當(dāng)前登錄的業(yè)務(wù)系統(tǒng)IDloginidvarchar(10)統(tǒng)一用戶IDpasswordVarchar(40)統(tǒng)一用戶的登錄密碼格式<?xml version="1.0" encoding="GB2312" standalo<