Schritt 6: Verifizieren Sie ein Dokument in einem Ledger

Wichtig

Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter Migrieren eines Amazon QLDB Ledgers zu Amazon Aurora SQL Postgre.

Mit Amazon QLDB können Sie die Integrität eines Dokuments in Ihrem Hauptbuch effizient überprüfen, indem Sie kryptografisches Hashing mit -256 verwenden. SHA In diesem Beispiel beschließen Alexis und Brent, auf ein neues Modell umzusteigen, indem sie das Fahrzeug bei einem Autohaus eintauschen. VIN 1N4AL11D75C109151 Der Vertragshändler startet den Prozess, indem er die Eigentümerschaft des Fahrzeugs bei der Zulassungsstelle überprüft.

Weitere Informationen zur Funktionsweise von Verifizierung und kryptografischem Hashing finden Sie unter. QLDB Datenüberprüfung bei Amazon QLDB

In diesem Schritt überprüfen Sie eine Dokumentreversion im vehicle-registration-Ledger. Zuerst fordern Sie einen Digest an, der als Ausgabedatei zurückgegeben wird und als Signatur des gesamten Änderungsverlaufs Ihres Ledgers fungiert. Anschließend fordern Sie einen Nachweis für die Revision in Bezug auf diesen Digest an. Mit diesem Nachweis wird die Integrität Ihrer Revision verifiziert, wenn alle Validierungsprüfungen bestanden werden.

So fordern Sie ein Digest an

1. Öffnen Sie die QLDB Amazon-Konsole unter https://console.aws.amazon.com/qldb.

2. Wählen Sie im Navigationsbereich Ledgers aus.

3. Wählen Sie in der Liste der Ledgers vehicle-registration aus.

4. Wählen Sie Get digest (Digest abrufen). Dasm Dialogfeld Get digest (Digest abrufen) zeigt die folgenden Digest-Details:

   • Digest — Der Hashwert SHA -256 des Digests, den Sie angefordert haben.

   • Adresse des Digest-Tipps — Die letzte Blockposition im Journal, auf die sich der von Ihnen angeforderte Digest bezieht. Eine Adresse hat die folgenden zwei Felder:

     • strandId— Die eindeutige ID des Journalstrangs, der den Block enthält.

     • sequenceNo— Die Indexnummer, die die Position des Blocks innerhalb des Strangs angibt.

   • Ledger — Der Ledger-Name, für den Sie einen Digest angefordert haben.

   • Datum — Der Zeitstempel, zu dem Sie den Digest angefordert haben.

5. Überprüfen Sie die Digest-Informationen. Wählen Sie dann Speichern. Sie können den Standard-Dateinamen behalten oder einen neuen Namen eingeben.

   Dieser Schritt speichert eine Klartext-Datei mit Inhalten im Amazon Ion-Format. Die Datei verfügt über die Dateinamenerweiterung .ion.txt und enthält alle Digest-Informationen, die im vorherigen Dialogfeld aufgelistet wurden. Im Folgenden finden Sie ein Beispiel für die Inhalte einer Digest-Datei. Die Reihenfolge der Felder kann je nach Browser variieren.

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

6. Speichern Sie diese Datei an einem Ort, an dem Sie später darauf zugreifen können. In den folgenden Schritten verwenden Sie diese Datei, um die Revision eines Dokuments anhand dieser Datei zu überprüfen.

Nachdem Sie ein Ledger-Digest gespeichert haben, können Sie eine Dokumentrevision in Bezug auf diesen Digest überprüfen.

Anmerkung

In einem produktiven Anwendungsfall für die Überprüfung verwenden Sie eine Zusammenfassung, die zuvor gespeichert wurde, anstatt die beiden Aufgaben nacheinander auszuführen. Es hat sich bewährt, den Digest anzufordern und zu speichern, sobald eine Revision, die Sie später überprüfen möchten, in das Journal geschrieben wird.

