Peran dan izin untuk target Cloud Run Functions

Dokumen ini menunjukkan cara memberikan peran dan izin Identity and Access Management (IAM) untuk mendukung perutean peristiwa dari Google Cloud dan sumber lainnya ke Cloud Run Functions menggunakan Eventarc.

  1. Berikan izin di seluruh project dan deployment kepada akun utama yang membuat pemicu dan men-deploy fungsi:

    1. Peran Eventarc Admin memberi Anda kontrol penuh atas semua resource Eventarc, termasuk menentukan akun layanan untuk pemicu saat Anda membuatnya.

    2. Peran Service Account User memungkinkan akun utama meniru identitas dan menggunakan akun layanan, termasuk akun layanan pemicu dan akun layanan runtime atau build fungsi.

    3. Bergantung pada cara Anda men-deploy fungsi, peran Cloud Run Source Developer dan Service Usage Consumer (saat men-deploy dengan gcloud run CLI atau Cloud Run Admin API) atau peran Cloud Functions Developer atau Cloud Functions Admin (saat men-deploy dengan gcloud functions CLI atau Cloud Functions v2 API) memungkinkan Anda membuat dan mengupdate fungsi.

  2. Memberikan izin pemicu Eventarc ke akun layanan pemicu: Peran Eventarc Event Receiver memungkinkan pemicu Eventarc Anda menerima peristiwa dari penyedia peristiwa. Anda tidak perlu memberikan peran tersebut jika merutekan peristiwa langsung dari Cloud Pub/Sub.

  3. Memberikan izin pemanggilan Cloud Run Functions ke akun layanan pemicu: Peran Cloud Run Invoker memungkinkan pemicu Eventarc Anda memanggil fungsi Cloud Run yang diautentikasi.

  4. Memberikan izin ke agen layanan Google:

    1. Peran Eventarc Service Agent memungkinkan agen layanan Eventarc mengelola resource transportasi yang mendasarinya dan memvalidasi sumber peristiwa. Peran ini diberikan secara default saat Anda membuat resource Eventarc untuk pertama kalinya, tetapi Anda harus memulihkannya jika dihapus.

    2. Jika Anda men-deploy fungsi dengan gcloud functions CLI atau Cloud Functions v2 API, peran Agen Layanan Cloud Functions memungkinkan agen layanan Cloud Functions membuat dan mengelola pemicu Eventarc dan layanan Cloud Run yang mendasarinya. Peran ini diberikan secara default saat Anda mengaktifkan Cloud Functions API, tetapi Anda harus memulihkannya jika dihapus.

    3. Jika Anda membuat pemicu untuk peristiwa langsung dari Cloud Storage, berikan peran Pub/Sub Publisher ke agen layanan Cloud Storage.

    4. Jika Anda mengaktifkan agen layanan Cloud Pub/Sub pada atau sebelum 8 April 2021, berikan peran Service Account Token Creator ke agen layanan Pub/Sub.

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran IAM, lihat Mengelola akses. Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Memberikan izin di seluruh project dan deployment

Jika Anda adalah pembuat project, Anda akan diberi peran Owner dasar (roles/owner). Secara default, peran ini mencakup izin yang diperlukan untuk akses penuh ke sebagian besar resourceGoogle Cloud . Jika tidak, peran yang diperlukan harus diberikan oleh administrator pada resource yang sesuai kepada akun utama yang sesuai (juga dikenal sebagai anggota).

