MFA through Verify API

MFA via Verify API

Step 1 – get access token

https://docs.iddataweb.com/v1.0/reference

notes

  • Use the client ID and client Secret from your verification technique to generate the Authorization: Basic header

Request

HTTP POST
https://api.preprod.iddataweb.com/v1/token?grant_type=client_credentials

Headers:
Authorization: Basic ODE1YTZlN2I4YzdjNGI4ZTpuT29UbFVqNTZmPW1Kd3M=

Response:

{
    "errorCode": "",
    "errorDescription": "",
    "access_token": "TjZK7NSjw24AxGKUhOE9uJDaZT23gKYuUC-9GMTAgLU",
    "expires_in": "600",
    "token_type": "Bearer"
}

Step 2 – call /otp

https://docs.iddataweb.com/v1.0/reference#otp

Notes

  • Use the “access_token” from the token request for the “Authorization: Beaerer ” header.

Request

HTTP GET
https://api.preprod.iddataweb.com/v1/otp?type=sms&dialCode=1&telephone=5714264638

Headers
Authorization: Bearer TjZK7NSjw24AxGKUhOE9uJDaZT23gKYuUC-9GMTAgLU

Response

{
    "responseCode": "200",
    "errorDescription": null,
    "asi": "ce5e9073-8aeb-40fc-b1d8-97247d4c8dd9",
    "status": "SUCCESS"
}

Querystring Parameters

For SMS OTP:

  • Type=sms&dialCode=1&telephone=5714264632
    For Voice OTP:
  • Type=voice&dialCode=1&telephone=5714264632
    For email OTP:
  • Type=email&[email protected]

Step 3: Validate OTP

https://docs.iddataweb.com/v1.0/reference#slverify

Notes

  • Use the “access_token” from the token request for the “Authorization: Beaerer ” header.
  • Use the ASI from the /otp response as the input for the /slverify response
  • Use the 6 digit OTP sent to the recipient as the “pincode” content
  • Set the pintype to the same Type you used in step 2 (sms, email or voice)

Request

HTTP POST
https://api.preprod.iddataweb.com/v1/slverify

Headers
Authorization: Bearer TjZK7NSjw24AxGKUhOE9uJDaZT23gKYuUC-9GMTAgLU

{
   "asi": "ce5e9073-8aeb-40fc-b1d8-97247d4c8dd9",
   "userAttributes": [
        {
            "attributeType": "PINCode",
            "values": {
                "pincode": "779743",
            "pinType": "sms"
            }
        }
]
}

Response

{
    "errorCode": "",
    "errorDescription": "",
    "mbun": "",
    "transaction_id": "ce5e9073-8aeb-40fc-b1d8-97247d4c8dd9",
    "userAttributes": [
        {
            "attributeType": "PINCode",
            "values": {
                "pincode": "779743",
                "pinType": "sms"
            },
            "dateCreated": "Oct 22, 2018 8:21:22 AM"
        }
    ],
    "acquiredAttributes": null,
    "userAssertionList": [
        {
            "provider": "IDDataWeb",
            "serviceOffering": "Iddataweb Email PIN and Phone PIN Service",
            "dateAsserted": "10/22/2018 08:21:22",
            "assertions": {
                "test.device": "pass"
            }
        }
    ]
}