注册企业内部应用
当您需要将您的企业内部应用系统通过LinkMecha集成时,您需要在LinkMecha中注册您的内部应用,维护内部应用与其他应用集成时使用的资源信息,包括数据源、API、事件。
注册应用
进入LinkMehca【应用管理】-【企业内部应用】;
单击左上角【新建企业内部应用】按钮;
输入“名称”、“中文名称”、“应用分类”等,当配置的API需要安全认证时点击开启认证,录完信息后单击【保存】。(注:开启认证后,“资源栏”显示认证窗口,反之,不显示)
单击列表【编辑】按钮,弹出本地应用维护界面,包括基本信息、认证信息、资源管理。
添加认证方式
当您的企业内部应用需要通过认证才能进行调用时,您需要维护您的应用的认证信息。
- 选择【认证方式】,选择【http认证】
- 输入应用的认证地址、选择请求方式、消息格式。
接下来配置认证参数,界面各参数说明:
参数名称 | 参数说明 |
---|---|
请求参数 | 请求参数为向内部应用发送认证请求时需要传输的请求报文参数 |
响应参数 | 响应参数为向内部应用发送认证请求后内部应用的响应报文参数。 |
令牌获取配置 | 指定响应参数中的某个字段为获取到的令牌 |
令牌发送配置 | 配置LinkMecha访问内部应用时,令牌传输的位置 |
成功标识配置 | 指定响应参数中代表请求成功的字段及成功值。 |
请求参数配置页
录入请求参数的名称和值(如appsecret/appkey),
例如请求参数为如下Json时,根据请求参数完成配置。
{ "appkey": dingd4nxhlebwv2ft7xc, "appsecret": "q6tyrXPqd-SPWsNX_OpWQLkQjKeJZoFzEhqx0DuFYH46SI1hA_wIj9zfcISvjrAu", }
请求参数可以根据应用的认证规范放在请求的Header、Body或Paramter中。
响应参数配置页
输入应用认证接口返回的参数信息,以便于获取令牌及其他响应信息。
例如当认证接口响应参数为如下Json时:
{ "errcode": 0, "errmsg": "ok", "access_token": "accesstoken000001", "expires_in": 7200 }
根据响应报文将参数录入到响应参数配置界面。
令牌获取配置
选择令牌路径:在下拉框中选择令牌信息对应的字段。
选择令牌及过期时间对应的参数;
有效期类型:根据响应参数中的有效期参数的业务含义,选择该参数对应的类型。
令牌发送配置
根据应用认证规范,选择应用认证时令牌发送的位置。
- 令牌需要在hedaer中传递时,令牌位置选择【header】,令牌路径中输入令牌对应的key。
- 令牌需要在body中传递时,令牌位置选择【body】,令牌路径中输入令牌对应的字段path,以响应参数配置中的Json为例,可以配置为【/access_token】。
令牌需要在Parameter中传递时,令牌位置选择【Parameter】,令牌路径中输入令牌对应的key。
成功标识配置
可以选择认证结果对应的字段及认证成功后的返回值。
成功标识字段:以响应参数配置中的Json为例,选择【errcode】。
成功标识字段值:根据应用认证接口规范输入成功值,例如0。
单击【保存】,认证方式配置完成;
新建完企业内部应用后,就可以新建企业内部应用的数据源了,如果应用是以数据库的形式对外提供的,那么您就可以新建一个数据源, 如果本地应用是以API的形式对外提供服务的,那么您可以选择新建API,如果应用有触发事件,您可以配置对应的事件接收地址。具体的配置见章节注册API、注册数据源、注册事件。