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:

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
JavaScript
Python

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

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