Kontrol akses dengan IAM

Anda (yaitu, pengguna atau akun layanan yang men-deploy fungsi) dapat menetapkan kontrol akses menggunakan peran di level project. Berikan peran kepada anggota project atau akun layanan untuk menentukan tingkat akses ke project Google Cloud Anda beserta resource-nya. Secara default, semua project Google Cloud memiliki satu pengguna: project creator asli. Tidak ada pengguna lain yang memiliki akses ke project, dan juga akses ke fungsi, sampai pengguna ditambahkan sebagai anggota tim project.

Kontrol akses untuk pengguna

Anda dapat menambahkan pengguna sebagai anggota tim ke project dan memberi mereka peran menggunakan Identity and Access Management (IAM).

Cloud Functions mendukung peran dasar Editor, Pemilik, dan Viewer, yang memberikan izin berikut:

  • Editor dan Pemilik: Akses baca dan tulis ke semua resource terkait fungsi. Memungkinkan pengguna men-deploy, mengupdate, dan menghapus fungsi. Akses tambahan ke resource lain dalam project.
  • Viewer: Akses hanya baca ke fungsi dan lokasi. Memungkinkan pengguna mencantumkan fungsi dan melihat detailnya, tetapi tidak mengizinkan pengguna melihat kode sumber. Akses tambahan ke resource lain dalam project.

Cloud Functions juga mendukung peran Developer dan Viewer Cloud Functions yang telah ditetapkan, yang memberikan izin berikut:

  • Developer: Akses baca dan tulis ke semua resource terkait fungsi. Memungkinkan pengguna men-deploy, mengupdate, dan menghapus fungsi. Tidak ada akses ke resource lain dalam project.
  • Viewer: Akses hanya baca ke fungsi dan lokasi. Memungkinkan pengguna mencantumkan fungsi dan melihat detailnya, tetapi tidak mengizinkan pengguna melihat kode sumber. Tidak ada akses ke resource lain dalam project.

Kontrol akses untuk akun layanan

Akun layanan adalah jenis akun Google Cloud khusus yang bertindak sebagai identitas bagi pengguna non-manusia yang perlu melakukan autentikasi dan diotorisasi untuk mengakses data serta melakukan berbagai tindakan. Beberapa akun ini dibuat dan dikelola oleh Google sendiri dan dikenal sebagai agen layanan.

Akun layanan berikut digunakan untuk Cloud Functions:

Nama ID Anggota Peran
Akun layanan default App Engine (khusus generasi ke-1) PROJECT_ID@appspot.gserviceaccount.com Editor
Akun layanan default Compute Engine (khusus generasi ke-2) PROJECT_NUMBER-compute@developer.gserviceaccount.com Editor
Agen Layanan Google Cloud Functions service-PROJECT_NUMBER@gcf-admin-robot.iam.gserviceaccount.com Agen Layanan Cloud Functions
PROJECT_NUMBER@cloudbuild.gserviceaccount.com Akun Layanan Cloud Build
Akun Layanan Cloud Build service-PROJECT_NUMBER@gcp-sa-cloudbuild.iam.gserviceaccount.com Agen Layanan Cloud Build
Agen Layanan Google Container Registry service-PROJECT_NUMBER@containerregistry.iam.gserviceaccount.com Agen Layanan Container Registry
Agen Layanan Artifact Registry service-PROJECT_NUMBER@gcp-sa-artifactregistry.iam.gserviceaccount.com Agen Layanan Artifact Registry

Akun layanan runtime

Saat runtime, Cloud Functions (generasi ke-1) secara default akan menggunakan akun layanan default App Engine (PROJECT_ID@appspot.gserviceaccount.com), yang memiliki peran Editor pada project. Cloud Functions (generasi ke-2) secara default menggunakan akun layanan default Compute Engine (PROJECT_NUMBER-compute@developer.gserviceaccount.com), yang juga memiliki peran Editor pada project. Anda dapat mengubah peran akun layanan ini untuk membatasi atau memperluas izin untuk fungsi yang sedang berjalan. Anda juga dapat mengubah akun layanan yang digunakan dengan menyediakan akun layanan individual non-default.

Untuk mempelajari lebih lanjut akun layanan, baca dokumentasi akun layanan.

Akun layanan administratif

Untuk melakukan tindakan administratif pada project Anda selama pembuatan, update, atau penghapusan fungsi, semua project di Cloud Functions memerlukan akun layanan Agen Layanan Google Cloud Functions (service-PROJECT_NUMBER@gcf-admin-robot.iam.gserviceaccount.com).

Selain itu, semua runtime melakukan pembangunan dan penyimpanan image container dalam project Anda. Untuk mendukung hal ini, Anda juga perlu menyediakan hal berikut:

