

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
<a name="getting-started-step-6"></a>

**penting**  
Pemberitahuan akhir dukungan: Pelanggan yang ada akan dapat menggunakan Amazon QLDB hingga akhir dukungan pada 07/31/2025. Untuk detail selengkapnya, lihat [Memigrasi Buku Besar QLDB Amazon ke Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Dengan Amazon QLDB, Anda dapat memverifikasi integritas dokumen secara efisien 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 memperdagangkan 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 kriptografi di QLDB, lihat. [Verifikasi data di Amazon QLDB](verification.md)

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
<a name="getting-started-step-6.digest"></a>

1. [Buka konsol QLDB Amazon di /qldb. https://console.aws.amazon.com](https://console.aws.amazon.com/qldb)

1. Di panel navigasi, pilih **Buku Besar**.

1. Dalam daftar buku besar, pilih`vehicle-registration`.

1. 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](verification.md#verification.structure) 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 intisari.
   + **Tanggal** — Stempel waktu saat Anda meminta intisari.

1. 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](ion.md). 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"
   }
   ```

1. 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
<a name="getting-started-step-6.verify"></a>

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. `blockAddress`Ini adalah struktur Ion yang menentukan lokasi blok tempat revisi dilakukan.

   **Di panel navigasi konsol QLDB, pilih editor PartiQL.**

1. Pilih `vehicle-registration` buku besar.

1. 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'
   ```

1. 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.

1. Sekarang setelah Anda memilih revisi dokumen, Anda dapat memulai proses memverifikasinya.

   Di panel navigasi, pilih **Verifikasi**.

1. Pada formulir **Verifikasi dokumen**, di **bawah Tentukan dokumen yang ingin Anda verifikasi**, masukkan parameter input berikut:
   + **Buku Besar** — Pilih`vehicle-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.

1. 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.

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

   Konsol mengotomatiskan dua langkah untuk Anda:

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

   1. 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](verification.results.md).

1. 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 ke[Langkah 7 (opsional): Bersihkan sumber daya](getting-started-step-7.md).