Mulai menggunakan Universal Ledger

Pelajari cara melakukan aktivasi ke jaringan Universal Ledger dan mengaktifkan Universal Ledger API di project Google Cloud Anda.

Permintaan aktivasi

Sebelum mengirimkan transaksi ke jaringan, Anda harus membuat akun Universal Ledger terlebih dahulu. Tinjau halaman Ringkasan produk untuk memahami berbagai jenis akun pengelola dan operator.

Akun ledger harus dibuat oleh akun administrator dengan hak istimewa di ledger. Lihat panduan untuk Mengidentifikasi siapa yang dapat membuat akun Anda agar Anda dapat mengirimkan detail orientasi yang diperlukan kepada mereka.

Untuk menyiapkan akun Operator Mata Uang, atau untuk membahas kasus penggunaan Anda, hubungi kami di [e-mail].

Mengaktifkan API

Anda dapat mengaktifkan Universal Ledger API menggunakan gcloud, dan menetapkan akses terperinci kepada anggota tim menggunakan peran IAM tertentu.

1. Mengaktifkan API menggunakan gcloud

   Untuk mengaktifkan API, gunakan perintah gcloud services enable:

   gcloud services enable universalledger.googleapis.com \
       --project=PROJECT_ID
   

   Ganti PROJECT_ID dengan ID project tempat Anda ingin mengaktifkan API.

   Jika Anda adalah Project Owner, Anda sekarang dapat mengirim permintaan ke API.

2. Menyiapkan akses terperinci menggunakan peran IAM

   Untuk mengelola akses terperinci ke Universal Ledger API bagi anggota lain di organisasi Anda, Anda dapat menetapkan peran IAM kepada mereka. API ini memiliki tiga peran IAM yang dikonfigurasi, yang masing-masing menyediakan lapisan akses yang berbeda:

   • roles/universalledger.viewer: Akses hanya baca ke endpoint dan jaringan yang tersedia. Memberikan kemampuan untuk melihat endpoint, dan membuat kueri jaringan menggunakan endpoint.
   • roles/universalledger.editor: Akses penuh ke endpoint dan jaringan yang tersedia. Memberikan akses untuk mengkueri jaringan dan mengirimkan transaksi.
   • roles/universalledger.admin: Akses penuh ke endpoint dan jaringan yang tersedia. Memberikan akses untuk mengkueri jaringan dan mengirimkan transaksi. Peran ini memiliki izin yang sama dengan peran Universal Ledger Editor, yang dapat berubah di masa mendatang.

   Untuk menambahkan peran IAM baru ke pengguna, gunakan perintah gcloud projects add-iam-policy-binding:

   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member="PRINCIPAL" \
       --role="ROLE"
   

   Ganti kode berikut:

   • PROJECT_ID: project tempat menambahkan binding kebijakan IAM
   • PRINCIPAL: akun utama yang ditambahi peran, misalnya: user:[e-mail] atau serviceAccount:[e-mail].
   • ROLE: salah satu peran yang dijelaskan sebelumnya untuk ditetapkan ke akun utama

Mengirim permintaan pertama Anda

Sekarang Anda dapat mulai menggunakan API.

Untuk memvalidasi bahwa konfigurasi sebelumnya berfungsi dengan benar, lakukan autentikasi terlebih dahulu menggunakan perintah gcloud auth application-default login:

gcloud auth application-default login

Kemudian, coba kirim permintaan endpoints.list:

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -X GET "https://universalledger.us-central1.rep.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints"

Permintaan ke jaringan Universal Ledger tertentu dikirim menggunakan endpoint API, yang akan memiliki bentuk

https://universalledger.REGION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/endpoints/NETWORK_NAME

Menyelesaikan langkah-langkah ini akan memvalidasi akses Anda ke Universal Ledger API.

Langkah berikutnya

• Tinjau daftar jaringan dan region Universal Ledger yang tersedia.
• Minta pembuatan akun di ledger.
• Pelajari cara mengirim permintaan RPC dengan Python.