So überprüfen Sie eine Dokumentrevision

1. Führen Sie zunächst eine Abfrage Ihres Ledgers für die id und die blockAddress der Dokumentrevision durch, die Sie verifizieren möchten. Diese Felder sind in den Metadaten des Dokuments enthalten. Sie können diese Abfrage in der bestätigten Ansicht vornehmen.

   Das Dokument id ist eine vom System zugewiesene eindeutige ID-Zeichenfolge. Das blockAddress ist eine Ionen-Struktur, die den Blockspeicherort angibt, an dem die Revision übertragen wurde.

   Wählen Sie im Navigationsbereich der QLDB Konsole PartiQL editor aus.

2. Wählen Sie den vehicle-registration-Ledger aus.

3. Geben Sie im Fenster des Abfrageeditors die folgende Anweisung ein und klicken Sie dann auf Run (Ausführen).

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

4. Kopieren und speichern Sie die id- und blockAddress-Werte, die Ihre Abfrage zurückgibt. Achten Sie darauf, dass Sie die doppelten Anführungszeichen für das id-Feld auslassen. In Amazon Ion werden Zeichenfolge-Datentypen in doppelte Anführungszeichen gesetzt.

5. Nachdem Sie eine Dokumentrevision ausgewählt haben, können Sie damit beginnen, sie zu überprüfen.

   Wählen Sie im Navigationsbereich die Option Verification (Überprüfung) aus.

6. Geben Sie auf dem Formular Verify document (Dokument überprüfen) unter Specify the document that you want to verify (Das Dokument angeben, das Sie überprüfen möchten) die folgenden Eingabeparameter ein:

   • Ledger — Wählen Sie. vehicle-registration

   • Blockadresse — Der von Ihrer Abfrage in Schritt 3 zurückgegebene blockAddress Wert.

   • Dokument-ID — Der von Ihrer Abfrage in Schritt 3 zurückgegebene id Wert.

7. Wählen Sie unter Specify the document that you want to verify (Das Dokument angeben, das Sie überprüfen möchten) den Digest aus, den Sie zuvor gespeichert haben, indem Sie Choose digest (Digest auswählen) auswählen. Wenn die Datei gültig ist, werden alle Digest-Felder auf Ihrer Konsole automatisch gefüllt. Sie können die folgenden Werte auch manuell direkt aus Ihrer Digest-Datei kopieren und einfügen:

   • Digest — Der digest Wert aus Ihrer Digest-Datei.

   • Adresse des Digest-Tipps — Der digestTipAddress Wert aus Ihrer Digest-Datei.

8. Überprüfen Sie Ihre Dokument- und Digest-Eingabeparameter und wählen Sie anschließend Verify (Überprüfen) aus.

   Die Konsole automatisiert zwei Schritte für Sie:

   1. Fordern Sie ein Formular für einen Nachweis QLDB für das von Ihnen angegebene Dokument an.

   2. Verwenden Sie den von zurückgesandten Nachweis, QLDB um einen Kunden anzurufenAPI, der die Überarbeitung Ihres Dokuments anhand der bereitgestellten Zusammenfassung überprüft.

   Die Konsole zeigt die Ergebnisse Ihrer Anforderung in der Karte Verification results (Überprüfungsergebnisse) an. Weitere Informationen finden Sie unter Ergebnisse der Überprüfung.

9. Um die Überprüfungslogik zu testen, wiederholen Sie die Schritte 6—8 unter So überprüfen Sie eine Dokumentrevision, ändern Sie jedoch ein einzelnes Zeichen in der Digest-Eingabezeichenfolge. Dies sollte dazu führen, dass Ihre Verify-Anforderung (Überprüfungsanforderung) fehlschlägt und eine entsprechende Fehlermeldung ausgegeben wird.

Wenn Sie den vehicle-registration-Ledger nicht mehr verwenden müssen, fahren Sie mit Schritt 7 (optional): Ressourcen bereinigen fort.