Paso 6: Verificación de un documento en un libro mayor - Amazon Quantum Ledger Database (Amazon QLDB)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Paso 6: Verificación de un documento en un libro mayor

Con Amazon QLDB, puede verificar eficazmente la integridad de un documento en el diario de su libro mayor utilizando hash criptográfico con SHA-256. En este ejemplo, Alexis y Brent deciden actualizar a un nuevo modelo comerciando el vehículo con VIN1N4AL11D75C109151en 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, consulteVerificación de datos en Amazon QLDB.

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

Para solicitar un resumen

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

  2. En el panel de navegación, elijaLibros de contabilidad.

  3. En la lista de contabilidad, seleccionevehicle-registration.

  4. ElegirObtener resumen. LaObtener resumenmuestra los siguientes detalles de resumen:

    • Digerir— El valor hash SHA-256 del resumen solicitado.

    • Dirección de consejo de resumen— La más recientebloqueubicación en el diario cubierto por el resumen que solicitó. Una dirección de tiene los siguientes dos campos:

      • strandId: ID exclusivo de la cadena de diario que contiene el bloque.

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

    • Registro— El nombre del libro mayor para el que solicitó un resumen.

    • Fecha— La marca de hora cuando solicitó el resumen.

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

    En este paso se guarda un archivo de texto sin formato con contenido enAmazon Ionformato. El archivo tiene una extensión de nombre de archivo de.ion.txty contiene toda la información de resumen que aparece en el cuadro de diálogo anterior. El siguiente ejemplo muestra el 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 donde pueda acceder a él más adelante. En los siguientes pasos, utilizará este archivo para verificar una revisión de un documento.

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

nota

En un caso de uso de producción para la verificación, se utiliza un resumen que se ha guardado anteriormente 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 la revista una revisión que desea verificar más adelante.

Para verificar la revisión de un documento

  1. En primer lugar, consulte a su libro mayor elidyblockAddressde la revisión del documento que desea verificar. Estos campos se incluyen en los metadatos del documento, que puede consultar en la vista confirmada.

    Documentoides una cadena de ID única asignada por el sistema. LablockAddresses una estructura de iones que especifica la ubicación del bloque en la que se ha confirmado la revisión.

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

  2. Elija el iconovehicle-registrationlibro mayor.

  3. En la ventana del editor de consultas, escriba la siguiente instrucción y elijaEjecución de.

    SELECT r.metadata.id, r.blockAddress FROM _ql_committed_VehicleRegistration AS r WHERE r.data.VIN = '1N4AL11D75C109151'
  4. Copie y guarde laidyblockAddressvalores que devuelve la consulta. Asegúrese de omitir las comillas dobles para elid. En Amazon Ion, los tipos de datos de cadenas se delimitan con comillas dobles.

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

    En el panel de navegación, elijaVerificación.

  6. En la páginaVerificar documentoformulario, enEspecifique el documento que desea verificar, introduzca los siguientes parámetros de entrada:

    • Registro— Seleccionevehicle-registration.

    • Dirección de bloqueo— ElblockAddressvalor devuelto por la consulta en el paso 3.

    • ID de documento— Elidvalor devuelto por la consulta en el paso 3.

  7. UNDEREspecificar el resumen que se utilizará para la verificación, seleccione el resumen que guardó anteriormente eligiendoSeleccione resumen. Si el archivo es válido, rellena 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:

    • Digerir— EldigestValor de su archivo de resumen.

    • Dirección de consejo de resumen— EldigestTipAddressValor de su archivo de resumen.

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

    La consola automatiza dos pasos para ti:

    1. Solicite una prueba de 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 con respecto al resumen proporcionado.

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

  9. Para probar la lógica de verificación, repita los pasos 6 a 8 enPara verificar la revisión de un documento, pero cambie un carácter en laDigerircadena de entrada. Esto debería causar suVerificarsolicitar que no aparezca un mensaje de error adecuado.

Si ya no tiene que utilizar lavehicle-registrationcontabilidad, siga conPaso 7 (Opcional): Limpiar recursos.