A AuthMS API Wiki API Reference iam.tianv.com →

POST /auth/ticket/signin

使用后台生成的一次性票据完成登录,票据验证成功后立即失效(一次性使用),返回JWT令牌。适用于跨系统SSO和管理员代登录场景。参考:RFC 6749 §1.5。

身份认证 None application/json

Request Body

Schema: dto.TicketSigninRequest

FieldTypeRequiredExampleConstraintsDescription
ticket string Yes a1b2c3d4... 一次性票据

Responses

StatusDescriptionSchema
200登录成功,返回JWT令牌dto.LoginResponse
400票据无效或已过期gitee_com_linmes_authms_base_dto.SimpleResponse
500服务器内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.LoginResponse

用户登录结果

FieldTypeRequiredExampleConstraintsDescription
access_token string No Access token
challenge_token string No MFA challenge token (short-lived, requires MFA verification)
expires_in integer No Expiration time
mfa_check_reason string No MFA触发原因描述
must_change_password boolean No Password must be changed
password_expires_in integer No Days until password expires
password_warning string No Password warning: expiring/expired_grace/expired
refresh_token string No Refresh token
required_mfa_methods array of

string

No MFA推荐方法列表
requires_mfa boolean No 自适应MFA: 需要额外MFA验证
risk_assessment object No Risk assessment
risk_level string No 风险等级: low/medium/high
token_type string No Token type
user object No User info

dto.RiskAssessmentInfo

FieldTypeRequiredExampleConstraintsDescription
level string No
recommended_mfa_methods array of

string

No
require_mfa boolean No
score integer No

dto.UserInfo

用户基本信息

FieldTypeRequiredExampleConstraintsDescription
created_at string No Account creation time
email string No Email
id string No User ID
must_change_password boolean No Password must be changed
password_expires_in integer No Days until password expires
password_warning string No Password warning: expiring/expired_grace/expired
phone string No Phone
status string No Status
username string No Username

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No