Register Second Factor Authentication

Endpoint en el que es posible registrar un segundo factor de autenticación para un usuario, Los campos a rellenar irán variando según el tipo de A2F.

IMPORTANTE: En cada tipo de autenticación existen campos que irán variando para responder a su A2F correspondiente a excepción de 2 campos que, independiente del tipo de autenticación deben ser ingresados, estos son method y user_id.

Si se desea registrar una A2F por SMS se requerirán los siguientes campos:

Key	Example
method	sms
phone	+56912345678
dni	20345678-0

Si se desea registrar una A2F por EMAIL se requerirán los siguientes campos:

Key	Example
method	email
email	example@gmail.com
dni	20345678-0

Si se desea registrar una A2F por WHATSAPP se requerirán los siguientes campos:

Key	Example
method	whatsapp
phone	+56912345678
dni	20345678-0

Endpoint

Headers

Key	Value	Description
Content-Type	application/json
Authorization	Bearer {{access_token}}	access_token obtained in Atenea

Url

Method: POST

URL: https://cerberus.trust.lat/v1/authentications/:user_id

caution

Recuerda que para utilizar este endpoint es necesario un access token obtenido en el servicio Atenea

Como obtener un access token

Body

{

"method": "whatsapp",

"company_id": "1",

"dni": "1-9",

"phone": "+56912345678"

}

Code Examples

Curl

curl --location --request POST 'https://cerberus.trust.lat/v1/authentications/1' \

--data-raw '{

"method": "sms",

"company_id": "1",

"dni": "20123456-6",

"phone": "+56912345678"

}'

JavaScript

import requests

url = "https://cerberus.trust.lat/v1/authentications/1"

payload = "{\n \"method\": \"sms\",\n \"company_id\": \"1\",\n \"source_service\": \"ATENEA\",\n \"dni\": \"20123456-6\",\n \"phone\": \"+56912345678\"\n}"

headers = {}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Python

var axios = require('axios');

var data = '{\n "method": "sms",\n "company_id": "1",\n "source_service": "ATENEA",\n "dni": "20123456-6",\n "phone": "+56912345678",\n}';

var config = {

method: 'post',

url: 'https://cerberus.trust.lat/v1/authentications/1',

headers: { },

data : data

};

axios(config)

.then(function (response) {

console.log(JSON.stringify(response.data));

})

.catch(function (error) {

console.log(error);

});

Responses

HTTP Code: 200 Found

Esta respuesta indicará que se requiere completar un segundo paso.

{

"code": 200,

"resource": "Verification",

"data": {

"created_at": "2022-02-22T18:33:36.458Z",

"status": "pending",

"uid": "iqxliozxcya87dam",

"updated_at": "2022-02-22T18:33:36.458Z"

},

"message": "Ok"

}

Responses

HTTP Code: 422 Unprocessable Entity

Esta respuesta indicará que se requiere completar un segundo paso.

{

"code": 422,

"resource": "A2F",

"message": "Fail",

"errors": {

"phone": [

"can't be blank"

]

}

}