Misalnya, akun utama dapat berupa Akun Google (untuk pengguna akhir) atau akun layanan (untuk aplikasi dan workload komputasi). Setiap akun utama memiliki ID-nya sendiri, yang biasanya berupa alamat email.

  1. Peran Eventarc Admin (roles/eventarc.admin) memberi Anda kontrol penuh atas semua resource Eventarc.

    Berikan peran pada project:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=PRINCIPAL \
      --role=roles/eventarc.admin

    Ganti kode berikut:

    • PROJECT_ID: Project ID Google Cloud Anda.

    • PRINCIPAL: ID untuk pembuat pemicu, yang biasanya memiliki bentuk berikut: PRINCIPAL_TYPE:ID. Contohnya, user:my-user@example.com. Untuk daftar lengkap nilai PRINCIPAL_TYPE yang mungkin, lihat Referensi Binding Kebijakan.

  2. Peran Service Account User (roles/iam.serviceAccountUser) memungkinkan akun utama menjalankan operasi sebagai akun layanan.

    Anda memerlukan peran ini agar dapat mengaitkan akun layanan yang dikelola pengguna dengan pemicu Eventarc. Anda juga memerlukannya agar dapat bertindak sebagai akun layanan runtime saat men-deploy fungsi Cloud Run, dan sebagai akun layanan build saat men-deploy dari sumber. Untuk mengetahui informasi selengkapnya, lihat Peran untuk autentikasi akun layanan.

    Anda dapat memberikan peran pada project untuk mengizinkan akun utama meniru identitas beberapa akun layanan atau memberikan peran pada akun layanan untuk mengizinkan akun utama meniru identitas akun layanan tertentu saja.

    Berikan peran pada project:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=PRINCIPAL \
      --role=roles/iam.serviceAccountUser

    Atau, berikan peran di akun layanan:

    gcloud iam service-accounts add-iam-policy-binding \
      projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com \
      --member=PRINCIPAL \
      --role=roles/iam.serviceAccountUser

    Ganti kode berikut:

    • SERVICE_ACCOUNT_PROJECT_ID: project ID Google Cloud yang berisi akun layanan.

    • SERVICE_ACCOUNT_NAME: nama akun layanan.

  3. Berikan peran yang diperlukan untuk men-deploy fungsi Cloud Run berdasarkan cara Anda men-deploy-nya:

Memberikan izin pemicu Eventarc

Setiap pemicu Eventarc dikaitkan dengan akun layanan IAM pada saat pemicu dibuat. Anda dapat menentukan akun layanan yang dikelola pengguna yang digunakan pemicu sebagai identitas default-nya. Jika Anda tidak menentukan akun layanan selama pembuatan pemicu, pemicu akan menggunakan akun layanan default Compute Engine untuk identitasnya.

Sebaiknya Anda membuat akun layanan yang dikelola pengguna sendiri untuk memberi Anda kontrol dan fleksibilitas yang lebih besar saat mengelola pemicu.

  1. Buat akun layanan dan catat namanya:

    gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
      --description="DESCRIPTION" \
      --display-name="DISPLAY_NAME"

    Ganti kode berikut:

    • SERVICE_ACCOUNT_NAME: nama akun layanan. Nama ini muncul di alamat email yang mengidentifikasi akun layanan.

    • DESCRIPTION: deskripsi opsional untuk akun layanan.

    • DISPLAY_NAME: nama akun layanan untuk ditampilkan di konsol Google Cloud .

  2. Berikan peran Eventarc Event Receiver (roles/eventarc.eventReceiver) pada project ke akun layanan yang terkait dengan pemicu Eventarc Anda agar pemicu dapat menerima peristiwa dari penyedia peristiwa.

    Perhatikan bahwa Anda tidak perlu memberikan peran Eventarc Event Receiver jika Anda merutekan peristiwa langsung dari Cloud Pub/Sub.

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \
      --role=roles/eventarc.eventReceiver

    Ganti SERVICE_ACCOUNT_NAME dengan nama akun layanan yang Anda catat di langkah sebelumnya.

Memberikan izin pemanggilan Cloud Run Functions

