如果組織需要控管個別使用者的 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 控制台
前往 Google Cloud 控制台的「Service accounts」(服務帳戶) 頁面。
選取專案。
按一下使用者自行管理的服務帳戶電子郵件地址。
選取「具備存取權的主體」分頁標籤。
按一下「Grant access」(授予存取權)。
輸入使用者的主體 ID。如果是 Google 帳戶,這是指電子郵件地址,例如
user1@example.com。從「Role」(角色) 下拉式選單中,選取「Service Account User」(服務帳戶使用者)。
按一下 [儲存]。主體就會取得服務帳戶的角色。
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 控制台
前往 Google Cloud 控制台的「Service accounts」(服務帳戶) 頁面。
選取專案。
按一下使用者自行管理的服務帳戶電子郵件地址。
選取「具備存取權的主體」分頁標籤。
按一下「Grant access」(授予存取權)。
輸入服務代理的電子郵件地址。
從「Role」(角色) 下拉式選單中,選取「Service Account Token Creator」(服務帳戶權杖建立者)。
按一下 [儲存]。主體就會取得服務帳戶的角色。
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 控制台
按照操作說明建立移轉作業。完成移轉工作前:
- 在「選擇設定」頁面,找到「服務帳戶類型」部分。
- 選取「使用者自行管理的服務帳戶」。
- 輸入使用者管理的服務帳戶電子郵件地址,格式為
SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com。 - 點選「建立」,建立移轉工作。
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 控制台
前往 Google Cloud 控制台的「Service accounts」(服務帳戶) 頁面。
按一下服務帳戶的電子郵件地址。
在「詳細資料」分頁中,找到「專屬 ID」。
gcloud CLI
使用下列 Google Cloud CLI 指令:
gcloud iam service-accounts describe USER_MANAGED_SERVICE_ACCOUNT_EMAIL \
--format='value(uniqueId)'