將服務代理人權限委派給使用者管理的服務帳戶

如果組織需要控管個別使用者的 bucket 存取權,可以選擇將服務代理權限委派給使用者自行管理的服務帳戶。

如果是無代理程式移轉作業,Storage 移轉服務預設會使用服務代理,在來源和目的地之間移轉資料。您需要授予服務代理權限,才能存取 Cloud Storage bucket。

由於專案內的所有移轉作業都使用相同的 Storage 移轉服務代理,因此該代理必然具備該專案內每項移轉作業涉及的「所有」 bucket 權限。

您也可以選擇將 bucket 權限指派給多個使用者管理的服務帳戶。這些使用者自行管理的服務帳戶會獲得特定來源和目的地 bucket 的權限,且僅限特定使用者帳戶 (建立或觸發移轉工作的工作) 使用。

範例情境

下列情境示範使用服務代理和使用者自行管理的服務帳戶時,可用的不同權限選項。

展開各部分即可查看詳細資料。

情境 1:僅限服務代理

在這種情況下,系統會將所有權限授予服務代理。

  • 服務代理會取得值區 A、B、C 和 D 的寫入權限。

只要具備建立移轉工作的適當權限,任何使用者都能將資料移入或移出 bucket A、B、C 和 D。

如果 Storage 移轉服務使用者是所有 bucket 中資料的信任使用者,且能正確設定移轉工作,避免將資料移入或移出錯誤的 bucket,則這個方法相當實用。

情境 2:僅限使用者自行管理的服務帳戶

在這種情況下,所有權限都會授予使用者自行管理的服務帳戶。

  • 使用者管理的服務帳戶 #1 具備 bucket A 和 B 的權限。
  • 使用者自行管理的服務帳戶 #2 則具備 bucket C 和 D 的權限。

此外:

  • 使用者 Alpha 獲得服務帳戶 #1 的存取權。
  • 使用者 Bravo 獲得服務帳戶 #2 的存取權。
  • 使用者 Charlie 獲得服務帳戶 #1 和 #2 的存取權。

在這種情況下:

  • Alpha 只能在 bucket A 和 B 之間轉移。
  • Bravo 只能在 bucket C 和 D 之間轉移。
  • Charlie 只能在 bucket A 和 B 之間,以及 C 和 D 之間轉移。
  • Charlie 無法在 A 和 C、A 和 D、B 和 C 或 B 和 D 之間轉移。

情境 3:混合權限

在這種情況下,專案會同時包含服務代理權限和使用者自行管理的服務帳戶權限。

  • 服務代理會取得 bucket A 和 B 的寫入權限。
  • 使用者管理的服務帳戶 #1 獲得 bucket C 的唯讀權限,以及 bucket D 的寫入權限。
  • 使用者 Alpha 獲派使用者自行管理的服務帳戶 #1 存取權。

在這種情況下:

  • 只要具備建立移轉工作的適當權限,任何使用者都能將資料移入或移出 bucket A 和 B。無法轉移至 bucket C 或 D,也無法從這兩個 bucket 轉出。
  • 使用者 Alpha 可以將資料移入或移出 bucket A 和 B。
  • Alpha 可以將值區 C 的物件移出至值區 D。
  • Alpha 無法從 bucket C 轉出至 bucket A 或 B。

導入程序總覽

實作方式如下:

  • 建立使用者管理的服務帳戶,或使用現有帳戶。
  • 授予權限:
    • 使用者可存取使用者自行管理的服務帳戶。
    • 服務代理可從使用者管理的服務帳戶產生存取權杖。
    • 使用者自行管理的服務帳戶,用於存取 bucket。
  • 使用者建立移轉工作,並指定使用者自行管理的服務帳戶。
  • Storage 移轉服務會檢查使用者是否具備服務帳戶的正確權限。如果未授予正確權限,轉移工作就會建立失敗。
  • 服務代理會代表使用者管理的服務帳戶產生 OAuth 權杖。OAuth 權杖可讓 Storage 移轉服務存取參與移轉作業的值區。
  • 移轉工作會執行。
  • OAuth 權杖效期短,會過期。如果權杖到期時轉移工作仍在進行,Storage 移轉服務會產生新的權杖並繼續轉移。

設定權限委派

按照操作說明,將服務代理存取權委派給使用者管理的服務帳戶。

需求條件

  • 如要建立或管理移轉工作,使用者帳戶必須具備 Storage 移轉服務專案權限。請參閱「必要的使用者授權」。
  • 如要建立新的使用者自行管理服務帳戶,您必須具備專案的「建立服務帳戶」(roles/iam.serviceAccountCreator) 角色。
  • 如要將使用者代管服務帳戶的存取權授予使用者和服務代理,您必須在使用者代管服務帳戶或專案中,具備服務帳戶管理員 (roles/iam.serviceAccountAdmin) 角色。

建立或找出使用者自行管理的服務帳戶

您可以建立新的使用者管理服務帳戶,或使用現有帳戶。

  • 如要建立使用者自行管理的服務帳戶,請按照「建立服務帳戶」中的操作說明進行。

  • 如要使用現有的使用者自行管理服務帳戶,您需要該帳戶的電子郵件地址,格式如下:

    SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

  • 如需服務帳戶的專屬 ID (uniqueId),請執行 gcloud iam service-accounts describe SERVICE_ACCOUNT_EMAIL --format="value(uniqueId)",或在Google Cloud 控制台的「Service Accounts」(服務帳戶) 頁面中查看「Unique ID」(專屬 ID) 欄。

