网易企业邮箱集成接口技术白皮书v1[1].1.HZ

网易企业邮箱集成接口技术白皮书稳定可靠，安全无忧V1.1.HZ集成接口技术白皮书网址：热线：400-6281-163第I页修订历史记录版本日期修订说明编制审核0.12012-4-28文档第一版，完成部门帐号同步接口、单点登录接口、未读邮件数量接口和添加自定义登录框湛舜研0.22012-5-9完成文档概述和接口综述，修改各接口介绍中的文字错误徐亭湛舜研1.02012-5-14修改2.6申请流程，修改6.2接口规范，强调域名一致与域名值为客服提供的代码串徐亭湛舜研1.1修改1.3术语解析：RSA算法，增加URL湛舜研集成接口技术白皮书网址：热线：400-6281-163第II页目录1关于文档...........................................................11.1目标..........................................................11.2读者..........................................................11.3术语定义......................................................11.4如何获得帮助..................................................12接口综述...........................................................22.1目标..........................................................22.2功能概述......................................................22.3总体架构......................................................22.4前提条件......................................................32.5应用步骤......................................................32.6申请流程......................................................43部门帐号同步接口...................................................53.1接口说明......................................................53.2接口规范......................................................53.2.1技术规范................................................53.2.2使用规范................................................53.3加密参数说明（enc值）........................................63.3.1操作说明（action值）....................................63.3.2操作参数说明............................................83.3.3URL示例.................................................93.3.4操作示例...............................................103.4应用示例.....................................................114单点登录接口......................................................124.1接口说明.....................................................124.2接口规范.....................................................124.2.1技术规范...............................................12集成接口技术白皮书网址：热线：400-6281-163第III页4.2.2使用规范...............................................124.3应用示例.....................................................135未读邮件数量接口..................................................145.1接口说明.....................................................145.2接口规范.....................................................145.2.1技术规范...............................................145.2.2使用规范...............................................145.3应用示例.....................................................156自定义登录框接口..................................................166.1接口说明.....................................................166.2接口规范.....................................................166.2.1技术规范...............................................166.2.2数据规范...............................................166.2.3注意事项...............................................176.3应用示例.....................................................17集成接口技术白皮书网址：热线：400-6281-163第1页1关于文档1.1目标这份文档帮助客户或经销商详细了解网易企业邮箱接口集成的具体功能和操作方法。1.2读者这份文档的预期读者为客户IT相关负责人、经销商客服和技术支持人员。1.3术语解析HTTP协议超文本传输协议(HTTP)是一种通信协议，它允许将超文本标记语言(HTML)文档从web服务器传送到Web浏览器。URL统一资源定位符（URL，英语UniformResourceLocator的缩写）也被称为网页地址，是因特网上标准的资源的地址。统一资源定位符URL是对可以从因特网上得到的资源的位置和访问方法的一种简洁的表示。RSA加密算法RSA加密算法是是目前最有影响力的公开密钥密码体制加密算法，它能够抵抗到目前为止已知的所有密码攻击，已被ISO推荐为公钥数据加密标准，从提出到现在的三十多年里，经历了各种攻击的考验，逐渐为人们接受，普遍认为是目前最优秀的公钥方案之一。1.4如何获得帮助如对文档有任何疑问，欢迎致电400-6281-163或发邮件[e-mail]进行咨询并作深入的了解。集成接口技术白皮书网址：热线：400-6281-163第2页2接口综述2.1目标网易企业邮箱拥有多个集成接口供客户使用，并能与其他业务系统进行集成。2.2功能概述网易企业邮箱提供多种集成接口与客户应用系统进行无缝集成，可实现与用户应用系统中组织架构同步和未读邮件数同步，并且可以在用户应用系统或者用户网站登录首页实现单点登录或者嵌入自定义登录的入口，解决了网易企业邮箱系统与客户应用系统的集成数据共享问题。采用公私钥加密技术和服务请求IP地址过滤等方案保障数据交互接口的安全。2.3总体架构接口服务器OA协同办公管理系统部门账号同步邮件服务器客户应用系统集成接口CRM客户关系管理系统HR人力资源管理系统MIS管理信息系统单点登录未读邮件数自定义登录集成接口技术白皮书网址：热线：400-6281-163第3页2.4前提条件接口类型前提条件部门账号同步系统的可扩展性、有固定的登录IP单点登录系统的可扩展性未读邮件数系统的可扩展性、有固定的登录IP自定义登录从企业域名对应的网站或系统登录2.5应用步骤1.引用RSA工具包：RSA-1.1.1.jar2.生成密钥：com.netease.domainmail.Utils.createKeyPair();执行结果如下：3.把公钥和IP地址告诉接口提供方进行授权。(注：单点登录接口不需要限定IP，可以不提供)4.生成操作参数（原始字符串）。5.参数加密：com.netease.domainmail.Utils.encrypt(StringpriKey,Stringsource);其中，priKey是私钥，source是原始字符串，返回加密后的字符串。6.组装完整URL请求地址。7.发送POST请求。8.返回操作结果。GeneratingapairofRSAkey...pubKey:30819f300d06092a864886f70d010101050003818d003081890281810085802e30d10d33197354c6c2d0785526ff17b4741048745f17e8e91cb38c70dd60e9bce1bf9b73d9215ccb56ad68c5efcf3d7f62677cd685cb1664601b57f1535138ea1e60a……priKey:30820276020100300d06092a864886f70d0101010500048202603082025c0201000281810085802e30d10d33197354c6c2d0785526ff17b4741048745f17e8e91cb38c70dd60e9bce1bf9b73d9215ccb56ad68c5efcf3d7f62677cd685cb1664601b57f1535138ea1e60a42e8ccbb813ba8f7c91d27fcfde305cd1edc04a5aa26afba8e04c87c786113c2616f2fb8b6f5b9e0c55fb141eb96ae7426d35fbe9de581fccb621020……1024-bitRSAkeyGENERATED.集成接口技术白皮书网址：热线：400-6281-163第4页2.6申请流程客户发出申请申请的接口类型客户提交域名信息到[e-mail]结束网易提供加密方案给客户生成对应的公私钥客户提交域名信息到[e-mail]网易开通接口并提供登录框示例代码客户将生成的公钥和接口服务器IP列表提交到kf@qiye.16