Paso 6: Verificar un documento en un libro mayor

Con Amazon QLDB, puede verificar de manera eficiente la integridad de un documento del diario de su libro mayor mediante el uso de hash criptográfico con SHA-256. En este ejemplo, Alexis y Brent deciden cambiarse a un nuevo modelo cambiando el vehículo con VIN 1N4AL11D75C109151 en un concesionario de automóviles. El concesionario inicia el proceso verificando la propiedad del vehículo en la oficina de registro.

Para obtener más información sobre cómo funcionan la verificación y el hash criptográfico en QLDB, consulte Verificación de datos en Amazon QLDB.

En este paso, verificará la revisión de un documento en el libro mayor vehicle-registration. En primer lugar, solicita un resumen, que se devuelve como un archivo de salida y actúa como firma de todo el historial de cambios del libro mayor. A continuación, solicita una prueba de la revisión relativa a ese resumen. Con esta prueba, se verifica la integridad de la revisión si se aprueban todas las comprobaciones de validación.

Para solicitar un resumen

1. Abra la consola de Amazon QLDB en https://console.aws.amazon.com/qldb.

2. En el panel de navegación, elija Libros mayores.

3. En la lista de roles, seleccione vehicle-registration.

4. Seleccione Obtener resumen. El cuadro de diálogo Obtener resumen muestra los siguientes detalles del resumen:

   • Resumen: el valor hash SHA-256 del resumen que ha solicitado.

   • Dirección de la sugerencia del resumen: la última ubicación de bloque del diario incluida en el resumen que ha solicitado. Una dirección tiene los dos campos siguientes:

     • strandId: el identificador único de la cadena del diario que contiene el bloque.

     • sequenceNo: el número de índice que especifica la ubicación del bloque dentro de la cadena.

   • Libro mayor: nombre del libro mayor para el que ha solicitado un resumen.

   • Fecha: fecha y hora en que solicitó el resumen.

5. Revise la información del resumen. A continuación, elija Save. Puede conservar el nombre de archivo predeterminado o introducir un nombre nuevo.

   Este paso guarda un archivo de texto sin formato con el contenido en formato Amazon Ion. El archivo tiene una extensión de nombre de archivo de .ion.txt y contiene toda la información resumida que aparecía en el cuadro de diálogo anterior. A continuación se muestra un extracto de ejemplo del contenido de un archivo de resumen. El orden de los campos puede variar en función del navegador.

   {
     "digest": "42zaJOfV8iGutVGNaIuzQWhD5Xb/5B9lScHnvxPXm9E=",
     "digestTipAddress": "{strandId:\"BlFTjlSXze9BIh1KOszcE3\",sequenceNo:73}",
     "ledger": "vehicle-registration",
     "date": "2019-04-17T16:57:26.749Z"
   }

6. Guarde este archivo en algún lugar al que pueda acceder más adelante. En los pasos siguientes, utilizará este archivo para comparar la revisión de un documento.

Una vez guardado un resumen del libro mayor, puede iniciar el proceso de verificación de una revisión de un documento comparándolo con ese resumen.

nota

En un caso de uso de producción para la verificación, se utiliza un resumen que se haya guardado previamente en lugar de realizar las dos tareas de forma consecutiva. Como práctica recomendada, solicite y guarde el resumen tan pronto como se escriba en el diario una revisión que desee verificar más adelante.

Para verificar la revisión de un documento

1. En primer lugar, consulte en el libro mayor el id y la blockAddress de la revisión del documento que desee comprobar. Estos campos se incluyen en los metadatos del documento, que puede consultar en la vista confirmada.

   El documento id es una cadena de identificación única asignada por el sistema. blockAddress es una estructura de Ion que especifica la ubicación del bloque en la que se efectuó la revisión.

   En el panel de navegación de la consola QLDB, elija Editor PartiQL.

2. Elija el libro mayor vehicle-registration.

3. En la ventana del editor de consultas, introduzca la siguiente instrucción, y a continuación elija Ejecutar.

   SELECT r.metadata.id, r.blockAddress
   FROM _ql_committed_VehicleRegistration AS r 
   WHERE r.data.VIN = '1N4AL11D75C109151'

4. Copie y guarde los valores id y blockAddress que devuelve la consulta. Asegúrese de omitir las comillas dobles del campo id. En Amazon Ion, los tipos de datos de cadena se delimitan con comillas dobles.

5. Ahora que ha seleccionado una revisión del documento, puede iniciar el proceso de verificación.

   En el panel de navegación izquierdo, elija Verificaciones.

6. En el formulario Verificar documento, en Especifique el documento que desea verificar, introduzca los siguientes parámetros de entrada:

   • Libro mayor: seleccione vehicle-registration.

   • Dirección del bloque: el valor blockAddress devuelto por la consulta en el paso 3.

   • ID del documento: el valor id devuelto por la consulta en el paso 3.

7. En Especificar el resumen que se va a usar para la verificación, seleccione el resumen que guardó anteriormente; para ello, seleccione Elegir resumen. Si el archivo es válido, se rellenan automáticamente todos los campos de resumen de la consola. O bien, puede copiar y pegar manualmente los siguientes valores directamente desde el archivo de resumen:

   • Resumen: el valor digest del archivo de resumen.

   • Dirección del tip del resumen: el valor digestTipAddress del archivo de resumen.

8. Revise los parámetros de entrada del documento y del resumen y, a continuación, seleccione Verificar.

   La consola automatiza dos pasos:

   1. Solicite una prueba a QLDB para el documento especificado.

   2. Utilice la prueba devuelta por QLDB para llamar a una API del lado del cliente que verifica la revisión de su documento comparándola con el resumen proporcionado.

   La consola muestra los resultados de su solicitud en la tarjeta de Resultados de la verificación. Para obtener más información, consulte Resultados de verificación.

9. Para probar la lógica de verificación, repita los pasos del 6 al 8 de Para verificar la revisión de un documento, pero cambie un solo carácter de la cadena de entrada del Resumen. Esto debería provocar que la solicitud de Verificación falle y muestre el mensaje de error correspondiente.

Si ya no necesita usar el libro mayor vehicle-registration, continúe con Paso 7 (opcional): limpiar recursos.