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

POST /mfa/push/challenge

创建Push MFA挑战,通过notification-service推送批准请求到用户设备,包含 Number Matching 防钓鱼保护。参考:NIST SP 800-63B §5.1.7 (Verifier Impersonation Resistance)、OWASP ASVS V2.8。

MFA `bearerAuth` application/json

Request Body

Schema: dto.PushChallengeRequest

FieldTypeRequiredExampleConstraintsDescription
device_id string No dev-001
login_context string No login from Beijing

Responses

StatusDescriptionSchema
201挑战创建成功dto.PushChallengeDetailResponse
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.PushChallengeDetailResponse

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

dto.PushChallengeResponse

FieldTypeRequiredExampleConstraintsDescription
challenge_id string No chal-abc123
created_at string No 2026-05-12T12:00:00Z
expires_in integer No 120
login_context string No login from Beijing
number_matching string No 42
status string No pending
user_id string No user-001

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No