Login using using Second Factor Authentication

Tiene la funcionalidad de poder validar a un usuario mediante segundo factor de autenticación, uno de los campos obligatorios para su uso es el method que definirá qué estrategia será utilizada para autenticarse. En base a la estrategia a seguir serán los campos que se tienen que ingresar, estos son:

Key	Example	Description
user_id	1	Identificador que hace referencia a un usuario proveniente de un servicio externo.
company_id	1	Identificador de una compañía.
method	sms	Indica qué tipo de 2FA se quiere realizar.

Actualmente el campo method permite los siguientes valores:

• sms
• email
• whatsapp

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/a2f

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

Code Examples

Curl

curl --location --request POST 'cerberus.trust.lat/v1/authentications/1/a2f' \
--data-raw '{
    //"method": "sms",
    "company_id": "1"
}'

JavaScript

import requests

url = "cerberus.trust.lat/v1/authentications/1/a2f"

payload = "{\n    //\"method\": \"sms\",\n    \"company_id\": \"1\"\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}';

var config = {
  method: 'post',
  url: 'cerberus.trust.lat/v1/authentications/1/a2f',
  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:46:21.879Z",
        "status": "pending",
        "uid": "jmww",
        "updated_at": "2022-02-22T18:46:21.879Z"
    },
    "message": "Ok"
}

Responses

HTTP Code: 404 Not Found

{
    "code": 404,
    "resource": "User",
    "message": "Not found"
}

HTTP Code: 404 Not Found

{
    "code": 404,
    "resource": "A2F Method",
    "message": "Not found"
}