Langkah 6: Verifikasi dokumen dalam buku besar - Database Buku Besar Amazon Quantum (AmazonQLDB)
Untuk meminta intisariUntuk memverifikasi revisi dokumen

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Langkah 6: Verifikasi dokumen dalam buku besar

penting

Pemberitahuan akhir dukungan: Pelanggan yang ada akan dapat menggunakan Amazon QLDB hingga akhir dukungan pada 07/31/2025. Untuk detail selengkapnya, lihat Memigrasi QLDB Buku Besar Amazon ke Amazon Aurora Postgre. SQL

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

Untuk mempelajari lebih lanjut tentang cara kerja verifikasi dan hashing kriptografiQLDB, lihat. Verifikasi data di Amazon QLDB

Pada langkah ini, Anda memverifikasi revisi dokumen di vehicle-registration buku besar. Pertama, Anda meminta intisari, 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 QLDB konsol Amazon di https://console.aws.amazon.com/qldb.

  2. Di panel navigasi, pilih Buku Besar.

  3. Dalam daftar buku besar, pilihvehicle-registration.

  4. Pilih Dapatkan intisari. Kotak dialog Get digest menampilkan detail intisari berikut:

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

    • Alamat tip intisari — Lokasi blok terbaru dalam jurnal yang dicakup oleh intisari yang Anda minta. Sebuah 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 intisari.

    • Tanggal — Stempel waktu saat Anda meminta intisari.

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

    Langkah ini menyimpan file plaintext dengan konten dalam format Amazon Ion. File ini memiliki ekstensi nama file .ion.txt dan berisi semua informasi intisari 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 memverifikasi revisi dokumen terhadap intisari tersebut.

catatan

Dalam kasus penggunaan produksi untuk verifikasi, Anda menggunakan intisari 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 untuk id dan blockAddress revisi dokumen yang ingin Anda verifikasi. Bidang ini disertakan dalam metadata dokumen, yang dapat Anda kueri dalam tampilan komit.

    Dokumen id ini adalah string ID unik yang ditetapkan sistem. blockAddressIni adalah struktur Ion yang menentukan lokasi blok tempat revisi dilakukan.

    Di panel navigasi QLDB konsol, pilih editor PartiQL.

  2. Pilih vehicle-registration buku besar.

  3. Di jendela editor kueri, masukkan pernyataan berikut, lalu pilih Jalankan.

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

  4. Salin dan simpan id dan blockAddress nilai yang dikembalikan kueri Anda. Pastikan untuk menghilangkan tanda kutip ganda untuk id bidang tersebut. Di Amazon Ion, tipe data string dibatasi dengan tanda kutip ganda.

  5. Sekarang setelah Anda memilih revisi dokumen, 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 input berikut:

    • Buku Besar — Pilihvehicle-registration.

    • Alamat blok — 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 Pilih intisari. Jika file tersebut valid, ini secara otomatis mengisi semua bidang intisari di konsol Anda. Atau, Anda dapat menyalin dan menempelkan nilai berikut secara manual langsung dari file intisari Anda:

    • Digest — digest Nilai dari file digest Anda.

    • Alamat tip intisari — digestTipAddress Nilai dari file intisari Anda.

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

    Konsol mengotomatiskan dua langkah untuk Anda:

    1. Minta bukti dari dokumen QLDB yang Anda tentukan.

    2. Gunakan bukti yang dikembalikan oleh QLDB untuk memanggil sisi klienAPI, 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 menggunakan vehicle-registration buku besar, lanjutkan keLangkah 7 (opsional): Bersihkan sumber daya.