Cloud Run functions 目標的角色和權限

本文說明如何授予 Identity and Access Management (IAM) 角色和權限,以便使用 Eventarc 將事件從 Google Cloud 和其他來源轉送至 Cloud Run functions。

  1. 為建立觸發條件和部署函式的主體,授予專案層級和部署權限:

    1. Eventarc 管理員角色可讓您完整控管所有 Eventarc 資源,包括在建立觸發條件時指定服務帳戶。

    2. 服務帳戶使用者角色可讓主體模擬及使用服務帳戶,包括觸發條件服務帳戶,以及函式執行階段或建構服務帳戶。

    3. 視您部署函式的方式而定,Cloud Run 原始碼開發人員和服務使用情形消費者角色 (使用 gcloud run CLI 或 Cloud Run Admin API 部署時),或 Cloud Functions 開發人員或 Cloud Functions 管理員角色 (使用 gcloud functions CLI 或 Cloud Functions v2 API 部署時),可讓您建立及更新函式。

  2. 將 Eventarc 觸發條件權限授予觸發條件服務帳戶:Eventarc 事件接收者角色可讓 Eventarc 觸發條件接收事件供應商的事件。如果您是從 Cloud Pub/Sub 轉送直接事件,則不需授予該角色。

  3. 將 Cloud Run 函式叫用權限授予觸發條件服務帳戶:Cloud Run 叫用者角色可讓 Eventarc 觸發條件叫用已驗證的 Cloud Run 函式。

  4. 將權限授予 Google 服務代理:

    1. Eventarc 服務代理角色可讓 Eventarc 服務代理管理基礎傳輸資源,並驗證事件來源。首次建立 Eventarc 資源時,系統會預設授予這個角色,但如果遭到移除,則必須還原。

    2. 如果您使用 gcloud functions CLI 或 Cloud Functions v2 API 部署函式,Cloud Functions 服務代理可透過 Cloud Functions 服務代理角色,建立及管理 Eventarc 觸發條件和基礎 Cloud Run 服務。啟用 Cloud Functions API 時,系統預設會授予這個角色,但如果遭到移除,則必須還原。

    3. 如要為 Cloud Storage 的直接事件建立觸發條件,請將 Pub/Sub 發布者角色授予 Cloud Storage 服務代理。

    4. 如果您是在 2021 年 4 月 8 日當天或之前啟用 Cloud Pub/Sub 服務代理,請將「服務帳戶權杖建立者」角色授予 Pub/Sub 服務代理。

如要進一步瞭解如何授予 IAM 角色,請參閱「管理存取權」。您或許也能透過自訂角色或其他預先定義的角色,取得必要權限。

授予專案層級和部署作業權限

如果您是專案建立者,系統會授予您基本擁有者角色 (roles/owner)。根據預設,這個角色包含完整存取大多數Google Cloud 資源所需的權限。否則,管理員必須在適當的資源上,將必要角色授予適當的主體 (也稱為成員)。

例如,主體可以是 Google 帳戶 (適用於使用者) 或服務帳戶 (適用於應用程式和運算工作負載)。每個主體都有專屬的 ID,通常是電子郵件地址。

  1. Eventarc 管理員角色 (roles/eventarc.admin) 可讓您完整控管所有 Eventarc 資源。

    授予專案角色:

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

    更改下列內容:

    • PROJECT_ID:您的 Google Cloud 專案 ID。

    • PRINCIPAL:觸發條件建立者的 ID,通常採用以下格式:PRINCIPAL_TYPE:ID。例如:user:my-user@example.com。如需可能的 PRINCIPAL_TYPE 值完整清單,請參閱政策繫結參考資料。

  2. 服務帳戶使用者角色 (roles/iam.serviceAccountUser) 可讓主體以服務帳戶的身分執行作業。

    您需要這個角色,才能將使用者自行管理的服務帳戶與 Eventarc 觸發條件建立關聯。此外,您也需要這項權限,才能在部署 Cloud Run 函式時,以執行階段服務帳戶的身分執行操作,並在從來源部署時,以建構服務帳戶的身分執行操作。詳情請參閱「服務帳戶驗證角色」。

    您可以授予專案角色,讓主體模擬多個服務帳戶,或授予服務帳戶角色,讓主體只能模擬特定服務帳戶。

    授予專案角色:

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

    或者,您也可以在服務帳戶上授予角色:

    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

    更改下列內容:

    • SERVICE_ACCOUNT_PROJECT_ID:包含服務帳戶的 Google Cloud專案 ID。

    • SERVICE_ACCOUNT_NAME:服務帳戶的名稱。

  3. 根據部署方式,授予部署 Cloud Run 函式所需的角色:

