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

POST /mfa/step-up

对已登录用户的敏感操作进行二次MFA认证验证,支持TOTP、短信、邮箱三种方式。使用限流保护。参考:NIST SP 800-63B §5.1.7、OWASP ASVS V2.8。

MFA `bearerAuth` application/json

Request Body

Schema: dto.StepUpRequest

FieldTypeRequiredExampleConstraintsDescription
code string Yes 123456
method string Yes totp enum: `totp`, `sms`, `email`
user_id string Yes usr_abc123

Responses

StatusDescriptionSchema
200步进认证结果dto.StepUpDetailResponse
400参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证gitee_com_linmes_authms_base_dto.SimpleResponse
429请求过于频繁gitee_com_linmes_authms_base_dto.SimpleResponse
500服务器内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.StepUpDetailResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.StepUpResponse No
message string No
timestamp string No

dto.StepUpResponse

FieldTypeRequiredExampleConstraintsDescription
expires_in integer No 300
message string No step-up authentication successful
step_up_token string No eyJ...
valid boolean No True

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No