浙江政务服务网SSO接口规范详解.doc

卷 号 usp4.12 卷内编号 密 级 项目编号: usp4.12 SSO接口规范 本文档使用部门：■主管领导 ■项目组 □客户（市场） □维护人员 ■用户 修订历史记录 日期 版本 AMD 修订内容简述 修订人 备注 2012-3-17 4.2 A 周旭光 注：A-添加，M-修改，D-删除 目录 1. 目的 5 2. SSO API接口 6 2.1. 组织管理 6 2.1.1. 组织增加修改 6 2.1.2. 组织删除 9 2.1.3. 根据组织编码获取组织详细信息 11 2.1.4. 根据组织编码获取下级组织列表 13 2.2. 用户管理 15 2.2.1. 用户增加修改 16 2.2.2. 用户删除 19 2.2.3. 根据SSO用户登录名获取用户详细信息 21 2.2.4. 根据组织编码获取用户列表 24 2.2.5. 根据映射系统用户名获取SSO的绑定用户 27 2.2.6. 根据SSO用户获取映射系统的用户 28 2.2.7. 获取用户角色 30 2.3. 认证和单点登录标准接口(commnetAuth) 32 2.3.1. 票据认证 32 2.3.2. 根据授权码获取令牌 34 2.3.3. 更新接入资源令牌 35 2.3.4. 根据代理令牌获取第三方接入资源票据 37 2.3.5. 根据访问令牌获取票据 39 2.3.6. 用户认证 40 2.3.7. 根据访问令牌获取用户详细信息 42 2.3.8. 获取用户角色 44 2.3.9. CA认证（待定） 46 2.3.10. 用户可访问系统列表 46 2.3.11. 统一登录入口 47 2.3.12. 统一登出 47 2.3.13. 修改密码 48 2.3.14. 修改个人信息 49 2.4. 认证和单点登录简化接口(easyAuth) 50 2.4.1. 票据认证 50 2.4.2. 根据令牌获取第三方接入资源票据 52 2.4.3. 用户认证 53 2.4.4. 根据令牌获取用户详细信息 55 2.4.5. 获取用户角色 58 3. 接入资源接口规范 59 3.1. 组织接口 59 3.1.1. 组织增加修改 59 3.1.2. 组织删除 62 3.2. 用户接口 64 3.2.1. 用户增加修改 64 3.2.2. 用户删除 67 3.2.3. 用户角色同步 69 3.3. 角色接口 71 3.3.1. 角色增加修改 71 3.3.2. 角色删除 72 3.4. 职务接口 74 3.4.1. 职务增加修改 74 3.4.2. 职务删除 75 4. 接入资源认证 77 4.1.1. 统一验证方式 77 4.1.2. http附加参数 78  目的 本规范详细定义了SSO对外提供接口规范和调用方法。 约定 方法名区分大小写，参数名均是小写。 SSO系统同时支持两种数据格式 xml和 json。接入资源只要实现一种格式即可 WebService接口返回值（还有args参数）json或者xml格式传输： XML返回格式如下： 对象格式： ?xml version=“1.0” encoding=“UTF-8”? SSO loginnamezhangs/loginname username张三/username /SSO 列表格式： ?xml version=“1.0” encoding=“UTF-8”? SSO total2/total user loginname=“zhangs” username=“张三”/user user loginname=“lisi” username=“李四”/user /SSO JSON返回格式如下： 对象格式 {“loginname”:”zhangs” } 列表格式 {“total”:2,”user”:[{“loginname”:”zhangs”,”username”:”张三”},{“loginname”:”lisi”,” username”:”李四” }]} 接口类型： 本文档支持webservice、http、js三种接口类型。一个接口可能同时支持一种或者多种类型。 注：接入资源的接口方式为http方式时，需要设置编码方式。HTTP contentType 设置成text/xml 如：response.setContentType(“text/xml;charset=utf-8”); 如果采用http方式，请增加参数method，值为方法名字。 后缀域名相同的组织所拥有的用户名必须唯一。 用户只能在后缀域名相同的组织之间进行调换。 组