Document a new parameter that would return 401 instead of 200 when TransactionConditionAdvice fails with a wrong credential

Bug description

Document a new parameter that would return 401 instead of 200 when TransactionConditionAdvice fails with a wrong credential

How to reproduce the issue

As a result of OPENAM-12627 fix, it is now optional to return error return 401 instead of 200 when TransactionConditionAdvice fails with a wrong credential

Please see OPENAM-12627 for detail on how to recreate HTTP 200 response below :

{
    "tokenId": "<old user token>",
    "successUrl": "http://example.com:80/index.html",
    "realm": "/"
}

By setting a new advanced parameter " org.forgerock.openam.auth.transactionauth.returnErrorOnAuthFailure=true" under [Configure] -> [Server Defaults] -> [Advanced] on admin console, it is now possible to return error 401 :

{"code":401,"reason":"Unauthorized","message":"Login failure","detail":{"failureUrl":""}}

Expected behaviour

N/A

Current behaviour

N/A

Work around

N/A

Code analysis

N/A