/mfa/step-up
对已登录用户的敏感操作进行二次MFA认证验证，支持TOTP、短信、邮箱三种方式。使用限流保护。参考：NIST SP 800-63B §5.1.7、OWASP ASVS V2.8。
请求体
Schema： service-mfa/internal/handler/dto.StepUpRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
string |
是 | 123456 |
||
method |
string |
是 | totp |
enum: `totp`, `sms`, `email` | |
user_id |
string |
是 | usr_abc123 |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | 步进认证结果 | service-mfa/internal/handler/dto.StepUpDetailResponse |
| 400 | 参数错误 | service-core/base/dto.SimpleResponse |
| 401 | 未认证 | 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.StepUpDetailResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
data |
service-mfa/internal/handler/dto.StepUpResponse |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-mfa/internal/handler/dto.StepUpResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
expires_in |
integer |
否 | 300 |
||
message |
string |
否 | step-up authentication successful |
||
step_up_token |
string |
否 | eyJ... |
||
valid |
boolean |
否 | True |