授予 Eventarc 觸發條件權限

每個 Eventarc 觸發條件在建立時,都會與一個 IAM 服務帳戶建立關聯。您可以指定使用者自行管理的服務帳戶,做為觸發條件的預設身分。如果在建立觸發條件時未指定服務帳戶,觸發條件會使用 Compute Engine 預設服務帳戶做為身分。

建議您建立自己的使用者自管服務帳戶,以便更靈活地控管觸發條件。

  1. 建立服務帳戶,並記下其名稱:

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

    更改下列內容:

    • SERVICE_ACCOUNT_NAME:服務帳戶的名稱。這個名稱會顯示在用來識別服務帳戶的電子郵件地址中。

    • DESCRIPTION:服務帳戶的選用說明。

    • DISPLAY_NAME:要在 Google Cloud 控制台中顯示的服務帳戶名稱。

  2. 將專案的 Eventarc 事件接收者角色 (roles/eventarc.eventReceiver) 授予與 Eventarc 觸發條件相關聯的服務帳戶,讓觸發條件能接收事件供應商的事件。

    請注意,如果您要轉送 Cloud Pub/Sub 的直接事件,則不需授予 Eventarc 事件接收者角色。

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

    將 SERVICE_ACCOUNT_NAME 替換為您在上一個步驟中記下的服務帳戶名稱。

授予 Cloud Run functions 叫用權限

根據預設,Cloud Run functions 需要驗證,也就是說,如果要求中未提供驗證憑證,就無法叫用函式。如果專案設有網域限制共用組織政策,請使用經過驗證的目標函式,而非允許公開 (未經驗證) 存取的函式。

  1. 如要將事件轉送至已驗證的 Cloud Run 函式,請將基礎 Cloud Run 服務的 Cloud Run 叫用者角色 (roles/run.invoker) 授予與 Eventarc 觸發條件相關聯的服務帳戶:

    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

    更改下列內容:

    • FUNCTION_NAME:Cloud Run 函式的名稱。

    • REGION:部署函式的區域。

  2. 您也可以選擇在 Google Cloud 專案中,為所有 Cloud Run 服務、函式和工作授予角色。詳情請參閱「控管專案中所有服務和工作的存取權」。

請注意,如果您為已驗證的 Cloud Run 函式建立觸發條件,但未授予 Cloud Run 叫用者角色,系統仍會成功建立觸發條件並啟用。不過,觸發條件不會正常運作,且記錄中會顯示類似下列的訊息:

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

將權限授予 Google 服務代理

部分 Google Cloud 服務具有服務代理,可讓服務存取您的資源。如果 API 需要服務代理,Google 會在您啟用並使用 API 後建立服務代理。

  1. 如果 Eventarc 服務代理已移除 Eventarc 服務代理角色 (roles/eventarc.serviceAgent),請在專案中授予該角色,讓 Eventarc 能夠管理基礎傳輸資源及驗證事件來源。否則,當您首次建立 Eventarc 資源時,系統會預設授予這個角色:

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

    將 PROJECT_NUMBER 替換為您的 Google Cloud專案編號。您可以在 Google Cloud 控制台的「Welcome」(歡迎) 頁面找到專案編號,也可以執行下列指令:

    gcloud projects describe PROJECT_ID --format='value(projectNumber)'
  2. 如果您使用 gcloud functions deploy 或 Cloud Functions 第 2 代 API 部署函式,且 Cloud Functions 服務代理角色 (roles/cloudfunctions.serviceAgent) 已從 Cloud Functions 服務代理中移除,請在專案中授予該角色,讓服務代理可以建立及管理 Eventarc 觸發條件和基礎 Cloud Run 服務。否則,啟用 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

    請注意,這個角色已淘汰,僅適用於使用 Cloud Functions API 建立的函式。如要瞭解使用 Cloud Run 建立的函式,請參閱「Cloud Run 角色和權限」頁面。

  3. 如果您要為 Cloud Storage 的直接事件建立觸發條件,請將專案的 Pub/Sub 發布者角色 (roles/pubsub.publisher) 授予 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. 如果您是在 2021 年 4 月 8 日當天或之前啟用 Cloud Pub/Sub 服務代理,請將專案的服務帳戶權杖建立者角色 (roles/iam.serviceAccountTokenCreator) 授予 Pub/Sub 服務代理,以支援經過驗證的 Pub/Sub 推送要求。否則,系統預設會授予這個角色:

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

後續步驟