/mfa/push/challenge
创建Push MFA挑战，通过notification-service推送批准请求到用户设备，包含 Number Matching 防钓鱼保护。参考：NIST SP 800-63B §5.1.7 (Verifier Impersonation Resistance)、OWASP ASVS V2.8。
请求体
Schema： service-mfa/internal/handler/dto.PushChallengeRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
device_id |
string |
否 | dev-001 |
||
login_context |
string |
否 | login from Beijing |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 201 | 挑战创建成功 | service-mfa/internal/handler/dto.PushChallengeDetailResponse |
| 400 | 参数错误 | service-core/base/dto.SimpleResponse |
| 401 | 未认证 | service-core/base/dto.SimpleResponse |
| 404 | 设备未找到 | service-core/base/dto.SimpleResponse |
| 429 | 请求过于频繁 | service-core/base/dto.SimpleResponse |
| 500 | 服务器内部错误 | service-core/base/dto.SimpleResponse |
引用的 Schema
service-core/base/dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-mfa/internal/handler/dto.PushChallengeDetailResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
data |
service-mfa/internal/handler/dto.PushChallengeResponse |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-mfa/internal/handler/dto.PushChallengeResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
challenge_id |
string |
否 | chal-abc123 |
||
created_at |
string |
否 | 2026-05-12T12:00:00Z |
||
expires_in |
integer |
否 | 120 |
||
login_context |
string |
否 | login from Beijing |
||
number_matching |
string |
否 | 42 |
||
status |
string |
否 | pending |
||
user_id |
string |
否 | user-001 |