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"
        ]
    }
}