如果服務帳戶與移轉工作位於不同專案,請參閱「啟用跨專案附加服務帳戶的功能」。

將存取權授予使用者

授予使用者帳戶新使用者自行代管服務帳戶的存取權,並指派「服務帳戶使用者」角色 (roles/iam.serviceAccountUser)。使用者帳戶是用來建立或更新移轉工作的帳戶。

Google Cloud 控制台

  1. 前往 Google Cloud 控制台的「Service accounts」(服務帳戶) 頁面。

    前往「Service Accounts」(服務帳戶)

  2. 選取專案。

  3. 按一下使用者自行管理的服務帳戶電子郵件地址。

  4. 選取「具備存取權的主體」分頁標籤。

  5. 按一下「Grant access」(授予存取權)。

  6. 輸入使用者的主體 ID。如果是 Google 帳戶,這是指電子郵件地址,例如 user1@example.com。

  7. 從「Role」(角色) 下拉式選單中,選取「Service Account User」(服務帳戶使用者)。

  8. 按一下 [儲存]。主體就會取得服務帳戶的角色。

gcloud

如要將角色授予主體,請執行 add-iam-policy-binding 指令:

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

請替換下列變數:

  • USER_MANAGED_SERVICE_ACCOUNT_EMAIL:使用者自行管理的服務帳戶電子郵件地址,格式為 SA_NAME@PROJECT_ID.iam.gserviceaccount.com。
  • PRINCIPAL:執行移轉工作的實體 ID,例如 Google 帳戶的 user:name@example.com,或聯合使用者的 principal:// ID。請參閱「主體 ID」。

將存取權授予服務代理

如要讓服務代理從使用者管理的服務帳戶產生存取權杖,請授予服務代理存取使用者管理的服務帳戶的權限,並指派服務帳戶權杖建立者角色 (roles/iam.serviceAccountTokenCreator)。

您需要服務代理的電子郵件地址,才能授予存取權。針對您用來管理 Storage 移轉服務的專案 ID,呼叫 googleServiceAccounts.get:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storagetransfer.googleapis.com/v1/googleServiceAccounts/PROJECT_ID"

或者,前往 googleServiceAccounts.get 參考頁面,在「Try this method」(試用這個方法) 面板的「Request parameters」(要求參數) 下方輸入專案 ID,然後按一下「Execute」(執行)。

服務代理的電子郵件會以 accountEmail 的值傳回。格式為 project-PROJECT_NUMBER@storage-transfer-service.iam.gserviceaccount.com。

接著,如要授予服務代理存取使用者自行管理的服務帳戶權限,請按照下列步驟操作:

Google Cloud 控制台

  1. 前往 Google Cloud 控制台的「Service accounts」(服務帳戶) 頁面。

    前往「Service Accounts」(服務帳戶)

  2. 選取專案。

  3. 按一下使用者自行管理的服務帳戶電子郵件地址。

  4. 選取「具備存取權的主體」分頁標籤。

  5. 按一下「Grant access」(授予存取權)。

  6. 輸入服務代理的電子郵件地址。

  7. 從「Role」(角色) 下拉式選單中,選取「Service Account Token Creator」(服務帳戶權杖建立者)。

  8. 按一下 [儲存]。主體就會取得服務帳戶的角色。

gcloud

如要將角色授予主體,請執行 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

請替換下列變數:

  • USER_MANAGED_SERVICE_ACCOUNT_EMAIL:使用者自行管理的服務帳戶電子郵件地址,格式為 SA_NAME@PROJECT_ID.iam.gserviceaccount.com。
  • SERVICE_AGENT_EMAIL:服務代理的電子郵件地址。

將 bucket 權限授予使用者管理的服務帳戶

將「設定來源存取權:Cloud Storage」和「設定接收器存取權:Cloud Storage」中列出的權限,授予使用者管理的服務帳戶,而非服務代理。

使用使用者自行管理的服務帳戶建立移轉工作

授予正確權限後,您可以在建立新的移轉工作時,指定使用者管理的服務帳戶。

Google Cloud 控制台

按照操作說明建立移轉作業。完成移轉工作前:

  1. 在「選擇設定」頁面,找到「服務帳戶類型」部分。
  2. 選取「使用者自行管理的服務帳戶」。
  3. 輸入使用者管理的服務帳戶電子郵件地址,格式為 SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com。
  4. 點選「建立」,建立移轉工作。

REST API

在 transferJobs.create 要求中,將使用者自行管理的服務帳戶指定為 serviceAccount 欄位的值。

服務帳戶電子郵件 (SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com) 或專屬 ID (123456789012345678901) 皆可。

例如:

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.iam.gserviceaccount.com",
"transferSpec": {
  // ...
}
}

擷取服務帳戶的專屬 ID

設定 AWS S3 或 Microsoft Azure 儲存空間的聯合存取權,或在 REST API 要求中指定服務帳戶時,您可能需要使用者代管服務帳戶的專屬 ID。

如何擷取uniqueId:

Google Cloud 控制台

  1. 前往 Google Cloud 控制台的「Service accounts」(服務帳戶) 頁面。

    前往「Service Accounts」(服務帳戶)

  2. 按一下服務帳戶的電子郵件地址。

  3. 在「詳細資料」分頁中,找到「專屬 ID」。

gcloud CLI

使用下列 Google Cloud CLI 指令:

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