Akun layanan ini harus memiliki peran yang tercantum dalam tabel sebelumnya.

Akun layanan Agen Layanan Google Cloud Functions

Secara default, akun layanan Agen Layanan Google Cloud Functions (service-PROJECT_NUMBER@gcf-admin-robot.iam.gserviceaccount.com memiliki peran cloudfunctions.serviceAgent di project Anda. Membuat, mengupdate, dan menghapus fungsi mungkin akan gagal jika Anda mengubah izin akun ini.

Berikut adalah beberapa izin penting yang digunakan cloudfunctions.serviceAgent:

Izin Deskripsi
roles/artifactregistry.admin Mengelola repositori dan menyimpan image build di Artifact Registry.
roles/cloudbuild.builds.editor Diperlukan agar dapat menggunakan Cloud Build untuk menjalankan build di project pengguna.
roles/cloudbuild.customworkers.builder Membuat build di worker kustom Cloud Build.
cloudfunctions.functions.invoke Memanggil fungsi HTTP Generasi ke-1 yang dilindungi IAM.
compute.globalOperations.get,
compute.networks.access,
vpcaccess.connectors.{get, use}
Menyediakan fungsi dengan akses ke VPC project konsumen.
roles/eventarc.developer Mengelola pemicu Eventarc untuk fungsi Generasi ke-2.
firebasedatabase.instances.{get, update} Membuat fungsi yang dipicu oleh Firebase Realtime Database.
iam.serviceAccounts.{actAs, getAccessToken, signBlob} Kemampuan untuk mendapatkan kredensial akun layanan runtime.
iam.serviceAccounts.getOpenIdToken Diperlukan agar agen mendapatkan token OpenID pada otoritas yang ditentukan pengguna. Token OpenID digunakan untuk memanggil fungsi yang mendukung IAM.
pubsub.subscriptions Mengelola langganan dalam project pengguna.
pubsub.topics Mengelola topik dalam project pengguna.
roles/run.developer Mengelola Cloud Run Service untuk fungsi Generasi ke-2.
storage.buckets.{get, update} Mengonfigurasi notifikasi pada bucket Cloud Storage yang memicu fungsi Generasi ke-1.
storage.buckets.create,
storage.objects.{delete, get, create, list}
Diperlukan untuk menyimpan kode sumber dalam project pengguna.

Anda dapat melihat seluruh rangkaian izin pada peran IAM yang telah ditetapkan atau dengan menjalankan perintah ini:

gcloud iam roles describe roles/cloudfunctions.serviceAgent

Anda dapat mereset akun layanan ini ke peran default dengan menghapus peran apa pun yang saat ini dimiliki dan menambahkan peran Agen Layanan Cloud Functions:

gcloud projects add-iam-policy-binding PROJECT_ID \
  --member serviceAccount:service-PROJECT_NUMBER@gcf-admin-robot.iam.gserviceaccount.com \
  --role roles/cloudfunctions.serviceAgent

Memecahkan masalah error izin

Jika Anda mendapatkan error izin saat men-deploy, mengupdate, menghapus, atau menjalankan fungsi dalam project, lakukan langkah-langkah berikut:

  1. Pastikan Anda memiliki peran Editor atau Pemilik dalam project Anda, atau menggunakan peran Developer Cloud Functions.

    Jika Anda menggunakan peran Developer Cloud Functions pada level project, pastikan juga bahwa Anda telah memberi pengguna peran Pengguna Akun Layanan IAM.

    Saat ini, hanya izin eksekusi yang diperbolehkan di tingkat per-fungsi.

  2. Pastikan akun layanan Agen Layanan Cloud Functions (service-PROJECT_NUMBER@gcf-admin-robot.iam.gserviceaccount.com) memiliki peran cloudfunctions.serviceAgent untuk project Anda.

    Pastikan kotak Include Google-provided role grants pada tab Permissions di halaman Console IAM dicentang untuk melihat akun ini. Atau, Anda dapat menggunakan gcloud projects add-iam-policy-binding PROJECT_ID.

  3. Pastikan Anda memiliki izin untuk sumber pemicu, seperti Pub/Sub atau Cloud Storage.

Jika Anda mendapatkan error ”insufficient permissions”, atau mengalami masalah autentikasi lain saat menjalankan fungsi, pastikan akun layanan runtime memiliki izin yang benar untuk mengakses resource yang diperlukan fungsi Anda. Kemudian, ulangi langkah 2 dan 3.

Jika Anda mendapatkan error ”service unavailable” selama deployment, pastikan akun layanan runtime PROJECT_ID@appspot.gserviceaccount.com ada dalam project Anda. Untuk membuat ulang akun layanan ini jika sudah dihapus, lihat Membatalkan penghapusan akun layanan.

Lihat juga Memecahkan Masalah Cloud Functions.