文档首页/云客服/API参考/知识库管理类接口参考/鉴权方式/SIA鉴权
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

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"
父主题：鉴权方式