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

PUT /admin/mfa/risk-policies/{level}

更新租户指定风险等级的MFA因子要求。参考:NIST SP 800-63B §5.2 (Risk-based Authentication)。需要管理员权限。

MFA `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
level path string Yes 风险等级(low/medium/high)

Request Body

Schema: dto.UpdateRiskPolicyByLevelRequest

FieldTypeRequiredExampleConstraintsDescription
required_methods array of

string

Yes
description string No
enabled boolean No

Responses

StatusDescriptionSchema
200更新后的策略dto.RiskPolicyItemDetailResponse
400参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证gitee_com_linmes_authms_base_dto.SimpleResponse
403权限不足gitee_com_linmes_authms_base_dto.SimpleResponse
500服务器内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.RiskPolicyItem

FieldTypeRequiredExampleConstraintsDescription
created_at string No 2026-05-25T08:00:00Z
description string No High-risk policy for new devices
enabled boolean No True
id string No rp_abc123
level string No high
required_methods array of

string

No ['["totp"', '"sms"]']
updated_at string No 2026-05-25T08:00:00Z

dto.RiskPolicyItemDetailResponse

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

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No