Help Center/ Cognitive Engagement Center/ API Reference/ iKBS Interface Reference/ Authentication/ SIA Authentication
Updated on 2023-09-27 GMT+08:00
View PDF
Share

SIA Authentication

SIA authentication is to call the SIA interface to obtain a token and add the token to the message header when the CC-iKBS interface is requested for identity authentication.

Scenario

When this interface is invoked, the authentication token and token expiration time are generated based on the JWT and domain in request parameters. The token must be carried when the CC-iKBS interface is invoked to pass the identity authentication.

Usage Description

  • Prerequisites
    • SIA information has been configured in the developer environment.
      In servicecloud.base.properties: 
      restapi.sia.tokenDeliveryServer=
restapi.sia.serviceName=

      In servicecloud.security.properties:

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

Method

POST

URI

Table 1 URI description

Request URI

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

In the URL, ip and port indicate the access address of the SIA service.

Request Description

Table 2 Parameters in request headers

No.

Parameter

Type

Mandatory or Not

Default Value

Description

1

Content-Type

String

Yes

None

The value is fixed to application/json; charset=UTF-8.
Table 3 Parameters in the request body

No.

Parameter

Type

Mandatory or Not

Description

1

jwt

String

Yes

JWT password. Contact O&M personnel to obtain the password.

2

domain

String

Yes

SIA service name. Contact the O&M personnel to obtain the value.

Response Description

Table 4 Parameters in a response message

No.

Parameter

Type

Description

1

token

String

Authentication token.

2

expiredAt

String

Expiration time.

Example

  • Request 
    POST https://ip:port/rest/sia/v1/tokens/jwt/sia
Content-Type: application/json;charset=UTF-8
{"jwt":"*************************","domain":"ccfsAppService"}
  • Response 
    "token": ***************************",
    "expiredAt": "2021-03-04T03:25:57.327+0000"
Parent topic: Authentication