preferredMFAOption related claims are not available in IS-7.0.0

[AnuradhaSK]

Describe the issue:

preferredMFAOption local claim and scim claim are not available in IS-7.0.0
Due to that failed to try out
https://is.docs.wso2.com/en/next/guides/authentication/mfa/user-preferred-mfa-login/#configure-application-login-for-user-preferred-mfa

[UdeshAthukorala]

This will be fixed with

• Introduce a new identity claim preferredMFAOption for user preferred MFA login feature carbon-identity-framework#5358
• Introduce a new claim preferredMFAOption to scim2 extension schema wso2-extensions/identity-inbound-provisioning-scim2#520

[UdeshAthukorala]

Migration Task for this newly introduced Identity claim is tracked via: #18889

[UdeshAthukorala]

When testing the flow found the following gaps in the IS 7.0 documentation(https://is.docs.wso2.com/en/next/guides/authentication/mfa/user-preferred-mfa-login/#configure-application-login-for-user-preferred-mfa) & following changes need to be done for fix them.

1. Sample adaptive authentication script(https://is.docs.wso2.com/en/next/guides/authentication/mfa/user-preferred-mfa-login/#configure-application-login-for-user-preferred-mfa:~:text=var%20onLoginRequest%20%3D,%7D%0A%20%20%20%20%7D)%3B%20%20%0A%7D%3B) needs to be change as given below to skip throwing null pointer exception when there is no preferredMFAOption claim available for the user.

   var onLoginRequest = function(context) {
       executeStep(1, {
           onSuccess: function (context) {
               var preferredClaimURI = 'http://wso2.org/claims/identity/preferredMFAOption';
               var user = context.steps[1].subject;
               var preferredClaim = user.localClaims[preferredClaimURI];
   
               if(preferredClaim != null) {  
   	    var jsonObj = JSON.parse(preferredClaim);
   	    var authenticationOption = jsonObj.authenticationOption;
   	    Log.info("preferredClaim authenticationOption " + authenticationOption); 
   	    executeStep(2, {authenticationOptions: [{authenticator: authenticationOption}]}, {});
               } else {
                   executeStep(2);
               }
           }
       });  
   };
   
   

2. Sample patch request payload also need to be update as given below since the scim2 schema & payload is incorrect.

   {
       "Operations": [
           {
               "op": "replace",
               "value": {
                   "name": {
                       "givenName": "liya"
                   }
               }
           },
           {
               "op": "replace",
               "value": {
                   "name": {
                       "familyName": "shaggy"
                   }
               }
           },
           {
               "op": "replace",
               "value": {
                   "phoneNumbers": []
               }
           },
           {
               "op": "replace",
               "value": {
                   "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
                       "preferredMFAOption": "{\"authenticationOption\":\"email-otp-authenticator\"}"
                   }
               }
           }
       ],
       "schemas": [
           "urn:ietf:params:scim:api:messages:2.0:PatchOp"
       ]
   }
   

CC: @AnuradhaSK

[UdeshAthukorala]

Closing the issue since the related Backend PRs are merged.