Saltar al contenido principal

Cifrado Persistentes

caution

Para utilizar esta funcionalidad debes solicitar la activación con el equipo de soporte.

info

Preview: Esta funcionalidad se encuentra aun en modo preview, por lo cual aun puede tener cambios en su implementación.

info

No disponible en Sandbox

Cifrando las credenciales del usuario​

Esta funcionalidad utiliza nuestro servicio especializado para realizar el cifrado de las credenciales y poder utilizarlas de forma persistente. El caso de uso para esta funcionalidad es cuando se require obtener un o mas sets de datos de forma periódica sin tener que solicitar la interacción del usuario.

info

Al igual que la funcionalidad de extracción, en ningún caso se almacenarán las credenciales del usuario o algún dato sensible en nuestra plataforma.

Si deseas conocer mas sobre esto puede contactarnos en el formulario que se encuentra en https://boufin.com

Obtener un ciphertext​

Para obtener un ciphertext debes realizar una petición a nuestro servicio de cifrado, el cual te devolverá un ciphertext que podrás utilizar para realizar las peticiones de extracción de datos.

curl --request POST \
  'https://${URL}/api/v1/cipher' \
  -H 'Authorization: Bearer ${TOKEN}' \
  -H 'Content-Type: application/json' \
  -data-raw '{
    "args": {
        "username": "11.111.111-1",
        "password": "123456789abcdf"
    }
  }'

Response

{
  "cipheredArgs": "sdfAgNUFdLoF7eDGAcB3BB17gEhWG+3Q6Q5Z6Q=="
}

Validar el ciphertext​

Para validar el ciphertext debes realizar una petición a nuestro servicio de validación, el cual te devolverá un request http 204 si el ciphertext es válido.

curl --request POST \
  'https://${URL}/api/v1/cipher/is-cipher-valid' \
  -H 'Authorization: Bearer ${TOKEN}' \
  -H 'Content-Type: application/json' \
  -data-raw '{
    "cipheredArgs": "sdfAgNUFdLoF7eDGAcB3BB17gEhWG+3Q6Q5Z6Q=="
  }'

Iniciar proceso de extracción con credenciales cifradas​

Endpoint: POST /api/v1/tasks

Request

curl --request POST \
  'https://${URL}/api/v1/tasks' \
  -H 'Authorization: Bearer ${TOKEN}' \
  -H 'Content-Type: application/json' \
  -data-raw '{
    "action": "banco-santander:tef",
    "cipheredArgs": "sdfAgNUFdLoF7eDGAcB3BB17gEhWG+3Q6Q5Z6Q=="
  }'

Response

{
  "taskId": "5cbae0b5e1b5d035d99469f42c653ff4bb8aecdf9dbdb8e10f45a31677683369"
}