Izin level project berbasis agen

Transfer berbasis agen memerlukan izin IAM level project untuk dua entitas yang berbeda: agen layanan dan akun agen transfer.

Konfigurasikan izin di halaman ini hanya jika transfer Anda melibatkan sistem file, HDFS, atau penyimpanan yang kompatibel dengan S3. Jika transfer Anda tanpa agen, jangan konfigurasi peran di halaman ini; lanjutkan langsung ke Mengonfigurasi akses ke sumber dan tujuan Anda.

Transfer berbasis agen menggunakan identitas berikut:

  • Agen layanan: Akun layanan yang dikelola Google yang digunakan oleh Storage Transfer Service untuk mengoordinasikan tugas dengan agen transfer.
  • Akun agen transfer: Akun pengguna Google Cloud atau akun layanan terkelola pengguna yang digunakan untuk mengautentikasi dan menjalankan agen transfer di mesin atau instance klien Anda.

Untuk mengetahui informasi umum tentang cara memberikan peran IAM, lihat Memberikan, mengubah, dan mencabut akses ke resource.

Izin agen layanan

Storage Transfer Service menggunakan agen layanan untuk mengoordinasikan transfer berbasis agen.

Untuk mengizinkan Storage Transfer Service mengoordinasikan pekerjaan antara Google Cloud dan agen transfer Anda, berikan peran berikut kepada agen layanan di project yang menjalankan Storage Transfer Service:

  • Storage Transfer Service Agent (roles/storagetransfer.serviceAgent)

Mendapatkan alamat email agen layanan

Pemberian peran kepada agen layanan memerlukan ID alamat email agen layanan. Agen layanan dibuat secara otomatis saat Anda pertama kali membuat tugas transfer, menjalankan perintah penyiapan gcloud transfer, membuka halaman Storage Transfer di konsol Google Cloud , atau memanggil googleServiceAccounts.get.

Untuk mendapatkan alamat email agen layanan:

  1. Buka halaman referensi googleServiceAccounts.get. Panel interaktif akan terbuka, berjudul Try this method.
  2. Di bagian Request parameters, masukkan project ID Anda.
  3. Klik Jalankan.

Salin nilai accountEmail. Alamat email menggunakan format berikut: project-PROJECT_NUMBER@storage-transfer-service.iam.gserviceaccount.com.

Memberikan peran agen layanan

Untuk memberikan peran Storage Transfer Service Agent:

Konsol Google Cloud

  1. Di konsol Google Cloud , buka halaman IAM untuk project yang menjalankan Storage Transfer Service.

    Buka IAM

  2. Klik Grant access.

  3. Di kolom New principals, masukkan alamat email agen layanan Anda.

  4. Di menu drop-down Select a role, telusuri dan pilih Storage Transfer Service Agent (roles/storagetransfer.serviceAgent).

  5. Klik Simpan.

gcloud

Jalankan gcloud projects add-iam-policy-binding:

gcloud projects add-iam-policy-binding PROJECT_ID \
--member="serviceAccount:SERVICE_AGENT_EMAIL" \
--role="roles/storagetransfer.serviceAgent"

Ganti kode berikut:

Izin akun agen transfer

Agen transfer berjalan di mesin klien Anda menggunakan kredensial akun pengguna atau akun layanan yang dikelola pengguna:

  • Akun pengguna menggunakan kredensial pengguna yang diautentikasi.
  • Akun layanan yang dikelola pengguna menggunakan kunci akun layanan atau penggabungan identitas. Untuk membuat akun layanan, lihat Membuat dan mengelola akun layanan.

Untuk mengizinkan agen transfer terhubung ke Storage Transfer Service, menerima tugas, dan mencatat status, tetapkan peran berikut pada project Google Cloud yang menghosting kumpulan agen Anda:

  • Storage Transfer Agent (roles/storagetransfer.transferAgent)

Untuk memberikan peran ini:

Konsol Google Cloud

  1. Di konsol Google Cloud , buka halaman IAM.

    Buka IAM

  2. Pastikan Anda telah memilih project yang berisi kumpulan agen Anda.

  3. Klik Grant access.

  4. Di kolom New principals, masukkan alamat email akun pengguna atau akun layanan terkelola pengguna Anda.

  5. Di menu drop-down Select a role, telusuri dan pilih Storage Transfer Agent (roles/storagetransfer.transferAgent).

  6. Klik Simpan.

gcloud

Jalankan gcloud projects add-iam-policy-binding:

gcloud projects add-iam-policy-binding AGENT_POOL_PROJECT_ID \
--member="serviceAccount_OR_user:TRANSFER_AGENT_ACCOUNT" \
--role="roles/storagetransfer.transferAgent"

Ganti kode berikut:

  • AGENT_POOL_PROJECT_ID: Project yang berisi kumpulan agen Anda.
  • serviceAccount_OR_user: Tentukan serviceAccount jika akun agen transfer Anda adalah akun layanan, atau user jika agen Anda diinstal dengan akun pengguna.
  • TRANSFER_AGENT_ACCOUNT: Alamat email akun yang menjalankan agen transfer.

Langkah berikutnya

Setelah mengonfigurasi izin project, lanjutkan dengan langkah-langkah penyiapan berikut secara berurutan:

  1. Buat kumpulan agen.
  2. Instal agen transfer di pool Anda.
  3. Konfigurasikan izin akses untuk sistem penyimpanan Anda:
  4. Tinjau Referensi peran dan izin yang lengkap.