POST /mfa/trusted-devices
将当前设备标记为受信设备,30天内免MFA验证。参考:NIST SP 800-63B §5.1 (Verifier Impersonation Resistance)、OWASP ASVS V2.8。
MFA `bearerAuth` application/json
Request Body
Schema: dto.TrustDeviceRequest
| Field | Type | Required | Example | Constraints | Description |
device_fingerprint |
string |
Yes |
|
|
|
device_name |
string |
Yes |
|
|
|
user_agent |
string |
No |
|
|
|
Referenced Schemas
dto.TrustedDeviceDataResponse
| Field | Type | Required | Example | Constraints | Description |
code |
integer |
No |
|
|
|
data |
dto.TrustedDeviceItem |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|
dto.TrustedDeviceItem
| Field | Type | Required | Example | Constraints | Description |
created_at |
string |
No |
2026-05-25T08:00:00Z |
|
|
device_name |
string |
No |
iPhone 15 |
|
|
id |
string |
No |
td_abc123 |
|
|
ip_address |
string |
No |
192.168.1.100 |
|
|
trusted_until |
string |
No |
2026-06-25T08:00:00Z |
|
|
gitee_com_linmes_authms_base_dto.SimpleResponse
| Field | Type | Required | Example | Constraints | Description |
code |
integer |
No |
|
|
|
message |
string |
No |
|
|
|
timestamp |
string |
No |
|
|
|