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

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

FieldTypeRequiredExampleConstraintsDescription
device_fingerprint string Yes
device_name string Yes
user_agent string No

Responses

StatusDescriptionSchema
201受信设备dto.TrustedDeviceDataResponse
400参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证gitee_com_linmes_authms_base_dto.SimpleResponse
409设备已注册gitee_com_linmes_authms_base_dto.SimpleResponse
500服务器内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.TrustedDeviceDataResponse

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

dto.TrustedDeviceItem

FieldTypeRequiredExampleConstraintsDescription
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

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No