Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
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
Öffnen Sie die QLDB Amazon-Konsole unter https://console.aws.amazon.com/qldb
. -
Wählen Sie im Navigationsbereich Ledgers aus.
-
Wählen Sie in der Liste der Ledgers
vehicle-registration
aus. -
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.
-
-
Ü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" }
-
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
-
Führen Sie zunächst eine Abfrage Ihres Ledgers für die
id
und dieblockAddress
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. DasblockAddress
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.
-
Wählen Sie den
vehicle-registration
-Ledger aus. -
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'
-
Kopieren und speichern Sie die
id
- undblockAddress
-Werte, die Ihre Abfrage zurückgibt. Achten Sie darauf, dass Sie die doppelten Anführungszeichen für dasid
-Feld auslassen. In Amazon Ion werden Zeichenfolge-Datentypen in doppelte Anführungszeichen gesetzt. -
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.
-
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.
-
-
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.
-
-
Ü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:
-
Fordern Sie ein Formular für einen Nachweis QLDB für das von Ihnen angegebene Dokument an.
-
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.
-
-
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.