Skip to main content

Marcas de tiempo

Objetivo Bre-B

Bre-B espera realizar un seguimiento preciso de los tiempos necesarios para resolver las claves y ejecutar las operaciones de transferencia. El objetivo del banco central es eliminar la latencia de la red en los reportes de marcas de tiempo. La razón principal de este modelo es que la mayoría de los participantes utilizan un sistema basado en colas y comunicación síncrona.

Monitoreo Transfiya

La plataforma Transfiya es una plataforma nativa en la nube que registra automáticamente todas las interacciones durante las solicitudes y respuestas a las llamadas API. El monitoreo de las marcas de tiempo se realiza automáticamente por la plataforma, siendo opcional para los participantes la adición de marcas de tiempo específicas.
Mayoria de marcas de tiempo son registradas automáticamente por la plataforma.

DICE requerimentos

Mapeo de marcas de tiempo

Las marcas de tiempo del DICE aplican únicamente a dos operaciones: el proceso de incorporación (onboarding) y la resolución de llaves. Este mapeo se basa en el siguiente documento:
Código de mensajeNombre del mensajeDescripción del mensajePartes involucradas
admn.001.001.01Solicitud de gestión de redUtilizado para conectar/desconectar y verificar el estado de la conexión. Operaciones: SignOn, SignOff, EchoTestTransfiYa → DICE
admn.002.001.01Respuesta de gestión de redRespuesta a admn.001DICE → Transfiya
prxy.001.001.01Solicitud de registro de proxyUtilizado para gestionar llaves. Operaciones:
NEWR, AMND, DEAC, SUSP, SUSB, ACTV, ACTBTransfiya → DICE
prxy.002.001.01Respuesta de registro de proxyRespuesta a prxy.001DICE → Transfiya
admi.002.001.01Mensaje de rechazoParece ser un mensaje de error que puede devolverse como respuesta a otros mensajes. No hay flujos de ejemplo con este mensaje en la documentación.DICE → TransfiYa
prxy.003.001.01Solicitud de resolución de proxyUtilizado para resolver llaves desde el directorio de aliasTransfiya → DICE
prxy.004.001.01Respuesta de resolución de proxyRespuesta a prxy.003DICE → Transfiya

Registro de Llaves

El sistema transfiya ya permite consulta de llaves usando el protocolo de resolución de llaves y registro de marcas de tiempo. Para cubrir el caso de incorporación (onboarding), TransfiYa añade nuevas etiquetas al payload del firmante. Estas etiquetas representan las marcas de tiempo que los participantes necesitan recopilar:
  • received → el momento en que un participante recibió una solicitud del usuario para incorporarse, cuando el usuario hace clic en la aplicación
  • dispatched → el momento en que un participante envió una solicitud de incorporación a Transfiya, cuando se llama a la API de creación de firmante
Paso del flujo de procesamientoMarca de tiempo DICEMensaje DICEOperación DICECampo de mensajeríaParte responsableDescripción de marca de tiempo
1 (fin)R101prxy.001.001.01NEWRsigner.labels.receivedParticipanteUn participante recibe una solicitud de registro de llave de un cliente.
3 (inicio)R103prxy.001.001.01NEWRsigner.labels.dispatchedParticipanteEl participante envía una solicitud de registro de llave a Transfiya.
3 (fin)R201prxy.001.001.01NEWRno apclicableTransfiyaTransfiya recibe una solicitud de registro de llave del participante.
4 (inicio)R203prxy.001.001.01NEWRno aplicableTransfiyaTransfiya envía una solicitud de registro de llave a DICE.
4 (fin)R301prxy.001.001.01NEWRprxy.002.001.01 (paso 5) R301DICEDICE recibe una solicitud de registro de llave de Transfiya.
5 (inicio)R303prxy.002.001.01NEWRprxy.002.001.01 (paso 5) R303DICEDICE envía una respuesta de registro de llave a Transfiya.
5 (fin)R205prxy.002.001.01NEWRno aplicableTransfiyaTransfiya recibe una respuesta de registro de llave de DICE.
7 (inicio)R207prxy.002.001.01NEWRno aplicableTransfiyaTransfiya envía una respuesta de registro de llave al participante.
7 (fin)R105prxy.002.001.01NEWRno aplicableParticipanteEl participante recibe una respuesta de registro de llave de Transfiya.
8 (inicio)R107prxy.002.001.01NEWRno aplicableParticipanteEl participante notifica al cliente sobre el resultado del registro de llave.

Resolución de Llaves

Este modelo es actualmente opcional y no se habilitará hasta que comencemos las pruebas de integración con MOL.
Las marcas de tiempo necesarias para la resolución de llaves siguen un patrón similar a las requeridas durante el proceso de incorporación. Los requisitos relacionados con los participantes pueden satisfacerse mediante la incorporación de los mismos dos campos mencionados anteriormente. Dado que los participantes deben enviar estos campos y efectivamente almacenan información adicional en el sistema con esta solicitud, la petición de resolución se implementa como una solicitud POST en lugar de GET: POST /v1/signer/lookup.dice El cuerpo de esta solicitud contiene el valor del llave que se está resolviendo y las marcas de tiempo requeridas:
{
  "aliasValue": "@jorge22",
  "received": "2025-01-14T20:40:57.322-05:00",
  "dispatched": "2025-01-14T20:40:58.322-05:00"
}
Flujo de Resolución de Llaves:
Marca de tiempo DICEMensaje DICECampo de mensajeríaPaso del flujo de procesamientoParte responsableDescripción de marca de tiempo
C110prxy.003.001.01solicitud de búsqueda de firmante received1 (fin)ParticipanteUn participante recibe una solicitud de resolución de llave de un cliente.
C120prxy.003.001.01solicitud de búsqueda de firmante dispatched2 (inicio)ParticipanteEl participante envía una solicitud de resolución de llave a Transfiya.
C210prxy.003.001.01no disponible sobre API2 (fin)TransfiyaTransfiya recibe una solicitud de resolución de llave del participante.
C215prxy.003.001.01no disponible sobre API4 (inicio)TransfiyaTransfiya envía una solicitud de resolución de llave a DICE.
C310prxy.003.001.01prxy.004.001.01 (paso 5) C3104 (fin)DICEDICE recibe una solicitud de resolución de llave de Transfiya.
C320prxy.004.001.01prxy.004.001.01 (paso 5) C3205 (inicio)DICEDICE envía una respuesta de resolución de llave a Transfiya.
C230prxy.004.001.01no disponible sobre API5 (fin)TransfiyaTransfiya recibe una respuesta de resolución de llave de DICE.
C240prxy.004.001.01no disponible sobre API7 (inicio)TransfiyaTransfiya envía una respuesta de resolución de llave al participante.
C130prxy.004.001.01no disponible sobre API7 (fin)ParticipanteEl participante recibe una respuesta de resolución de llave de Transfiya.
C140prxy.004.001.01no disponible sobre API8 (inicio)ParticipanteEl participante notifica al cliente sobre el resultado de la resolución de llave.
Documento de referencia - Directorio Centralizado DICE Versión 2.2.1
I