浙江政务服务网sso接口规范

《浙江政务服务网sso接口规范》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、卷号usp4.12卷内编号密级项目编号:usp4.12SSO接口规范本文档使用部门：■主管领导■项目组□客户（市场）□维护人员■用户修订历史记录日期版本AMD修订内容简述修订人备注2012-3-174.2A周旭光注：A-添加，M-修改，D-删除目录1.目的52.SSOAPI接口62.1.组织管理62.1.1.组织增加修改62.1.2.组织删除92.1.3.根据组织编码获取组织详细信息112.1.4.根据组织编码获取下级组织列表132.2.用户管理152.2.1.用户增加修改162.2.2.用户删除192.2.3.根据SSO用户登录名获取用户详细信息212.2.4.根据组织编码获取用户列表

2、242.2.5.根据映射系统用户名获取SSO的绑定用户272.2.6.根据SSO用户获取映射系统的用户282.2.7.获取用户角色302.3.认证和单点登录标准接口(commnetAuth)322.3.1.票据认证322.3.2.根据授权码获取令牌342.3.3.更新接入资源令牌352.3.4.根据代理令牌获取第三方接入资源票据372.3.5.根据访问令牌获取票据392.3.6.用户认证402.3.7.根据访问令牌获取用户详细信息422.3.8.获取用户角色442.3.9.CA认证（待定）462.3.10.用户可访问系统列表462.3.11.统一登录入口472.3.12.统一登出472.

3、3.13.修改密码482.3.14.修改个人信息492.4.认证和单点登录简化接口(easyAuth)502.4.1.票据认证502.4.2.根据令牌获取第三方接入资源票据522.4.3.用户认证532.4.4.根据令牌获取用户详细信息552.4.5.获取用户角色583.接入资源接口规范593.1.组织接口593.1.1.组织增加修改593.1.2.组织删除623.2.用户接口643.2.1.用户增加修改643.2.2.用户删除673.2.3.用户角色同步693.3.角色接口713.3.1.角色增加修改713.3.2.角色删除723.4.职务接口743.4.1.职务增加修改743.4.2

4、.职务删除754.接入资源认证774.1.1.统一验证方式774.1.2.http附加参数781.目的本规范详细定义了SSO对外提供接口规范和调用方法。约定n方法名区分大小写，参数名均是小写。nSSO系统同时支持两种数据格式xml和json。接入资源只要实现一种格式即可nWebService接口返回值（还有args参数）json或者xml格式传输：1.XML返回格式如下：对象格式：zhangs张三列表格式：<

5、?xmlversion=“1.0”encoding=“UTF-8”?>22.JSON返回格式如下：对象格式{“loginname”:”zhangs”}列表格式{“total”:2,”user”:[{“loginname”:”zhangs”,”username”:”张三”},{“loginname”:”lisi”,”username”:”李四”}]}n接口类型：本文档支

6、持webservice、http、js三种接口类型。一个接口可能同时支持一种或者多种类型。n注：接入资源的接口方式为http方式时，需要设置编码方式。HTTPcontentType设置成text/xml如：response.setContentType(“text/xml;charset=utf-8”);n如果采用http方式，请增加参数method，值为方法名字。n后缀域名相同的组织所拥有的用户名必须唯一。n用户只能在后缀域名相同的组织之间进行调换。n组织以orgcoding为唯一主键。n认证参数:servicecode与servicepwd由SSO管理员在SSO注册接入资源之后，提供

7、给接入资源。1.SSOAPI接口1.1.用户管理1.1.1.用户增加修改1.1.1.1.接口说明该接口是实现接入资源用户信息到SSO同步的接口规范。由SSO提供接口，接入资源(webservice客户端)调用SSO（webservice服务端）接口主动将用户信息推给SSO。1.1.1.2.接口类型webservice/http1.1.1.3.接口方法synchronizeUser1.1.1.1.输入参数Webservice参数列表: