Mendelegasikan izin agen layanan ke akun layanan yang dikelola pengguna

Mendelegasikan izin agen layanan ke akun layanan yang dikelola pengguna adalah konfigurasi opsional untuk organisasi yang memerlukan kontrol akses bucket per pengguna.

Untuk transfer tanpa agen, Storage Transfer Service secara default menggunakan agen layanan untuk mentransfer data Anda antara sumber dan tujuan. Anda memberikan izin kepada agen layanan untuk mengakses bucket Cloud Storage Anda.

Karena agen layanan Storage Transfer Service yang sama digunakan oleh semua transfer dalam sebuah project, agen layanan tersebut harus memiliki izin pada semua bucket yang terlibat dalam setiap transfer dalam project tersebut.

Sebagai alternatif opsional, Anda dapat menetapkan izin bucket ke beberapa akun layanan yang dikelola pengguna. Akun layanan yang dikelola pengguna ini diberi izin pada bucket sumber dan tujuan tertentu, serta dibatasi untuk akun pengguna tertentu (akun yang membuat atau memicu tugas transfer).

Contoh skenario

Skenario berikut menunjukkan berbagai opsi izin menggunakan agen layanan dan akun layanan yang dikelola pengguna.

Luaskan setiap bagian untuk melihat detailnya.

Skenario 1: Hanya agen layanan

Dalam skenario ini, semua izin diberikan kepada agen layanan.

  • Agen layanan diberi izin tulis pada bucket A, B, C, dan D.

Setiap pengguna dengan izin yang benar untuk membuat tugas transfer dapat mentransfer ke atau dari bucket A, B, C, dan D.

Hal ini berfungsi dengan baik jika pengguna Storage Transfer Service adalah pengguna tepercaya untuk data di semua bucket, dan dapat mengonfigurasi tugas transfer dengan benar untuk menghindari pemindahan data ke dalam atau ke luar bucket yang salah.

Skenario 2: Hanya agen layanan yang dikelola pengguna

Dalam skenario ini, semua izin diberikan ke akun layanan yang dikelola pengguna.

  • Akun layanan yang dikelola pengguna #1 diberi izin pada bucket A dan B.
  • Akun layanan terkelola pengguna #2 diberi izin pada bucket C dan D.

Selain itu:

  • Pengguna Alfa diberi akses ke akun layanan #1.
  • Pengguna Bravo diberi akses ke akun layanan #2.
  • Pengguna Charlie diberi akses ke akun layanan #1 dan #2.

Dalam kasus ini:

  • Alpha hanya dapat mentransfer antara bucket A dan B.
  • Bravo hanya dapat mentransfer antara bucket C dan D.
  • Charlie hanya dapat mentransfer antara bucket A dan B, serta antara C dan D.
  • Charlie tidak dapat mentransfer antara A dan C, A dan D, B dan C, atau B dan D.

Skenario 3: Izin campuran

Dalam skenario ini, project Anda berisi campuran izin agen layanan dan izin akun layanan yang dikelola pengguna.

  • Agen layanan diberi izin tulis pada bucket A dan B.
  • Akun layanan yang dikelola pengguna #1 diberi izin hanya baca pada bucket C dan izin tulis pada bucket D.
  • Pengguna Alfa diberi akses ke akun layanan yang dikelola pengguna #1.

Dalam kasus ini:

  • Setiap pengguna dengan izin yang benar untuk membuat tugas transfer dapat mentransfer ke atau dari bucket A dan B. Mereka tidak dapat mentransfer ke atau keluar dari bucket C atau D.
  • Pengguna Alfa dapat mentransfer ke atau dari bucket A dan B.
  • Alfa dapat mentransfer keluar dari bucket C ke bucket D.
  • Alfa tidak dapat mentransfer keluar dari bucket C ke bucket A atau B.

Ringkasan implementasi

Implementasinya adalah sebagai berikut:

  • Anda membuat akun layanan yang dikelola pengguna, atau menggunakan akun yang sudah ada.
  • Anda memberikan izin:
    • Agar pengguna dapat mengakses akun layanan yang dikelola pengguna.
    • Agar agen layanan dapat membuat token akses dari akun layanan yang dikelola pengguna.
    • Untuk akun layanan yang dikelola pengguna agar dapat mengakses bucket Anda.
  • Pengguna membuat tugas transfer yang menentukan akun layanan yang dikelola pengguna.
  • Storage Transfer Service memeriksa apakah pengguna memiliki izin yang benar di akun layanan. Jika izin yang benar belum diberikan, pembuatan tugas transfer akan gagal.
  • Agen layanan membuat token OAuth atas nama akun layanan yang dikelola pengguna. Token OAuth memungkinkan Storage Transfer Service mengakses bucket yang terlibat dalam transfer.
  • Tugas transfer akan dijalankan.
  • Token OAuth hanya berlaku dalam waktu singkat dan akan habis masa berlakunya. Jika tugas transfer sedang berlangsung saat masa berlaku token berakhir, Storage Transfer Service akan membuat token baru dan melanjutkan transfer.

Menyiapkan delegasi izin

Ikuti petunjuk untuk mendelegasikan akses agen layanan ke akun layanan yang dikelola pengguna.

Persyaratan

  • Untuk membuat atau mengelola tugas transfer, akun pengguna Anda memerlukan izin project Storage Transfer Service. Lihat Izin pengguna yang diperlukan.
  • Untuk membuat akun layanan terkelola pengguna baru, Anda memerlukan peran Create Service Accounts (roles/iam.serviceAccountCreator) pada project.
  • Untuk memberikan akses bagi pengguna dan agen layanan ke akun layanan yang dikelola pengguna, Anda memerlukan peran Admin Akun Layanan (roles/iam.serviceAccountAdmin) di akun layanan yang dikelola pengguna, atau di project.

Membuat atau mengidentifikasi akun layanan yang dikelola pengguna

Anda dapat membuat akun layanan baru yang dikelola pengguna, atau menggunakan akun layanan yang sudah ada.

  • Untuk membuat akun layanan yang dikelola pengguna, ikuti petunjuk di Membuat akun layanan.

  • Untuk menggunakan akun layanan yang dikelola pengguna yang sudah ada, Anda memerlukan alamat emailnya, yang menggunakan format berikut:

    SERVICE_ACCOUNT_NAME@PROJECT_ID.

  • Jika Anda memerlukan ID unik akun layanan (uniqueId), jalankan gcloud iam service-accounts describe SERVICE_ACCOUNT_EMAIL --format="value(uniqueId)" atau lihat kolom ID Unik di halaman Akun Layanan di konsolGoogle Cloud .

Jika akun layanan berada dalam project yang berbeda dengan tugas transfer, lihat Mengaktifkan akun layanan untuk dilampirkan di seluruh project.

Memberikan akses kepada pengguna

Berikan akses akun pengguna ke akun layanan baru yang dikelola pengguna, dan tetapkan peran Service Account User (roles/iam.serviceAccountUser). Akun pengguna adalah akun yang digunakan untuk membuat atau memperbarui tugas transfer.

Konsol Google Cloud

  1. Di console Google Cloud , buka halaman Akun Layanan.

    Buka Akun Layanan

  2. Pilih project.

  3. Klik alamat email akun layanan yang dikelola pengguna.

  4. Pilih tab Principals with access.

  5. Klik Grant access.

  6. Masukkan alamat email pengguna. Misalnya, user1@example.com.

  7. Dari menu drop-down Role, pilih Service Account User.

  8. Klik Simpan. akun utama diberi peran pada akun layanan.

gcloud

Untuk memberikan peran kepada akun utama, jalankan perintah add-iam-policy-binding:

gcloud iam service-accounts add-iam-policy-binding USER_MANAGED_SERVICE_ACCOUNT_EMAIL \
  --member=PRINCIPAL --role=roles/iam.serviceAccountUser

Ganti variabel berikut:

  • USER_MANAGED_SERVICE_ACCOUNT_EMAIL: Alamat email akun layanan yang dikelola pengguna dalam bentuk SA_NAME@PROJECT_ID..
  • PRINCIPAL: Alamat email pengguna yang menjalankan tugas transfer, dalam format user:name@example.com.

Memberikan akses ke agen layanan

Agar agen layanan dapat membuat token akses dari akun layanan yang dikelola pengguna, beri agen layanan akses ke akun layanan yang dikelola pengguna, dan tetapkan peran Service Account Token Creator (roles/iam.serviceAccountTokenCreator).

Anda memerlukan alamat email agen layanan untuk memberikan akses. Untuk menemukan email agen layanan:

  1. Buka halaman referensi googleServiceAccounts.get.

    Panel interaktif akan terbuka, berjudul Try this method.

  2. Di panel, di bagian Request parameters, masukkan project ID Anda. Project yang Anda tentukan di sini harus merupakan project yang Anda gunakan untuk mengelola Storage Transfer Service.

  3. Klik Jalankan.

    Email agen layanan Anda ditampilkan sebagai nilai accountEmail. Formatnya adalah project-PROJECT_NUMBER@storage-transfer-service..

Kemudian, untuk memberikan akses agen layanan ke akun layanan yang dikelola pengguna:

Konsol Google Cloud

  1. Di console Google Cloud , buka halaman Akun Layanan.

    Buka Akun Layanan

  2. Pilih project.

  3. Klik alamat email akun layanan yang dikelola pengguna.

  4. Pilih tab Principals with access.

  5. Klik Grant access.

  6. Masukkan alamat email agen layanan.

  7. Dari menu drop-down Role, pilih Service Account Token Creator.

  8. Klik Simpan. akun utama diberi peran pada akun layanan.

gcloud

Untuk memberikan peran kepada akun utama, jalankan perintah add-iam-policy-binding:

gcloud iam service-accounts add-iam-policy-binding USER_MANAGED_SERVICE_ACCOUNT_EMAIL \
  --member=serviceAccount:SERVICE_AGENT_EMAIL --role=roles/iam.serviceAccountTokenCreator

Ganti variabel berikut:

  • USER_MANAGED_SERVICE_ACCOUNT_EMAIL: Alamat email akun layanan yang dikelola pengguna dalam bentuk SA_NAME@PROJECT_ID..
  • SERVICE_AGENT_EMAIL: Alamat email agen layanan.

Memberikan izin bucket ke akun layanan yang dikelola pengguna

Berikan izin yang tercantum dalam Mengonfigurasi akses ke sumber: Cloud Storage dan Mengonfigurasi akses ke sink: Cloud Storage ke akun layanan yang dikelola pengguna, bukan ke agen layanan.

Membuat tugas transfer menggunakan akun layanan yang dikelola pengguna

Setelah memberikan izin yang benar, Anda dapat menentukan akun layanan yang dikelola pengguna saat membuat tugas transfer baru.

Konsol Google Cloud

Ikuti petunjuk untuk membuat transfer. Sebelum menyelesaikan tugas transfer:

  1. Di halaman Choose settings, temukan bagian Service account type.
  2. Pilih User-managed service account.
  3. Masukkan email akun layanan yang dikelola pengguna, menggunakan format SERVICE_ACCOUNT_NAME@PROJECT_ID..
  4. Klik Create untuk membuat tugas transfer.

REST API

Tentukan akun layanan yang dikelola pengguna sebagai nilai kolom serviceAccount dalam permintaan transferJobs.create.

Email akun layanan (SERVICE_ACCOUNT_NAME@PROJECT_ID.) atau ID unik (123456789012345678901) dapat diterima.

Contoh:

POST https://storagetransfer.googleapis.com/v1/transferJobs
{
"description": "A transfer using a user-managed service account for bucket permissions",
"status": "ENABLED",
"projectId": "PROJECT_ID",
"serviceAccount": "SERVICE_ACCOUNT_NAME@PROJECT_ID.",
"transferSpec": {
    ...
  }
}

Mengambil ID unik akun layanan

Saat mengonfigurasi akses gabungan ke penyimpanan AWS S3 atau Microsoft Azure, atau menentukan akun layanan dalam permintaan REST API, Anda mungkin memerlukan ID unik akun layanan yang dikelola pengguna.

Untuk mengambil uniqueId:

Konsol Google Cloud

  1. Buka halaman Service accounts di konsol Google Cloud .

    Buka Akun Layanan

  2. Klik alamat email akun layanan.

  3. Di tab Detail, temukan ID Unik.

gcloud CLI

Gunakan perintah Google Cloud CLI berikut:

gcloud iam service-accounts describe USER_MANAGED_SERVICE_ACCOUNT_EMAIL \
  --format='value(uniqueId)'