Step 1: Enroll in Security Questions

PATCH {{HOST}}/admin/v1/Me/

This step requests to enroll in the Security Questions factor.

Prerequisites for this step: - Use the 'Obtain ME access_token' to obtain a valid access token. - Use 'Get my information' to obtain the user 'id' value. - Use the 'Get the list of Security Questions' to get the list of security questions set. - Use the 'Get the Security Questions Settings' to get details of how many questions must be mandatorily set by the user, what's the minimum answer length, what's the max field length, etc.

In the request, you must include the mandatory number of questions and answers based on 'numQuestionsToSetup' returned in the response to 'Get the Security Questions Settings'.

Request Body

{"schemas"=>["urn:ietf:params:scim:api:messages:2.0:PatchOp"], "Operations"=>[{"op"=>"add", "path"=>"urn:ietf:params:scim:schemas:oracle:idcs:extension:securityQuestions:User:secQuestions", "value"=>[{"value"=>"FavoriteMovie", "answer"=>"Harry Potter", "hintText"=>"wizard"}, {"value"=>"FavoriteFood", "answer"=>"Chinese", "hintText"=>"springrolls"}, {"value"=>"FirstPet", "answer"=>"Bouncer", "hintText"=>"dog"}]}]}

HEADERS

RESPONSES

status: OK

{"idcsCreatedBy":{"type":"User","display":"admin user","value":"05999e92c93c4b45a04efd094ac5730e","$ref":"https://example.identitycloud.com/admin/v1/Users/05999e92c93c4b45a04efd094ac5730e"},"id":"c810ff4522eb437abac013291c1984d1","meta":{"created":"2019-01-24T10:06:52.595Z","lastModified":"2019-01-24T17:05:06.939Z","resourceType":"Me","location":"https://example.identitycloud.com/admin/v1/Me/c810ff4522eb437abac013291c1984d1"},"active":true,"displayName":"Joe Bloggs","idcsLastModifiedBy":{"value":"c810ff4522eb437abac013291c1984d1","display":"Joe Bloggs","type":"User","$ref":"https://example.identitycloud.com/admin/v1/Users/c810ff4522eb437abac013291c1984d1"},"userName":"jbloggs","urn:ietf:params:scim:schemas:oracle:idcs:extension:userState:User":{"locked":{"on":false}},"name":{"formatted":"Joe Bloggs","familyName":"Bloggs","givenName":"Joe"},"emails":[{"verified":true,"primary":false,"secondary":false,"value":"joe.bloggs@example.com","type":"recovery"},{"verified":true,"primary":true,"secondary":false,"value":"joe.bloggs@example.com","type":"work"}],"urn:ietf:params:scim:schemas:oracle:idcs:extension:mfa:User":{"mfaStatus":"ENROLLED","loginAttempts":0,"preferredAuthenticationFactor":"PUSH","preferredDevice":{"value":"2b27b8c072d64b899d41c8470acea32a","$ref":"https://example.identitycloud.com/admin/v1/Devices/2b27b8c072d64b899d41c8470acea32a"}},"schemas":["urn:ietf:params:scim:schemas:core:2.0:User","urn:ietf:params:scim:schemas:oracle:idcs:extension:userState:User","urn:ietf:params:scim:schemas:oracle:idcs:extension:mfa:User"]}