注册企业内部应用

​    当您需要将您的企业内部应用系统通过LinkMecha集成时,您需要在LinkMecha中注册您的内部应用,维护内部应用与其他应用集成时使用的资源信息,包括数据源、API、事件

注册应用

  1. 进入LinkMehca【应用管理】-【企业内部应用】;

  2. 单击左上角【新建企业内部应用】按钮;

    新建应用

  3. 输入“名称”、“中文名称”、“应用分类”等,当配置的API需要安全认证时点击开启认证,录完信息后单击【保存】。(注:开启认证后,“资源栏”显示认证窗口,反之,不显示)

  4. 单击列表【编辑】按钮,弹出本地应用维护界面,包括基本信息、认证信息、资源管理。

    Editing Local Applications

  5. 添加认证方式

    当您的企业内部应用需要通过认证才能进行调用时,您需要维护您的应用的认证信息。

    • 选择【认证方式】,选择【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注册数据源注册事件

results matching ""

    No results matching ""

    results matching ""

      No results matching ""