Jump to

• Request
• Response

Validate user provided OTP code

post

/oam/services/rest/auth/api/v1/mfa/validateOTP

Validates a user provided OTP code against stored code generated by call to createOTP API. Configuration details can be found in OAM Admin Guide - Configuring the Adaptive Authentication Plug-in in the Oracle Access Management Console

Request

Supported Media Types

• application/json
• application/xml

Body ()

Validate OTP request

Root Schema : ValidateOTPRequest

Type: object

Show Source

• appName: string
  Name defining calling app.
• correlationId: string
  CorrelationId returned by createOTP api.
• otpCode: string
  User entered otp code to be validated.
• sessionId: string
  SessionId associated with OTP generation.
• userId: string
  Username of user to generate OTP code for.

{
    "type":"object",
    "required":[
        "userId",
        "correlationId",
        "otpCode",
        "appName"
    ],
    "properties":{
        "userId":{
            "description":"Username of user to generate OTP code for.",
            "type":"string"
        },
        "correlationId":{
            "description":"CorrelationId returned by createOTP api.",
            "type":"string"
        },
        "otpCode":{
            "description":"User entered otp code to be validated.",
            "type":"string"
        },
        "appName":{
            "description":"Name defining calling app.",
            "type":"string"
        },
        "sessionId":{
            "description":"SessionId associated with OTP generation.",
            "type":"string"
        }
    }
}

Response

Supported Media Types

• application/json
• application/xml

200 Response

Successful

Body ()

Root Schema : ValidateOTPResponse

Type: object

Show Source

• message: string
  Message describing error, if any.
• minorCode: string
  Minor code indicating error details.
• resultCode: string
  Response code indicating success (0) or error.

{
    "properties":{
        "resultCode":{
            "type":"string",
            "description":"Response code indicating success (0) or error."
        },
        "minorCode":{
            "type":"string",
            "description":"Minor code indicating error details."
        },
        "message":{
            "type":"string",
            "description":"Message describing error, if any."
        }
    }
}

401 Response

Unauthorized

404 Response

Requested entity not found

422 Response

Unprocessable Entity

Body ()

Root Schema : ValidateOTPResponse

Type: object

Show Source

• message: string
  Message describing error, if any.
• minorCode: string
  Minor code indicating error details.
• resultCode: string
  Response code indicating success (0) or error.

{
    "properties":{
        "resultCode":{
            "type":"string",
            "description":"Response code indicating success (0) or error."
        },
        "minorCode":{
            "type":"string",
            "description":"Minor code indicating error details."
        },
        "message":{
            "type":"string",
            "description":"Message describing error, if any."
        }
    }
}

424 Response

Failed Dependency

Body ()

Root Schema : ValidateOTPResponse

Type: object

Show Source

• message: string
  Message describing error, if any.
• minorCode: string
  Minor code indicating error details.
• resultCode: string
  Response code indicating success (0) or error.

{
    "properties":{
        "resultCode":{
            "type":"string",
            "description":"Response code indicating success (0) or error."
        },
        "minorCode":{
            "type":"string",
            "description":"Minor code indicating error details."
        },
        "message":{
            "type":"string",
            "description":"Message describing error, if any."
        }
    }
}

500 Response

Internal Server Error

Body ()

Root Schema : ValidateOTPResponse

Type: object

Show Source

• message: string
  Message describing error, if any.
• minorCode: string
  Minor code indicating error details.
• resultCode: string
  Response code indicating success (0) or error.

{
    "properties":{
        "resultCode":{
            "type":"string",
            "description":"Response code indicating success (0) or error."
        },
        "minorCode":{
            "type":"string",
            "description":"Minor code indicating error details."
        },
        "message":{
            "type":"string",
            "description":"Message describing error, if any."
        }
    }
}