Langkah 6: Verifikasi dokumen di buku besar

Dengan Amazon QLDB, Anda dapat secara efisien memverifikasi integritas dokumen dalam jurnal buku besar Anda dengan menggunakan hashing kriptografi dengan SHA-256. Dalam contoh ini, Alexis dan Brent memutuskan untuk meningkatkan ke model baru dengan berdagang kendaraan dengan VIN1N4AL11D75C109151 di dealer mobil. Dealer memulai proses dengan memverifikasi kepemilikan kendaraan dengan kantor pendaftaran.

Untuk mempelajari lebih lanjut tentang cara kerja verifikasi dan hashing kriptografi di QLDB, lihatVerifikasi data di Amazon QLDB.

Pada langkah ini, Anda memverifikasi revisi dokumen divehicle-registration buku besar. Pertama, Anda meminta digest, yang dikembalikan sebagai file output dan bertindak sebagai tanda tangan dari seluruh riwayat perubahan buku besar Anda. Kemudian, Anda meminta bukti untuk revisi relatif terhadap intisari itu. Dengan menggunakan bukti ini, integritas revisi Anda diverifikasi jika semua pemeriksaan validasi lulus.

Untuk meminta intisari

1. Buka konsol Amazon QLDB di https://console.aws.amazon.com/qldb.

2. Di panel navigasi, pilih Buku besar.

3. Dalam daftar buku besar, pilihvehicle-registration.

4. Pilih Dapatkan digest. Kotak dialog Get digest menampilkan rincian mencerna berikut:

   • Digest - Nilai hash SHA-256 dari intisari yang Anda minta.

   • Alamat tip mencerna - Lokasi blok terbaru dalam jurnal yang dicakup oleh intisari yang Anda minta. Alamat memiliki dua bidang berikut:

     • strandId- ID unik untai jurnal yang berisi blok.

     • sequenceNo- Nomor indeks yang menentukan lokasi blok di dalam untai.

   • Buku besar - Nama buku besar yang Anda minta mencerna.

   • Tanggal - Stempel waktu saat Anda meminta intisari.

5. Tinjau informasi yang dicerna. Lalu, pilih Simpan. Anda dapat menyimpan nama file default, atau memasukkan nama baru.

   Langkah ini menyimpan file teks biasa dengan konten dalam format Amazon Ion. File ini memiliki ekstensi nama file.ion.txt dan berisi semua informasi mencerna yang tercantum pada kotak dialog sebelumnya. Berikut ini adalah contoh isi file digest. Urutan bidang dapat bervariasi tergantung pada browser Anda.

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

6. Simpan file ini di mana Anda dapat mengaksesnya nanti. Dalam langkah-langkah berikut, Anda menggunakan file ini untuk memverifikasi revisi dokumen terhadap.

Setelah Anda menyimpan intisari buku besar, Anda dapat memulai proses verifikasi revisi dokumen terhadap intisari itu.

catatan

Dalam kasus penggunaan produksi untuk verifikasi, Anda menggunakan digest yang sebelumnya disimpan daripada melakukan dua tugas secara berurutan. Sebagai praktik terbaik, minta dan simpan intisari segera setelah revisi yang ingin Anda verifikasi nanti ditulis ke jurnal.

Untuk memverifikasi revisi dokumen

1. Pertama, kueri buku besar Anda untukid danblockAddress revisi dokumen yang ingin Anda verifikasi. Bidang ini disertakan dalam metadata dokumen, yang dapat Anda kueri dalam tampilan berkomitmen.

   Dokumenid ini adalah string ID unik yang ditugaskan sistem. ItublockAddress adalah struktur Ion yang menentukan lokasi blok tempat revisi dilakukan.

   Di panel navigasi konsol QLDB, pilih editor PartiQL.

2. Pilihvehicle-registration buku besar.

3. Di jendela editor kueri, masukkan pernyataan berikut, kemudian pilih Run (Jalankan).

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

4. Salin dan simpanid danblockAddress nilai yang dikembalikan kueri Anda. Pastikan untuk menghilangkan tanda kutip ganda untukid bidang. Di Amazon Ion, tipe data string dibatasi dengan tanda kutip ganda.

5. Sekarang setelah Anda memiliki revisi dokumen yang dipilih, Anda dapat memulai proses memverifikasinya.

   Di panel navigasi, pilih Verifikasi.

6. Pada formulir Verifikasi dokumen, di bawah Tentukan dokumen yang ingin Anda verifikasi, masukkan parameter masukan berikut:

   • Ledger - Pilihvehicle-registration.

   • Blokir alamat -blockAddress Nilai yang dikembalikan oleh kueri Anda pada langkah 3.

   • ID Dokumen -id Nilai yang dikembalikan oleh kueri Anda pada langkah 3.

7. Di bawah Tentukan intisari yang akan digunakan untuk verifikasi, pilih intisari yang sebelumnya Anda simpan dengan memilih Choose digest. Jika file valid, ini otomatis mengisi semua bidang intisari di konsol Anda. Atau, Anda dapat menyalin dan menempelkan nilai berikut secara manual langsung dari file digest Anda:

   • Digest -digest Nilai dari file digest Anda.

   • Alamat tip mencerna -digestTipAddress Nilai dari file intisari Anda.

8. Tinjau dokumen Anda dan cerna parameter input, lalu pilih Verifikasi.

   Konsol mengotomatiskan dua langkah untuk Anda:

   1. Minta bukti dari QLDB untuk dokumen yang Anda tentukan.

   2. Gunakan bukti yang dikembalikan oleh QLDB untuk memanggil API sisi klien, yang memverifikasi revisi dokumen Anda terhadap intisari yang disediakan.

   Konsol menampilkan hasil permintaan Anda di kartu hasil Verifikasi. Untuk informasi selengkapnya, lihat Hasil verifikasi.

9. Untuk menguji logika verifikasi, ulangi langkah 6-8 di bawah Untuk memverifikasi revisi dokumen, tetapi ubah satu karakter dalam string input Digest. Ini akan menyebabkan permintaan Verifikasi Anda gagal dengan pesan kesalahan yang sesuai.

Jika Anda tidak perlu lagi menggunakanvehicle-registration buku besar, lanjutkan keLangkah 7 (opsional): Bersihkan Sumber Daya.