mfaVerify(WithStepUp)

AppDelegate.reachfive().mfaVerify(
    stepUp
)

About this command

Verifies the step up process by passing the verification code and challenge ID.

Examples

import Reach5

AppDelegate.reachfive()
  .mfaStart(stepUp(
        challengeId: "m3DaoT...7Rzp1m",
        verificationCode: "123456",
        trustDevice: true))
  .onSuccess { _ in
      // Do something
  }
  .onFailure { error in
      // Return a ReachFive error
  }

Parameters

stepUp

Contains the necessary fields to begin the step up process.

This includes the following:

verificationCode: The verification code sent by email or SMS.
challengeId: The code challenge ID to verify the user.
trustDevice: Optional boolean to trust the device or not. Accepts true to mark the device as trusted and false to mark the device as not trusted. This only applies to Risk-based Authentication.

...
AppDelegate.reachfive()
  .mfaVerify(stepUp(
        challengeId: "m3DaoT...7Rzp1m",
        verificationCode: "123456",
        trustDevice: true))
...

Response

Future<AuthToken, ReachFiveError>

Error response

ReachFiveError

Based on the problem, the ReachFiveError will be:

AuthCanceled: The user cancelled the request or no credential was available in the keychain.
RequestError(apiError: ApiError) for a Bad Request (status 400) error.
AuthFailure(reason: String, apiError: ApiError?) mainly for Unauthorized (status 401) error.
TechnicalError(reason: String, apiError: ApiError?) if it’s an Internal Server Error (status 500) or other internal errors.

ApiError

error string

The main error message.

errorId string

The identifier of the error.

errorUserMsg string

The user-friendly error message.

This property is translated according to the user’s OS and app settings. Currently supported languages:

Currently supported languages

ar - العربية Arabic
de - Deutsch German
en - English
es - Español Spanish
fr - Français French
hu - Magyar Hungarian
it - Italiano Italian
jp - 日本 Japanese
ko - 한국인 Korean
nl - Nederlands Dutch
pt - Portuguese
ru - Ру́сский Russian
sk - Slovenský Slovak
zh-CN - People’s Republic of China Simplified Chinese
zh-Hans - Simplified Chinese
zh-Hant - Traditional Chinese
zh-HK - Hong Kong Traditional Chinese
zh-MO - Macao Traditional Chinese
zh-SG - Singapore Simplified Chinese
zh-TW - Taiwan Traditional Chinese

errorMessageKey string

The error message key.

errorDescription string

The technical error message.

errorDetails FieldError[]

field string

The field concerned by the error.

message string

The message error returned for the field.

code string

The code error returned for the field.