Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Fase 6: Verificare un documento in un libro mastro
<a name="getting-started-step-6"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Con Amazon QLDB, puoi verificare in modo efficiente l'integrità di un documento nel diario del tuo libro mastro utilizzando l'hashing crittografico con SHA-256. In questo esempio, Alexis e Brent decidono di passare a un nuovo modello permutando il veicolo con VIN presso un concessionario di automobili. `1N4AL11D75C109151` Il concessionario 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, consulta. [Verifica dei dati in Amazon QLDB](verification.md)

In questo passaggio, verifichi una revisione del documento nel registro. `vehicle-registration` Innanzitutto, richiedi un digest, che viene restituito come file di output e funge da firma dell'intera cronologia delle modifiche del registro. Quindi, richiedi una bozza della revisione relativa a quel digest. Utilizzando questa prova, l'integrità della revisione viene verificata se tutti i controlli di convalida vengono superati.

## Per richiedere un riassunto
<a name="getting-started-step-6.digest"></a>

1. [Apri la console Amazon QLDB in /qldb. https://console.aws.amazon.com](https://console.aws.amazon.com/qldb)

1. **Nel pannello di navigazione, scegli Ledgers.**

1. Nell'elenco dei libri contabili, seleziona. `vehicle-registration`

1. Scegli **Get digest**. La finestra di dialogo **Get digest** mostra i seguenti dettagli del digest:
   + **Digest**: il valore hash SHA-256 del digest richiesto.
   + **Indirizzo del suggerimento del digest**: l'ultima posizione del [blocco](verification.md#verification.structure) nel diario coperta dal digest richiesto. Un indirizzo ha i due campi seguenti:
     + `strandId`— L'ID univoco del filone di giornale che contiene il blocco.
     + `sequenceNo`— Il numero di indice che specifica la posizione del blocco all'interno del trefolo.
   + **Libro contabile**: il nome del libro contabile per il quale è stato richiesto un digest.
   + **Data**: il timestamp in cui è stato richiesto il digest.

1. Rivedi le informazioni del riepilogo. Quindi scegli **Save** (Salva). È possibile mantenere il nome di file predefinito o immettere un nuovo nome.

   Questo passaggio salva un file di testo semplice con contenuti in formato [Amazon Ion.](ion.md) Il file ha un'estensione di `.ion.txt` e contiene tutte le informazioni digest 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 utilizzato.

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

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

Dopo aver salvato un registro digest, è possibile avviare il processo di verifica della revisione di un documento rispetto a tale digest.

**Nota**  
In un caso d'uso di produzione per la verifica, si utilizza un digest salvato in precedenza anziché eseguire le due attività consecutivamente. Come procedura consigliata, richiedi e salva il digest non appena una revisione che desideri verificare in un secondo momento viene scritta nel diario.

## Per verificare la revisione di un documento
<a name="getting-started-step-6.verify"></a>

1. Innanzitutto, interroga il registro per verificare `id` la fine `blockAddress` della revisione del documento che desideri verificare. Questi campi sono inclusi nei metadati del documento, ai quali è possibile eseguire una query nella visualizzazione confermata.

   Il documento `id` è una stringa ID univoca assegnata dal sistema. `blockAddress`È una struttura ionica che specifica la posizione del blocco in cui è stata eseguita la revisione.

   **Nel pannello di navigazione della console QLDB, scegli Editor PartiQL.**

1. Scegli il libro mastro. `vehicle-registration`

1. Nella finestra dell'editor di query, inserisci la seguente istruzione, quindi scegli **Esegui**.

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

1. Copia e salva i `blockAddress` valori `id` and restituiti dalla query. Assicurati di omettere le virgolette doppie per il `id` campo. In Amazon Ion, i tipi di dati stringa sono delimitati da virgolette doppie.

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

   **Nel riquadro di navigazione, scegli Verifica.**

1. Nel modulo **Verifica documento**, in **Specificare il documento che desideri verificare**, inserisci i seguenti parametri di input:
   + **Ledger**: scegli`vehicle-registration`.
   + **Indirizzo di blocco**: il `blockAddress` valore restituito dalla query nel passaggio 3.
   + **ID documento**: il `id` valore restituito dalla query nel passaggio 3.

1. In **Specificare il digest da utilizzare per la verifica**, seleziona il digest salvato in precedenza scegliendo **Scegli** digest. Se il file è valido, compila automaticamente tutti i campi digest sulla console. In alternativa, puoi copiare e incollare manualmente i seguenti valori direttamente dal tuo file digest:
   + **Digest**: il `digest` valore del file digest.
   + **Indirizzo del suggerimento digest**: il `digestTipAddress` valore del file digest.

1. **Esamina i parametri di input del documento e digest, quindi scegli Verifica.**

   La console automatizza due passaggi per te:

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

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

   **La console mostra i risultati della richiesta nella scheda dei risultati della verifica.** Per ulteriori informazioni, consulta [Risultati della verifica](verification.results.md).

1. Per testare la logica di verifica, ripeti i passaggi 6—8 in **Per verificare la revisione di un documento**, ma modifica un singolo carattere nella stringa di input **Digest**. Ciò dovrebbe causare l'esito negativo della richiesta di **verifica** con un messaggio di errore appropriato.

Se non hai più bisogno di usare il `vehicle-registration` libro mastro, procedi [Passaggio 7 (opzionale): Pulisci le risorse](getting-started-step-7.md) con.