authenticateByTicket

语法

authenticateByTicket(ticket)

详情

使用会话票据登录。自 3.00.6.3 起,也支持使用持久化访问凭据登录。

参数

ticket STRING 标量,可以是 getAuthenticatedUserTicket 或 generateUserTicket 生成的会话票据,也可以是 createAccessToken 生成的访问凭据。

返回值

无。

例子

例1. 使用会话票据登录

accountName = getCurrentSessionAndUser()[1]
ticket1 = getAuthenticatedUserTicket(expire=2030.12.31T12:00:00)

// 票据登录
logout()
authenticateByTicket(ticket=ticket1)

// 验证当前用户为 accountName
getCurrentSessionAndUser()[1] == accountName
// output: true

例2. 使用访问凭据登录

accountName = getCurrentSessionAndUser()[1]
accessToken = createAccessToken(userId=accountName, expire=2030.12.31T23:59:59, description="MCP client")

// 凭据登录
logout()
authenticateByTicket(ticket=accessToken["token"])

// 验证当前用户为 accountName
getCurrentSessionAndUser()[1] == accountName
// output: true

相关函数: getAuthenticatedUserTicket, generateUserTicket, createAccessToken, revokeAccessToken, listAccessTokens