Complete Register Second Factor Authentication
Tiene la función de completar un proceso de registro de A2F que esté en caso que sea requerido. Actualmente los A2F que requieren un segundo paso para completar su registro son:
- A2F por SMS
- A2F por EMAIL
Para completar el registro de un a2f se deben ingresar los siguientes campos:
Key | Example | Description |
---|---|---|
method | sms | Indica el tipo de autenticación que se está verificando. |
verification_id | 61aa | Código recibido en el endpoint 'Register Authentication' con el que se tiene acceso a la verificación que está pendiente. |
totp | 1234 | Código de un uso que recibe el usuario para corroborar que el número ingresado en el primer paso (endpoint Register Authentication) le pertenece. |
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/registrations
caution
Recuerda que para utilizar este endpoint es necesario un access token obtenido en el servicio Atenea
Body
{
"method": "sms",
"company_id": "1",
"verification_id": "iqxliozxcya87dam",
"totp": "3912"
}
Code Examples
- Curl
- JavaScript
- Python
curl --location --request POST 'https://cerberus.trust.lat/v1/authentications/1/registrations' \
--data-raw '{
"method": "sms",
"verification_id": "61ae6f88f6a47ab3a297da45",
"totp": "9326"
}'
import requests
url = "https://cerberus.trust.lat/v1/authentications/1/registrations"
payload = "{\n \"method\": \"sms\",\n \"verification_id\": \"61ae6f88f6a47ab3a297da45\",\n \"totp\": \"9326\"\n}"
headers = {}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
var axios = require('axios');
var data = '{\n "method": "sms",\n "verification_id": "61ae6f88f6a47ab3a297da45",\n "totp": "9326"\n}';
var config = {
method: 'post',
url: 'https://cerberus.trust.lat/v1/authentications/1/registrations',
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
{
"code": 200,
"resource": "Verification",
"data": {
"created_at": "2022-02-22T18:33:36.458Z",
"status": "done",
"uid": "61ae6f88f6a47ab3a297da45",
"updated_at": "2022-02-22T18:37:10.890Z"
},
"message": "Ok"
}
Responses
HTTP Code: 404 Not Found
Esta respuesta indicará que se requiere completar un segundo paso.
{
"code": 404,
"resource": "Verification",
"message": "Not found"
}