警务大数据权限管控平台-服务对接指导文档.docx

《警务大数据权限管控平台-服务对接指导文档.docx》由会员分享，可在线阅读，更多相关《警务大数据权限管控平台-服务对接指导文档.docx（19页珍藏版）》请在第壹文秘上搜索。

1、吉大正元警务大数据权限管控平台服务对接指导文档V5.01 概述32 接口调用32.1 令牌同步接口32.2 应用级鉴权接口32.3 功能级鉴权接口42.4 数据级鉴权接口52.5 接口数据级鉴权接口62.6 应用权限变更通知62.7 功能权限变更通知72.8 接口服务级鉴权接口（返回标识符）72.9 接口服务级鉴权接口（返回地址）82.10 接口权限变更通知82.11 平台应用级鉴权接口83 附录93.1 用户令牌93.2 应用令牌103.3 令牌同步参数样例103.3.1 请求参数103.3.2 响应参数103.4 应用级鉴权参数样例113.4.1 请求参数113.4.2 响应参数Il3.5

2、 功能级鉴权参数样例113.5.1 请求参数113.5.2 响应参数123.6 数据级鉴权参数样例123.6.1 请求参数133.6.2 响应参数133.7 接口级鉴权参数样例133.7.1 请求参数133.7.2 响应参数143.8 应用权限变更通知参数样例153.8.1 请求参数153.8.2 响应参数163.9 功能权限变更通知参数样例163.9.1 请求参数163.9.2 响应参数163.10 接口服务级鉴权参数样例（返回标识符）173.10.1 请求参数173.10.2 响应参数173.11 接口服务级鉴权参数样例（返回地址）173.11.1 请求参数173.11.2 响应参数.18

3、3.12 接口权限变更通知参数样例183.12.1 请求参数183.12.2 啕应参数793.13 平台应用级鉴权参数样例193.13.1 请求参数193.13.2 响应参数201概述警务大数据权限管控平台（以下简称“权限管控平台”）维护业务系统权限资源及角色，完成授权动作并对业务系统提供鉴权服务，本文档对业务系统对接服务涉及到的接口进行说明。2接口调用2.1 令牌同步接口服务描述用户登录认证中心，认证中心为用户发放用户令牌，认证中心将用户令牌下发至各中心；用户登录业务应用时认证中心为用户发放应用令牌，并将应用令牌下至各中心。服务地址htgiD:IDOrtPDAtokentokenActicn

4、tokenSyncNotification.do服务方法POST请求参数说明名称参数标识父参数标识说明类型样例令牌信息认证中心下发的用户基本信息json附录3.3.1响应的参数说明令牌同步状态statusString附录332令牌同步结果描述messageString附录3.3.22.2 应用级鉴权接口服务描述用户登录认证平台后，认证平台携带用户令牌调用鉴权系统应用级鉴权接口完成应用级鉴权。鉴权系统将根据用户令牌将用户所具有权限的应用系统返回。服务地址http:/ip:port/PDA_Auth/platform/app.do服务方法POST请求参数说明名称参数标识父参数标识说明类型样例用户令

5、牌认证中心下发的用户基本信息json附录3.4.1响应的参数说明鉴权结果标识code鉴权结果码001：成功：008：鉴权用户无效；009：用户令牌无效String附录3.4.2鉴权结果数据resultdata用户具有权限的以逗号（，）分隔的应用标识，如果有平台code则返回平台code,如果没有平台COde则返回自身codeoString附录3.4.22.3 功能级鉴权接口（返回标识符）服务描述用户登录业务应用，业务应用携带应用令牌和任务信息调用鉴权系统功能级鉴权接口完成功能级鉴权。鉴权系统将根据应用令牌中用户信息及应用信息将用户在此应用下具有权限的功能资源标识符返回。服务地址hup:/ipl

6、：port/PDA_Auth/user/funs.do服务方法POST请求参数说明名称标识父参数标识说明类型样例应用令牌认证中心下发的应用基本信息json附录3.5.1任务信息（类型）附录3.5.1响应的参数说明鉴权结果标识code鉴权结果码001：成功；002：应用接入凭证无法匹配；003：应用代码无效；007：鉴权用户在此应用下无功能资源权限：008：鉴权用户无效；009：用户信息无效String附录3.5.2鉴权结果数据resultdata用户具有权限的以逗号（，）分隔的功能标识String附录3.5.22.4 功能级鉴权接口（返回地址）服务描述用户登录业务应用，业务应用携带应用令牌和任