Secara default, Cloud Run Functions memerlukan autentikasi, yang berarti fungsi tersebut tidak dapat dipanggil tanpa memberikan kredensial autentikasi dalam permintaan. Untuk project dengan kebijakan organisasi berbagi yang dibatasi domain, gunakan fungsi target yang diautentikasi, bukan fungsi yang mengizinkan akses publik (tidak diautentikasi).

  1. Jika Anda merutekan peristiwa ke fungsi Cloud Run yang diautentikasi, berikan peran Cloud Run Invoker (roles/run.invoker) pada layanan Cloud Run yang mendasarinya ke akun layanan yang terkait dengan pemicu Eventarc Anda:

    gcloud run services add-iam-policy-binding FUNCTION_NAME \
      --region=REGION \
      --member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \
      --role=roles/run.invoker

    Ganti kode berikut:

    • FUNCTION_NAME: nama fungsi Cloud Run Anda.

    • REGION: region tempat fungsi Anda di-deploy.

  2. Jika ingin, Anda dapat memberikan peran pada semua layanan, fungsi, dan tugas Cloud Run dalam sebuah project Google Cloud . Untuk mengetahui informasi selengkapnya, lihat Mengontrol akses pada semua layanan dan tugas dalam sebuah project.

Perhatikan bahwa pemicu akan berhasil dibuat dan diaktifkan jika Anda membuat pemicu untuk fungsi Cloud Run yang diautentikasi tanpa memberikan peran Cloud Run Invoker. Namun, pemicu tidak akan berfungsi seperti yang diharapkan dan pesan yang mirip dengan berikut ini akan muncul di log:

The request was not authenticated. Either allow unauthenticated invocations or set the proper Authorization header.

Memberikan izin ke agen layanan Google

Beberapa layanan Google Cloud memiliki agen layanan yang memungkinkan layanan mengakses resource Anda. Jika API memerlukan agen layanan, Google akan membuat agen layanan setelah Anda mengaktifkan dan menggunakan API.

  1. Jika peran Eventarc Service Agent (roles/eventarc.serviceAgent) dihapus dari agen layanan Eventarc, berikan peran tersebut pada project agar Eventarc dapat mengelola resource transport yang mendasarinya dan memvalidasi sumber peristiwa. Jika tidak, peran ini akan diberikan secara default saat Anda membuat resource Eventarc untuk pertama kalinya:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-eventarc.iam.gserviceaccount.com \
      --role=roles/eventarc.serviceAgent

    Ganti PROJECT_NUMBER dengan nomor project Google Cloud Anda. Anda dapat menemukan nomor project di halaman Welcome pada konsol Google Cloud atau dengan menjalankan perintah berikut:

    gcloud projects describe PROJECT_ID --format='value(projectNumber)'
  2. Jika Anda men-deploy fungsi dengan gcloud functions deploy atau Cloud Functions v2 API dan peran Agen Layanan Cloud Functions (roles/cloudfunctions.serviceAgent) dihapus dari agen layanan Cloud Functions, berikan peran pada project agar agen layanan dapat membuat dan mengelola pemicu Eventarc dan layanan Cloud Run yang mendasarinya. Jika tidak, peran ini akan diberikan secara default saat Anda mengaktifkan Cloud Functions API:

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

    Perhatikan bahwa peran ini tidak digunakan lagi dan hanya berlaku untuk fungsi yang dibuat menggunakan Cloud Functions API. Untuk fungsi yang dibuat menggunakan Cloud Run, lihat halaman peran dan izin Cloud Run.

  3. Jika Anda membuat pemicu untuk peristiwa langsung dari Cloud Storage, untuk mendukung publikasi pesan ke topik, berikan peran Pub/Sub Publisher (roles/pubsub.publisher) di project kepada agen layanan Cloud Storage:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:service-PROJECT_NUMBER@gs-project-accounts.iam.gserviceaccount.com \
      --role=roles/pubsub.publisher
  4. Jika Anda mengaktifkan agen layanan Cloud Pub/Sub pada atau sebelum 8 April 2021, untuk mendukung permintaan push Pub/Sub yang diautentikasi, berikan peran Service Account Token Creator (roles/iam.serviceAccountTokenCreator) pada project ke agen layanan Pub/Sub. Jika tidak, peran ini akan diberikan secara default:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-pubsub.iam.gserviceaccount.com \
      --role=roles/iam.serviceAccountTokenCreator

Langkah berikutnya