Membuat tanda tangan

Halaman ini menunjukkan cara menggunakan metode signBlob Google Cloud untuk membuat tanda tangan dari dokumen kebijakan atau string-to-sign. Tanda tangan digunakan sebagai kredensial dalam permintaan tertentu, seperti URL yang ditandatangani. Panduan ini menggunakan kunci RSA untuk membuat tanda tangan.

Penting: Kunci akun layanan yang dikelola Google yang digunakan oleh metode signBlob dirotasi secara rutin. Jika Anda menetapkan waktu kedaluwarsa untuk tanda tangan yang lebih dari 12 jam dan membuat tanda tangan menggunakan metode signBlob, tanda tangan dapat digunakan setidaknya selama 12 jam, tetapi mungkin akan berhenti berfungsi sebelum waktu kedaluwarsa karena rotasi kunci. Tanda tangan yang dibuat menggunakan metode signBlob paling cocok digunakan untuk akses jangka pendek ke resource.

Sebelum memulai

1. Aktifkan Service Account Credentials API.

   Mengaktifkan API

2. Anda harus memiliki izin iam.serviceAccounts.signBlob untuk akun layanan yang Anda gunakan dalam panduan ini. Izin iam.serviceAccounts.signBlob disertakan dalam peran roles/iam.serviceAccountTokenCreator.

3. Akun layanan yang Anda gunakan dalam panduan ini harus memiliki izin untuk melakukan permintaan yang dienkode dalam tanda tangan. Misalnya, jika tanda tangan akan digunakan untuk membaca data objek dari bucket, akun layanan harus memiliki izin untuk membaca data objek.

Membuat tanda tangan

1. Menginstal dan melakukan inisialisasi gcloud CLI , yang memungkinkan Anda membuat token akses untuk header Authorization.

2. Buat file JSON yang berisi informasi berikut:

   {
     "payload": "REQUEST_INFORMATION"
   }

   Dengan keterangan:

   • REQUEST_INFORMATION adalah string-to-sign atau dokumen kebijakan. Untuk keduanya, konten harus berenkode base64.

3. Gunakan cURL untuk memanggil IAM API dengan permintaan signBlob:

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT_EMAIL:signBlob"

   Dengan keterangan:

   • JSON_FILE_NAME adalah nama file yang Anda buat di Langkah 2.

   • SERVICE_ACCOUNT_EMAIL adalah alamat email akun layanan yang ingin Anda gunakan untuk membuat tanda tangan. Contoh, [e-mail].

Jika berhasil, tanda tangan akan ditampilkan di kolom signedBlob dalam respons.

Langkah berikutnya

• Lihat halaman referensi untuk menandatangani blob dengan Google Cloud CLI.
• Membuat URL yang ditandatangani secara manual menggunakan tanda tangan yang Anda buat.
• Membuat URL yang ditandatangani dengan alat Google Cloud.
• Pelajari tanda tangan lebih lanjut.