解决接口调用黑洞，ESP接口服务管理平台介绍

解决接口调用黑洞，ESP接口服务管理平台
------www.esblink.com

ESP:ESB Service Platform

接口调用黑洞：即通常系统接口调用时都通过WebService直接调用，这样带来的问题是，不清楚哪个系统调的，不清楚什么时候调的，不清楚调用是否成功，不清楚调用的具体参传及返回的具体报文，不清楚调用的执行时间，不清楚调用的频率，就像一个黑洞一样，只是知道一直在调，但什么都不清楚，通过这个系统可以解决以上所有问题。

ESP主要功能：

1， 自动注册，接口服务时，自动向指定的平台，注册上报接口服务信息。并支持管理与修改。
a) 自动注册到管理平台

b) 注册的接口包含，主机信息，接口服务信息，接口方法信息

c) 注册后效果

d) 注册后的接口可以管理
e) 允许同时注册多个相同的接口服务
f) 如果不同功能接口方法名相同，可修改编码，从而区别出不同的方法，访问时按编码访问。

2， 权限管理，可以对接口进行权限控制，按接口用户，按接口角色
a) 用户，调用时需要用户名，密码
b) 角色，按角色进行接口权限授权，用户角色如果没有权限不能访问。
c) 外网、内网限制，可对整个接口主机，或接口服务进行控制，也可以细化到接口的各个方法进行控制。

d) 角色权限管理效果

3， 访问限制，IP限制（黑名单）
a) 接口主机IP限制，即此主机上的所有接口服务对此IP都限制。
b) 接口服务IP限制，即此服务以下所有方法都对此IP进行限制。
c) 接口方法IP限制，即对此方法进行IP限制。

d) IP限制设置（见编辑框的Host limit，填上要限制的ip地址）

4， 数据屏蔽，对部份接口用户角色屏蔽部分数据属性，使其看不到
a) 接口主机数据屏蔽，即此接口主机的所有服务及方法，如果此属性就屏蔽掉。
b) 接口服务数据屏蔽，即此接口服务下的所有方法，如果有此属性就屏蔽掉。
c) 接口方法数据屏蔽，即此接口方法如果有此属性就屏蔽掉。
d) 数据屏蔽设置（见编辑框的Key ignore,填上要屏蔽的属性名，如name,code）

e) 增强用法，一个接口变多个
开发一个属性效的接口，通过屏蔽设置，对不同用户屏蔽不同的属性，对这些接口用户来说，接口返回数据是不一样的，对于开发人员来说只要开发一个接口就够了，即一个接口可以变成多个。
5， 接口调口日志，解决调口调用黑洞
接口调用黑洞，对于接口来说，不知道什么时候发生了调用，传了什么参数，返回了什么结果，执行了多长时间，是否执行成功，相当于一个黑洞一样，什么都不清楚。通过以下的日志，可以随时了解这些信息。
a) 请求日志，含请求报文，请求IP，请求所用用户帐号，是否外网访问，请求时间等

b) 执行日志，所调接口服务地址，接口行执成功与否，执行时长，时段
c) 返回日志，返回报文，返回时间

d) 异常日志，调用异常信息，如IP限制，接口用户帐号及密码不正确，权限不足，执行异常等。

6， 接口服务资源管理与调节
a) 平台可对所有接口主机进行管理与调整，如:
停用，不再让接口用户使用该主机的接口
启用，恢复让接口用户可使用该主机的接口
b) 允许同时有多台接口服务，停用一台后，只要接口名一样，自动由剩下的接口主机提供服务。
c) 故障可自动切换也可人工调整
如果接口主机出现问题，使接口主机停用时出现异常，则下次开始切换到正常的接口主机上。即：平台自动移除该接口主机，下次开始所有新的调用不再调用出现异常的接口主机上的服务。
下图是故障停用后的接口信息，停用后不会再出现在可用接口服务中，即该主机下的所有服务不会被调用。

d) 故障恢复
如果故障的主机问题解决，重启接口主机，会自动注册到平台，平台自动恢复该主机，则下次开始就又允许接口用户调用此主机的接口。
下图是接口重启时，记到Describe中的内容（会保存近几次的启动注册激活信息）

e) 接口服务动态化，使请求与接口服务真正分开
接口服务动态化，同一接口可以运行多份，即动行在多个主机上，都注册到平台里，由平台统一管理，请求接口服务时，只需知道要请求什么接口，至于哪台接口主机提供服务并不确定，也许这次是A主机，下次因为A主机进行维护或故障了，已经由B主机提供服务了。
请求与接口服务真正分开，通过接口服务动态化，对于请求来说，所有接口服务是一个服务池，考虑更多是接口而不是具体的接口主机。

7， 传输安全

a) 外层进行jboss容器验证
b) https基于ssl的传输加密，使接口请求与数据返回都有加密，不容易被监听
c) base64可以对请求进行base64编码，允许替换掉此部份的编码方式，以达到更好的加密与解码
d) 接口用户帐号验证，及帐户对应的角色接口权限限制，没有限制则有密码也访问不了。

8， 其他
a) 统一入口，只需一个配置
b) 统一接口管理，方便运维
c) 利于接口的规范化，标准化。
d) 系统支持中文、英文

9， 其他资料
a) 管理演示Demo：http://jcc.esblink.com:8070/esblink_idp/
b) 文档及视频演示资料：http://www.esblink.com/docs.html
c) 资料下载：http://www.esblink.com/down.html
10， 版本说明
版本基本原则是主要功能不限制且免费，管理功能限制次数（此限制在接口服务每次重启后重新算），有效接口主机数限制，或者付费。理论上如果变动小的话，免费版的次数足够用几个月。
级别越高，服务越好，费用也越高。

	Free	Simple	Ent	Pro
ESB function	UnLimit	Unlimit	UnLimit	UnLimit
Autoregist	Limit count	Unlimit	UnLimit	UnLimit
Manage ESB	Limit count	Unlimit	UnLimit	UnLimit
Service	No	Basic	Advance	Expert