虛擬私有雲網路中內部 HTTP 端點的角色和權限

本文說明如何授予 Identity and Access Management (IAM) 角色和權限,以便使用 Eventarc 將 Google Cloud 和其他來源的事件轉送至虛擬私有雲 (VPC) 網路中的內部 HTTP 端點。

  1. 將專案層級權限授予叫用 Eventarc API 的主體 (例如 Eventarc 觸發條件建立者):

    1. Eventarc 管理員角色可讓您完整控管所有 Eventarc 資源,包括在建立觸發條件時指定服務帳戶。
    2. 「服務帳戶使用者」角色可讓主體模擬及使用服務帳戶。服務帳戶與 Eventarc 觸發條件相關聯,代表觸發條件的身分。
  2. 將 Eventarc 觸發條件權限授予觸發條件服務帳戶:Eventarc 事件接收者角色可讓 Eventarc 觸發條件接收事件供應商的事件。如果您是從 Cloud Pub/Sub 轉送直接事件,則不需授予該角色。

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

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

    2. 如果內部 HTTP 端點的 URI 使用 Cloud DNS 可解析服務的內部 DNS 名稱,請將 VPC 主機專案的 DNS 對接角色授予 Eventarc 服務代理。

    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 觸發條件時,您需要這個角色,才能將使用者自行管理的服務帳戶與觸發條件建立關聯,以代表其身分。詳情請參閱「服務帳戶驗證角色」。

    您可以授予專案角色,允許主體模擬多個服務帳戶,也可以授予服務帳戶角色,允許主體僅模擬特定服務帳戶。

    授予專案角色:

    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:服務帳戶的名稱。

授予 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 替換為您在上一個步驟中記下的服務帳戶名稱。

將權限授予 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. 如果虛擬私有雲網路中內部 HTTP 端點的 URI,使用 Cloud DNS 可解析服務的內部 DNS 名稱,則必須將虛擬私有雲主專案的 DNS 對接角色 (roles/dns.peer) 授予 Eventarc 服務代理,才能透過 DNS 對接區域存取目標網路:

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

    更改下列內容:

    • VPC_HOST_PROJECT_ID:虛擬私有雲主機專案的 Google Cloud 專案 ID。使用Shared VPC時,您會將一或多個服務專案附加至主專案,讓多個專案的資源連線至共同的虛擬私有雲網路。

      請注意,視虛擬私有雲網路的設定方式而定,虛擬私有雲主專案也可能是 Eventarc 觸發條件專案。

    • PROJECT_NUMBER:Eventarc 觸發條件專案的 Google Cloud 專案編號。

  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

後續步驟