POST `/admin/mfa/risk-policies/evaluate`

Pass user context (user_id, IP, device fingerprint) and return the assessed risk level and required MFA methods. Reference: NIST SP 800-63B §5.2 (Risk-based Authentication). Requires admin permissions.

Multi-Factor Authentication `bearerAuth` application/json

Request Body

Schema: dto.EvaluateRiskPolicyRequest

Field	Type	Required
`user_id`	`string`	Yes
`device_fingerprint`	`string`	No
`ip`	`string`	No

Responses

Status	Description	Schema
200	Evaluation result	`dto.EvaluateRiskPolicyDetailResponse`
400	Invalid parameter	`gitee_com_linmes_authms_base_dto.SimpleResponse`
401	Unauthenticated	`gitee_com_linmes_authms_base_dto.SimpleResponse`
403	Insufficient permissions	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	Internal server error	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Referenced Schemas

dto.EvaluateRiskPolicyDetailResponse

Field	Type	Required
`code`	`integer`	No
`data`	`dto.EvaluateRiskPolicyResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.EvaluateRiskPolicyResponse

Field	Type	Required	Example
`is_new_device`	`boolean`	No	`False`
`level`	`string`	No	`medium`
`required_methods`	array of string	No	`['["totp"', '"sms"]']`

gitee_com_linmes_authms_base_dto.SimpleResponse

Field	Type	Required
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

POST /admin/mfa/risk-policies/evaluate