Langkah 2: Memverifikasi data Anda di QLDB - Amazon Quantum Ledger Database (Amazon QLDB)

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

Langkah 2: Memverifikasi data Anda di QLDB

Amazon QLDB menyediakan API untuk meminta bukti ID dokumen tertentu dan blok terkaitnya. Anda juga harus memberikan alamat tip dari intisari yang sebelumnya Anda simpan, seperti yang dijelaskan dalamLangkah 1: Meminta intisari di QLDB. Anda dapat menggunakan AWS Management Console, AWS SDK, atau AWS CLI untuk mendapatkan bukti.

Kemudian, Anda dapat menggunakan bukti yang dikembalikan oleh QLDB untuk memverifikasi revisi dokumen terhadap intisari yang disimpan, menggunakan API sisi klien. Ini memberi Anda kontrol atas algoritme yang Anda gunakan untuk memverifikasi data Anda.

AWS Management Console

Bagian ini menjelaskan langkah-langkah untuk memverifikasi revisi dokumen terhadap intisari yang disimpan sebelumnya menggunakan konsol QLDB Amazon.

Sebelum Anda mulai, pastikan Anda mengikuti langkah-langkahnyaLangkah 1: Meminta intisari di QLDB. Verifikasi memerlukan intisari yang disimpan sebelumnya yang mencakup revisi yang ingin Anda verifikasi.

Untuk memverifikasi revisi dokumen (konsol)
  1. Buka konsol QLDB Amazon di https://console.aws.amazon.com/qldb.

  2. Pertama, kueri buku besar Anda untuk id dan blockAddress revisi 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, pilih editor PartiQL.

  3. Pilih nama buku besar di mana Anda ingin memverifikasi revisi.

  4. Di jendela editor kueri, masukkan SELECT pernyataan dalam sintaks berikut, lalu pilih Jalankan.

    SELECT metadata.id, blockAddress FROM _ql_committed_table_name WHERE criteria

    Misalnya, query berikut mengembalikan dokumen dari VehicleRegistration tabel dalam contoh buku besar yang dibuat diMemulai dengan konsol Amazon QLDB.

    SELECT r.metadata.id, r.blockAddress FROM _ql_committed_VehicleRegistration AS r WHERE r.data.VIN = 'KM8SRDHF6EU074761'
  5. 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. Misalnya, Anda harus menyalin hanya teks alfanumerik dalam cuplikan berikut.

    "LtMNJYNjSwzBLgf7sLifrG"

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

    Di panel navigasi, pilih Verifikasi.

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

    • Buku besar — Buku besar di mana Anda ingin memverifikasi revisi.

    • Alamat blokblockAddress Nilai yang dikembalikan oleh kueri Anda di langkah 4.

    • ID Dokumen - id Nilai yang dikembalikan oleh kueri Anda di langkah 4.

  8. 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:

    • Digestdigest Nilai dari file digest Anda.

    • Alamat tip intisaridigestTipAddress Nilai dari file intisari Anda.

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

    2. Gunakan bukti yang dikembalikan oleh QLDB untuk memanggil API sisi klien, yang memverifikasi revisi dokumen Anda terhadap intisari yang disediakan. Untuk memeriksa algoritma verifikasi ini, lihat bagian berikut QLDB API untuk mengunduh contoh kode.

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

QLDB API

Anda juga dapat memverifikasi revisi dokumen dengan menggunakan Amazon QLDB API dengan AWS SDK atau file. AWS CLI QLDB API menyediakan operasi berikut untuk digunakan oleh program aplikasi:

  • GetDigest— Mengembalikan intisari buku besar di blok komitmen terbaru dalam jurnal. Responsnya mencakup nilai hash 256-bit dan alamat blok.

  • GetBlock— Mengembalikan objek blok pada alamat tertentu dalam jurnal. Juga mengembalikan bukti blok yang ditentukan untuk verifikasi jika DigestTipAddress disediakan.

  • GetRevision— Mengembalikan objek data revisi untuk ID dokumen tertentu dan alamat blok. Juga mengembalikan bukti revisi yang ditentukan untuk verifikasi jika DigestTipAddress disediakan.

Untuk deskripsi lengkap tentang operasi API ini, lihat. Referensi API Amazon QLDB

Untuk informasi tentang memverifikasi data menggunakan AWS CLI, lihat Referensi AWS CLI Perintah.

Aplikasi sampel

Untuk contoh kode Java, lihat GitHub repositori amazon-qldb-dmv-sampleaws-samples/ -java. Untuk petunjuk tentang cara mengunduh dan menginstal aplikasi sampel ini, lihatMenginstal aplikasi sampel Amazon QLDB Java. Sebelum melakukan verifikasi, pastikan Anda mengikuti Langkah 1-3 tutorial java untuk membuat buku besar sampel dan memuatnya dengan data sampel.

Kode tutorial di kelas GetRevisionmemberikan contoh meminta bukti untuk revisi dokumen dan kemudian memverifikasi revisi itu. Kelas ini menjalankan langkah-langkah berikut:

  1. Meminta intisari baru dari buku besar vehicle-registration sampel.

  2. Meminta bukti untuk revisi dokumen sampel dari VehicleRegistration tabel di vehicle-registration buku besar.

  3. Memverifikasi revisi sampel menggunakan intisari dan bukti yang dikembalikan.