Fase 6: Verificare un documento in un libro mastro

Con Amazon QLDB, puoi verificare in modo efficiente l'integrità di un documento nel giornale contabile utilizzando l'hashing crittografico con SHA-256. In questo esempio, Alexis e Brent decidono di passare a un nuovo modello scambiando il veicolo con VIN1N4AL11D75C109151 presso un concessionario di automobili. La concessionaria avvia il processo verificando la proprietà del veicolo presso l'ufficio di immatricolazione.

Per ulteriori informazioni su come funzionano la verifica e l'hashing crittografico in QLDB, consultaVerifica dei dati in Amazon QLDB.

In questo passaggio, si verifica una revisione del documento nelvehicle-registration registro. Innanzitutto, richiedi un riassunto, che viene restituito come file di output e funge da firma dell'intera cronologia delle modifiche del tuo libro contabile. Quindi, richiedi una prova della revisione relativa a quel riassunto. Utilizzando questa prova, l'integrità della revisione viene verificata se tutti i controlli di convalida vengono superati.

Per richiedere un riassunto

1. Apri la console Amazon QLDB all'indirizzo https://console.aws.amazon.com/qldb.

2. Nel riquadro di navigazione, selezionare Ledgers (libro mastro).

3. Nell'elenco dei libri contabili, selezionarevehicle-registration.

4. Scegli Get digest. La finestra di dialogo Ottieni riassunto mostra i seguenti dettagli del riassunto:

   • Digest: il valore hash SHA-256 del digest richiesto.

   • Indirizzo suggerito per il riassunto: l'ultima posizione del blocco nel diario a cui si riferisce il riassunto richiesto. Un indirizzo ha i seguenti due campi:

     • strandId— L'ID univoco del filone del journal che contiene il blocco.

     • sequenceNo— Il numero di indice che specifica la posizione del blocco all'interno del filamento.

   • Libro contabile: il nome del libro contabile per il quale è stato richiesto un riassunto.

   • Data: il timestamp in cui hai richiesto il digest.

5. Verificare le informazioni del riassunto. Quindi scegli Save (Salva). Puoi mantenere il nome del file predefinito o immettere un nuovo nome del file.

   Questo passaggio salva un file di testo in chiaro con contenuti in formato Amazon Ion. Il file ha l'estensione del nome di file.ion.txt e contiene tutte le informazioni del riassunto elencate nella finestra di dialogo precedente. Di seguito è riportato un esempio del contenuto di un file digest. L'ordine dei campi può variare a seconda del browser.

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

6. Salva questo file dove potrai accedervi in seguito. Nei passaggi seguenti, si utilizza questo file per verificare la revisione di un documento.

Dopo aver salvato un riassunto contabile, puoi iniziare il processo di verifica della revisione di un documento rispetto a quel riepilogo.

Nota

In un caso d'uso di produzione per la verifica, si utilizza un riassunto precedentemente salvato anziché eseguire le due attività consecutivamente. Come buona prassi, richiedi e salva il riassunto non appena una revisione che desideri verificare in seguito viene scritta nel giornale.

Per verificare la revisione di un documento

1. Per prima cosa, interroga ilid libro mastro per la fineblockAddress della revisione del documento che desideri verificare. Questi campi sono inclusi nei metadati del documento, che puoi interrogare nella vista confermata.

   Il documentoid è una stringa ID univoca assegnata dal sistema. blockAddressÈ una struttura a ioni che specifica la posizione del blocco in cui è stata eseguita la revisione.

   Nel riquadro di navigazione della console QLDB, selezionare l'editor PartiQL (PartiQL).

2. Scegli ilvehicle-registration libro mastro.

3. Nella finestra dell'editor di query, immettete la seguente istruzione, quindi scegliete Esegui.

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

4. Copia e salva iblockAddress valoriid e restituiti dall'interrogazione. Assicurati di omettere le virgolette doppie per ilid campo. In Amazon Ion, i tipi di dati di tipo stringa sono delimitati da virgolette doppie.

5. Ora che hai selezionato una revisione del documento, puoi iniziare il processo di verifica.

   Nel riquadro di navigazione, selezionare Verificare.

6. Nel modulo Verifica documento, in Specifica il documento che desideri verificare, inserisci i seguenti parametri di input:

   • Ledger: sceglivehicle-registration.

   • Indirizzo di blocco: ilblockAddress valore restituito dall'interrogazione nel passaggio 3.

   • ID documento: ilid valore restituito dall'interrogazione nel passaggio 3.

7. In Specifica il riassunto da utilizzare per la verifica, seleziona il riassunto che hai salvato in precedenza scegliendo Scegli riassunto. Se il file è valido, compila automaticamente tutti i campi del riepilogo sulla tua console. In alternativa, puoi copiare e incollare manualmente i seguenti valori direttamente dal tuo file di digest:

   • Digest: ildigest valore del file di riepilogo.

   • Indirizzo del suggerimento del digest: ildigestTipAddress valore del file del digest.

8. Controlla il documento e riepiloga i parametri di input, quindi scegli Verifica.

   La console automatizza due passaggi per te:

   1. Richiedi una prova a QLDB per il documento specificato.

   2. Usa la bozza restituita da QLDB per chiamare un'API lato client, che verifica la revisione del documento rispetto al digest fornito.

   La console visualizza i risultati della richiesta nella scheda dei risultati della verifica. Per ulteriori informazioni, consulta Risultati della verifica.

9. Per testare la logica di verifica, ripeti i passaggi da 6 a 8 in Per verificare una revisione del documento, ma modifica un singolo carattere nella stringa di input Digest. Ciò dovrebbe far sì che la tua richiesta di verifica fallisca con un messaggio di errore appropriato.

Se non è più necessario utilizzare ilvehicle-registration libro mastro, procedere aFase 7 (opzionale): eliminazione delle risorse.