【正文】 pIDUserID用戶ID/UserIDUserType用戶類型/UserType名稱說明數(shù)據(jù)類型長度（字節(jié)）ResultCode返回結(jié)果代碼（0: 有效Token；1: 無效Token）String16ResultDesc返回結(jié)果文字描述String256CorpID企業(yè)客戶編號String16UserID用戶ID（可轉(zhuǎn)換成Guid類型）String36UserType用戶類型：(1: 企業(yè)管理員；0:企業(yè)普通用戶)String1 SSO心跳接口 接口描述為實現(xiàn)用戶的單點登錄，SaaS管理平臺必須能夠感知到用戶當(dāng)前是否處于存活狀態(tài)。c) 用戶輸入帳號和密碼登錄到SaaS管理平臺，SaaS管理平臺為用戶產(chǎn)生Token。c) ISV應(yīng)用系統(tǒng)將用戶Token發(fā)送到平臺進(jìn)行鑒權(quán)。用戶在訪問平臺中各ISV應(yīng)用系統(tǒng)時，各ISV應(yīng)用系統(tǒng)將通過本接口對訪問者進(jìn)行統(tǒng)一的Token認(rèn)證。他們各自需要提供接口供對方消費(fèi)。（ISVSaaSInterface 和ISVSaaSInterfaceXMLString）。1. ISV應(yīng)用系統(tǒng)接入SaaS管理平臺時需提供其業(yè)務(wù)系統(tǒng)出訪IP和URL（根據(jù)其業(yè)務(wù)特性確定）2. SaaS管理平臺為ISV應(yīng)用系統(tǒng)的每一個業(yè)務(wù)分配一個全局唯一的業(yè)務(wù)應(yīng)用ID3. SaaS管理平臺側(cè)防火墻配置安全策略，只有有效的IP和業(yè)務(wù)應(yīng)用ID才能訪問SaaS管理平臺4. ISV應(yīng)用系統(tǒng)端配置相應(yīng)策略，以拒絕非SaaS管理平臺的接口調(diào)用Interface Specification（接口描述） SaaS接口概述SaaS接口提供兩個webmethod的webservice供ISV調(diào)用：ResponseInfo SaaSISVInterface(RequestInfo req)和String SaaSISVInterfaceXMLString(String strXML)，兩個方法的功能一樣，只是參數(shù)和返回類型不同。()。CryptoStream cryptoStream = new CryptoStream(memoryStream, (keyBytes, ivBytes), )。byte[] keyHashBytes = ((key))。 算法示例: public static string DESEncrypt(string data, string key) {if((data) || (key)){throw new ArgumentNullException(The param[s] cann39。SaaS管理平臺向ISV應(yīng)用系統(tǒng)發(fā)送消息時，根據(jù)該應(yīng)用系統(tǒng)對應(yīng)的密鑰對消息體進(jìn)行加密。不同的ISV應(yīng)用系統(tǒng)采用不同的密鑰對本系統(tǒng)向SaaS管理平臺發(fā)送的消息進(jìn)行加密。ISV應(yīng)用系統(tǒng)) 27 企業(yè)客戶業(yè)務(wù)受理接口 27 企業(yè)客戶員工業(yè)務(wù)受理接口 31 角色列表同步（讀取）接口 34 用戶角色權(quán)限同步（讀?。┙涌?36 用戶角色權(quán)限同步（更新）接口 38 產(chǎn)品業(yè)務(wù)期限查詢接口 40附錄一：PDU通用HEAD（消息頭） 1附錄二：數(shù)據(jù)類型 1附錄三：消息類型 1附錄四：算法說明 5附錄五：接口WSDL 6General Summary（總體規(guī)范）. 技術(shù)方案本系統(tǒng)對外集成通信接口采用WebService技術(shù)作為SaaS平臺與外部各系統(tǒng)之間的主要通信接口。蘇州移動中小企業(yè)信息化平臺接口規(guī)范版本履歷版本號.修訂日期修訂人審核人修改內(nèi)容20091027羅海平20091029宋凱1. 增加了參數(shù) ParamMap。. 接口協(xié)議. 基本協(xié)議雙方的消息交互采用SOAP（Simple Object Access Protocol，簡單對象訪問協(xié)議）協(xié)議。各個ISV應(yīng)用系統(tǒng)的密鑰由SaaS平臺管理員在SaaS管理平臺上設(shè)定新密鑰的啟用時間，SaaS系統(tǒng)自動生成新密鑰；密鑰生成后，SaaS平臺管理員通過線下的方式給到ISV應(yīng)用系統(tǒng)，ISV應(yīng)用系統(tǒng)進(jìn)行配置。ISV應(yīng)用系統(tǒng)接收到SaaS管理平臺發(fā)送的消息后可直接采用自身的密鑰對消息體解密。t be null.)。byte[] keyBytes = ArrayUtilbyte.GetOddArray(keyHashBytes)。StreamWriter writer = new StreamWriter(cryptoStream)。()。ISV可以選擇使用其中的一個方法來調(diào)用接口，具體的功能和返回信息由消息頭的操作碼：Code操作碼/Code決定，也就是說接口調(diào)用只有一個入口。另外，平臺還支持URL（網(wǎng)頁）方式的接口，ISV可以直接向該一個URL地址POST數(shù)據(jù)，在返回流（Response）中就是滿足接口規(guī)范接口的返回信息。SaaS管理平應(yīng)提供如下接口供ISV調(diào)用：l SSO鑒權(quán)接口l SSO心跳接口l 客戶端登錄接口l 產(chǎn)品訪問鑒權(quán)接口l 企業(yè)信息接口l 企業(yè)員工信息接口l 企業(yè)部門信息接口l 企業(yè)通訊錄信息接口l ISV消息通知接口ISV應(yīng)用系統(tǒng)應(yīng)提供如下接口供SaaS調(diào)用：l 企業(yè)客戶業(yè)務(wù)受理接口l 企業(yè)客戶員工業(yè)務(wù)受理接口l 角色列表同步（讀取）接口l 用戶角色權(quán)限同步（讀?。┙涌趌 用戶角色權(quán)限同步（更新）接口 SaaS管理平臺提供ISV應(yīng)用系統(tǒng)接口(ISV應(yīng)用系統(tǒng)224。以便對用戶進(jìn)行統(tǒng)一的SSO鑒權(quán)認(rèn)證。d) SaaS管理平臺將鑒權(quán)結(jié)果結(jié)果信息返回ISV應(yīng)用系統(tǒng)。d) 用戶通過平臺ISV產(chǎn)品鏈接或直接登錄ISV應(yīng)用系統(tǒng)，訪問ISV應(yīng)用系統(tǒng)。用戶登錄到ISV應(yīng)用系統(tǒng)以后，SaaS管理平臺無法確定用戶是否在線，默認(rèn)情況下，一定時間（如30分鐘）后，SaaS管理平臺將會自動殺死用戶的進(jìn)程。3． SaaS管理平臺刷新用戶Token存活期為初始值（如30分鐘）。v 由于是C/S結(jié)構(gòu),可能會影響其余B/S應(yīng)用的SSO登錄體驗 交互流程1． 用戶在客戶端輸入用戶名及密碼。2． ISV應(yīng)用將登錄鑒權(quán)時獲得的用戶Token及AppID發(fā)送至服務(wù)端。 交互流程1． 管理員在平臺中更新企業(yè)信息。 應(yīng)用場景 接口定義消息類型編碼SYS10301請求消息消息格式?xml version= encoding=UTF8?MsgHeadRequest通用消息頭（ref: 附錄）/HeadBody加密后的消息體/Body/Msg未加密的消息體格式CorpID企業(yè)客戶編號/CorpID名稱說明數(shù)據(jù)類型長度（字節(jié)）CorpID企業(yè)客戶編號String16返回消息消息格式?xml version= encoding=UTF8?MsgHeadResponse通用消息頭（ref: 附錄）/HeadBody加密后的消息體/Body/Msg未加密的消息體格式ResultCode返回結(jié)果代碼/ResultCodeResultDesc返回結(jié)果描述/ResultDescCorpID企業(yè)客戶編號/CorpIDCorpName企業(yè)客戶名稱/CorpNameShortName企業(yè)客戶簡稱/ShortNameEnglishName企業(yè)客戶英文名稱/EnglishNameEngShortName企業(yè)客戶英文簡稱/EngShortNameFQDN企業(yè)FQDN/FQDNCorpLicense企業(yè)營業(yè)執(zhí)照號/CorpLicenseLegalPerson企業(yè)法人/LegalPersonAdminPhone企業(yè)管理員聯(lián)系電話/AdminPhoneAdminMobile企業(yè)管理員聯(lián)系手機(jī)/AdminMobileAdminEmail企業(yè)管理員聯(lián)系郵件/AdminEmailAddress企業(yè)地址/AddressMailingAddress企業(yè)郵寄地址/MailingAddressZipCode 郵編/ZipCodePhone企業(yè)電話/PhoneFax傳真號碼/FaxEmail郵箱地址/EmailWebSite企業(yè)WEB網(wǎng)址/WebSiteCorpLogoURL企業(yè)LogoURL /CorpLogoURLUpdateTime變更時間/UpdateTime名稱說明數(shù)據(jù)類型長度（字節(jié)）ResultCode返回結(jié)果代碼(0: 處理成功；1: 處理失敗)String16ResultDesc返回結(jié)果描述String256CorpID企業(yè)客戶編號String16CorpName企業(yè)客戶名稱String64ShortName企業(yè)客戶簡稱String32EnglishName企業(yè)客戶英文名稱String128EngShortName企業(yè)客戶英文簡稱String32FQDN企業(yè)FQDNString256CorpLicense企業(yè)營業(yè)執(zhí)照號String64LegalPerson企業(yè)法人String64AdminPhone 企業(yè)管理員聯(lián)系電話String32AdminMobile企業(yè)管理員聯(lián)系手機(jī)String32AdminEmail 企業(yè)管理員聯(lián)系郵件String80Address企業(yè)地址String256MailingAddress企業(yè)郵寄地址String256ZipCode郵編String6Phone企業(yè)電話String32Fax傳真號碼String32Email郵箱地址String80WebSite企業(yè)WEB網(wǎng)址String100CorpLogoURL企業(yè)Logo URLString256UpdateTime變更時間，格式為YYYYMMDDHHmmssfffString17 企業(yè)員工信息接口 接口描述對于需要企業(yè)員工信息的ISV應(yīng)用，則實現(xiàn)該接口，以接受企業(yè)員工信息更新。4． ISV應(yīng)用系統(tǒng)更新本地數(shù)據(jù)系統(tǒng)。2． ISV定期（按需）從SaaS平臺獲取最新的企業(yè)部門信息。 交互流程1． 管理員在平臺中更新企業(yè)通訊錄信息。 應(yīng)用場景 接口定義消息類型編碼SYS10304請求消息消息格式?xml version= encoding=UTF8?MsgHeadRequest通用消息頭（ref: 附錄）/HeadBody加密后的消息體/Body/Msg未加密的消息體格式CorpID企業(yè)客戶編號/CorpIDContactIDs聯(lián)系人ID ,…[n]/ContactIDs名稱說明數(shù)據(jù)類型長度（字節(jié)）CorpID企業(yè)客戶編號String16ContactIDs聯(lián)系人ID列表(以逗號分割).如果 是空串,則表示獲取所有聯(lián)系人String返回消息消息格式?xml version= encoding=UTF8?MsgHeadResponse通用消息頭（ref: 附錄）/HeadBody加密后的消息體/Body/Msg未加密的消息體格式ResultCode返回結(jié)果代碼/ResultCodeResultDesc返回結(jié)果描述/ResultDescCorpID企業(yè)客戶編號/CorpIDContactsContactContactID聯(lián)系人ID/ContactIDFullName聯(lián)系人全名 /FullNameFirstName聯(lián)系人名字 /FirstNameMiddleName聯(lián)系人中間名 /MiddleNameLastName聯(lián)系人姓氏 /LastNameTitle職位/TitleEmail電子郵件/EmailCompanyPhone公司電話/CompanyPhoneHomePhone家庭電話/HomePhoneMobile移動電話/MobileHomeAddress家庭住址/HomeAddressZipcode郵政編碼/ZipcodeUpdateTime變更時間/UpdateTime/Contact Contact……/Contact/Contacts名稱說明數(shù)據(jù)類型長度（字節(jié)）ResultCode返回結(jié)果代碼(0:處理成功；1: 處理失敗)String16ResultDesc返回結(jié)果描述String256CorpID企業(yè)客戶編號String16ContactID聯(lián)系人IDString16FullName聯(lián)系人全名String64FirstName聯(lián)系人名字String24MiddleName聯(lián)系人中間名String16LastName聯(lián)系人姓氏