7、务信息调用鉴权系统功能级鉴权接口完成功能级鉴权。鉴权系统将根据应用令牌中用户信息及应用信息将用户在此应用下具有权限的功能资源地址返回。服务地址http:Hd:IDortl/PDAAUthuse7funsUrLdo服务方法POST请求参数说明名称标识父参数标识说明类型样例应用令牌认证中心下发的应用基本信息json附录3.6.1任务信息（类型）附录3.6.1响应的参数说明鉴权结果标识code鉴权结果码001：成功；002：应用接入凭证无法匹配：003：应用代码无效；007：鉴权用户在此应用下无功能资源权限：008：鉴权用户无效；009：用户信息无效String附录3.6.2鉴权结果数据result

8、data用户具有权限的以逗号（，）分隔的功能地址String附录3.6.22.5 数据级鉴权接口服务描述用户登录业务应用，业务应用携带应用令牌及数据资源标识符或者资源英文名称调用鉴权系统数据级鉴权接口完成数据级鉴权。鉴权系统将根据用户具有的数据资源权限及此次请求所携带的任务、应用、机构的数据资源权限取交集进行返回。服务地址http:ip:port/PDAAUthv2dataAuth服务方法POST请求参数说明名称标识说明类型是否必填应用令牌appToken参见认证平台应用令牌信息数据项json是任务类型taskClass任务类型String是数据资源标识符resourceIds数据资源标识符S

9、tring否（与英文名称至少一个必填）数据资源英文名称resourceEnNames数据资源英文名称String否（与标识符至少一个必填）响应的参数说明结果标识codeOOl成功500其他错误String是结果标识信息message结果标识中文描述信息String是结果信息result数据项英文名称String是2.6 接口数据级鉴权接口服务描述用户登录业务应用，业务应用完成用户请求需要调用具体的业务服务，业务服务携带应用令牌及请求XmI调用鉴权系统服务级鉴权接口完成服务级鉴权。鉴权系统将判断应用是否有访问此服务的权限，若有权限则会根据用户所具有的数据资源权限与携带的任务、应用所具有的数据资源

10、权限取交集返回。服务地址http:/ip:portPDAAuthservicecheckAuth.do服务方法POST请求参数说明名称标识说明类型样例鉴权XmlXmlxml附录3.7.1响应的参数说明鉴权结果数据result经过权限过滤后的xmlString附录3.7.22.7 应用权限变更通知服务描述当人员的应用资源权限发生变化时，权限管理中心将向认证中心发送应用权限变化通知。请求地址由接收方定义服务方法POST请求参数说明名称标识说明类型样例用户令牌认证中心下发的用户基本信息Json附录3.8.1响应的参数说明状态码code“001”表示成功其它值表示失败String附录3.8.2详细信息

11、msg详细信息，建议在失败时填写详细的失败原因。String2.8 功能权限变更通知服务描述当人员的功能资源权限发生变化时，权限管理中心将向应用平台发送功能权限变化通知。请求地址由接收方定义服务方法POST请求参数说明名称标识说明类型样例应用令牌认证中心下发的应用基本信息Json附录3.9.1响应的参数说明状态码code“001”表示成功其它值表示失败String附录3.9.2详细信息msg详细信息，建议在失败时填写详细的失败原因。String2.9 接口服务级鉴权接口（返回标识符）服务描述用户登录业务应用，业务应用携带应用令牌调用鉴权系统接口服务级鉴权接口，触发后置服务调用由可信APl代理，

12、从鉴权服务获取人或应用可访问的接口服务标识符列表。服务地址http:ip:portPDA_Auth/ServiceZcheckInterFaceCode.do服务方法POST请求参数说明名称标识父参数标识说明类型样例应用令牌appToken参见认证平台应用令牌信息数据项json附录3.10.1响应的参数说明鉴权结果标识code鉴权结果码001：成功；008：鉴权用户无效；009：应用令牌无效String附录3.10.2鉴权结果数据resultdata以逗号（，）分割服务接口资源标识String附录3.10.22.10 接口服务级鉴权接口（返回地址）服务描述用户登录业务应用，业务应用携带应用令牌

13、调用鉴权系统接口服务级鉴权接口，触发后置服务调用由可信APl代理，从鉴权服务获取人或应用可访问的接口服务地址列表。服务地址http:/ipl:portPDA_Auth/ServiceZcheckInterFaceUrl.do服务方法POST请求参数说明名称标识父参数标识说明类型样例应用令牌appToken参见认证平台应用令牌信息数据项json附录3.11.1响应的参数说明鉴权结果标识code鉴权结果码001：成功；008：鉴权用户无效；009：应用令牌无效String附录3.11.2鉴权结果数据resultdata服务接口资源地址的集合String附录3.11.22.11 接口权限变更通知服务描述当人员的接口资源权限发生变化时，权限管理中心将向可信API代理发送接口权限变化通知。请求地址由接收方定义服务方法POST请求参数说明名称标识说明类型样例应用令牌认证