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

POST /mfa/challenge

为指定用户创建一次性的MFA挑战码,支持短信、邮件、TOTP、推送等多种验证方式,用于登录或敏感操作前的二次认证。参考:NIST SP 800-63B §5.1.7 (Verifier Impersonation Resistance)、OWASP ASVS V2.8。

MFA `bearerAuth` application/json

Request Body

Schema: dto.MFAChallengeRequest

FieldTypeRequiredExampleConstraintsDescription
method string Yes sms

Responses

StatusDescriptionSchema
201挑战码创建成功dto.MFAChallengeDetailResponse
400参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证gitee_com_linmes_authms_base_dto.SimpleResponse
404挑战未找到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.MFAChallengeDetailResponse

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

dto.MFAChallengeResponse

FieldTypeRequiredExampleConstraintsDescription
challenge_id string No challenge-1234567890
created_at string No 2026-04-14T12:00:00Z
expires_in integer No 300
method string No sms
tenant_id string No tenant-001
user_id string No user-001

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No