更新时间:2023-09-27 GMT+08:00

SIA鉴权

SIA鉴权认证就是通过调用sia接口,获取token,在请求CC-iKBS接口时将token添加到消息头,从而通过身份认证。

场景描述

调用该API,则会根据请求参数中的jwt和domain生成鉴权token以及token过期时间,请求CC-iKBS接口时需要携带token,才能通过身份认证。

使用说明

  • 前提条件
    • 开发者环境已经配置SIA相关信息
      servicecloud.base.properties中:
      restapi.sia.tokenDeliveryServer=
      restapi.sia.serviceName=

      servicecloud.security.properties中:

      restapi.sia.encJwtContent=
      restapi.sia.encKey4JwtContent=

接口方法

POST

接口URI

表1 接口URI说明

请求URI

https://ip:port/rest/sia/v1/tokens/jwt/sia

其中,ip、port为SIA服务接入地址。

请求说明

表2 请求Headers参数说明

序号

名称

参数类型

是否必选

默认值

说明

1

Content-Type

String

True

固定填 application/json; charset=UTF-8。

表3 请求Body中参数说明

序号

名称

参数类型

是否必选

说明

1

jwt

String

True

jwt密码,联系运维人员获取

2

domain

String

True

sia服务名,联系运维人员获取

响应说明

表4 响应消息参数说明

序号

名称

参数类型

说明

1

token

String

鉴权token

2

expiredAt

String

过期时间

报文样例

  • 请求示例
    POST https://ip:port/rest/sia/v1/tokens/jwt/sia
    Content-Type: application/json;charset=UTF-8
    {"jwt":"*************************","domain":"ccfsAppService"}
  • 响应示例
    "token": ***************************",
        "expiredAt": "2021-03-04T03:25:57.327+0000"