如要在 Compute Engine 工作負載之間建立雙向傳輸層安全標準 (mTLS) 連線,您可以使用 gcloud CLI 設定代管工作負載身分,並設定憑證的自動佈建和生命週期管理。核發憑證時,您可以使用 Google 代管的預設憑證授權單位 (CA),或搭配憑證授權單位服務使用自行管理的憑證授權單位。
事前準備
選取或建立專案所需的角色
- 選取專案:選取專案時,不需具備特定 IAM 角色,只要您在專案中獲派角色,即可選取該專案。
-
建立專案:如要建立專案,您必須具備專案建立者角色 (
roles/resourcemanager.projectCreator),其中包含resourcemanager.projects.create權限。瞭解如何授予角色。
-
建立 Google Cloud 專案:
gcloud projects create PROJECT_ID
將
PROJECT_ID替換為您要建立的 Google Cloud 專案名稱。 -
選取您建立的 Google Cloud 專案:
gcloud config set project PROJECT_ID
將
PROJECT_ID替換為 Google Cloud 專案名稱。
瞭解代管工作負載身分。
瞭解如何使用憑證授權單位服務核發憑證。
啟用 IAM 和憑證授權單位服務 API (如果尚未啟用):
啟用 API 所需的角色
如要啟用 API,您必須具備
serviceusage.services.enable權限。如果您建立了專案,可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則,您可以透過「Service Usage 管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。gcloud services enable iam.googleapis.com
privateca.googleapis.com 設定 Google Cloud CLI,使用專案處理帳單和配額。
gcloud config set billing/quota_project PROJECT_ID
將 PROJECT_ID 替換為專案 ID。
必要的角色
如要取得建立代管工作負載身分及佈建代管工作負載身分憑證所需的權限,請要求管理員授予您專案的下列 IAM 角色:
-
如要建立及設定代管工作負載身分,請按照下列步驟操作:
- IAM Workload Identity 集區管理員 (
roles/iam.workloadIdentityPoolAdmin) - 服務帳戶管理員 (
roles/iam.serviceAccountAdmin)
- IAM Workload Identity 集區管理員 (
-
如要建立及設定 CA 集區:CA 服務管理員 (
roles/privateca.admin)
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
或者,IAM 擁有者 (roles/owner) 基本角色也包含設定代管工作負載身分的權限。請勿在正式環境中授予基本角色,但可以在開發或測試環境中授予。
總覽
如要為應用程式使用代管工作負載身分,您必須執行下列工作:
安全性管理員:
- 建立 workload identity pool。
- 設定 CA (選擇 CA 選項、設定 CA 及更新集區)。
- 在 workload identity pool 中建立代管工作負載身分。
- 定義工作負載驗證政策並建立服務帳戶。
Compute 管理員:
為在 Compute Engine 執行的工作負載啟用代管工作負載身分:
- 個別 VM。
- 適用於代管執行個體群組 (MIG)。
建立 workload identity pool
如要設定代管工作負載身分,請在
TRUST_DOMAIN模式中建立集區。gcloud iam workload-identity-pools create POOL_ID \ --location="global" \ --mode="TRUST_DOMAIN"
將 POOL_ID 替換為集區的專屬 ID。ID 長度必須介於 4 到 32 個字元之間,只能使用小寫英數字元和破折號,且開頭和結尾須為英數字元。workload identity pool 建立後即無法變更 ID。
如要確認 workload identity pool 是以
TRUST_DOMAIN模式建立,請執行workload-identity-pools describe指令。gcloud iam workload-identity-pools describe POOL_ID \ --location="global"
輸出結果會與下列內容相似:
mode: TRUST_DOMAIN name: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID state: ACTIVE
如果指令輸出中未顯示
mode: TRUST_DOMAIN,請確認您已正確設定 gcloud CLI,使用正確的專案進行計費和配額。請確認您已更新至最新版本的 gcloud CLI。
選擇 CA 選項
如要簽署工作負載憑證,請選擇最符合用途的憑證授權單位 (CA) 選項:
Google 代管的預設 CA:選取這個選項,即可使用免付費的全代管解決方案。預設 CA 提供的信任根會由所有Google Cloud 使用者共用。
「Custom CA」(自訂 CA):選取這個選項,即可透過憑證授權單位服務,自行設定公用金鑰基礎架構 (PKI)。如果您需要自訂信任根,或必須將簽署金鑰儲存在硬體安全性模組 (HSM) 中,以符合法規遵循要求,則適合採用這個選項。憑證授權單位服務與代管工作負載身分功能分開計費。詳情請參閱「CA 服務定價」。
設定 CA
預設 CA
如要將預設 CA 繫結至 workload identity pool,請使用 use-default-shared-ca 旗標更新 workload identity pool。
gcloud iam workload-identity-pools update TRUST_DOMAIN_NAME \
--location="global" \
--use-default-shared-ca \
--project=PROJECT_ID
更改下列內容:
TRUST_DOMAIN_NAME:信任網域的名稱。PROJECT_ID:專案 ID。
自訂 CA
如要使用自訂 CA 設定代管工作負載身分,請完成下列步驟:
設定 CA 服務,為代管工作負載身分核發憑證
使用憑證授權單位服務集區,為根憑證授權單位和從屬憑證授權單位 (CA) 建立建議設定。從屬 CA 集區會將 X.509 Workload Identity 憑證核發給 VM。
CA 集區設定為使用代管工作負載身分,為 Compute Engine VM 核發憑證,因此必須與 VM 位於相同區域。如要設計多區域架構,以便在區域服務中斷時維持韌性,建議您為工作負載的每個區域設定從屬憑證授權單位服務 CA 集區。這樣一來,每個 Compute Engine VM 都能參照區域內的從屬憑證授權單位服務 CA 集區。
設定 CA 集區後,您需要授權代管工作負載身分,要求並接收 CA 集區中的已簽署憑證。
設定根 CA 集區
使用憑證授權單位服務的 Google Cloud CLI 介面,設定根 CA 集區。
CA 集區建立後即無法移動或匯出。
執行
gcloud privateca pools create指令,在企業級建立根 CA 集區。Enterprise 級別適用於長期、低量的憑證核發。gcloud privateca pools create ROOT_CA_POOL_ID \ --location=REGION \ --tier=enterprise
更改下列內容:
- ROOT_CA_POOL_ID:根 CA 集區的專屬 ID。ID 長度最多 64 個字元,且只能包含大小寫英數字元、底線或連字號。集區 ID 在區域內不得重複。
- REGION:根 CA 集區所在的區域。
詳情請參閱「建立 CA 集區」。
執行
gcloud privateca roots create指令,在根 CA 集區中建立根 CA。如果這是根 CA 集區中唯一的 CA,系統可能會提示您啟用根 CA。例如,您可以使用類似下列的指令來建立根 CA。
gcloud privateca roots create ROOT_CA_ID \ --pool=ROOT_CA_POOL_ID \ --subject "CN=ROOT_CA_CN, O=ROOT_CA_ORGANIZATION" \ --key-algorithm="ec-p256-sha256" \ --max-chain-length=1 \ --location=REGION
更改下列內容:
- ROOT_CA_ID:根 CA 的專屬名稱。CA 名稱長度上限為 64 個字元,且只能包含大小寫英數字元、底線或連字號。CA 名稱在區域內不得重複。
- ROOT_CA_POOL_ID:根 CA 集區的 ID。
- ROOT_CA_CN:根 CA 的一般名稱。
- ROOT_CA_ORGANIZATION:根 CA 的組織。
- REGION:根 CA 集區所在的區域。
選用:重複上述步驟,在根 CA 集區中建立其他根 CA。這項功能適用於輪替根憑證授權單位。
設定從屬 CA
使用憑證授權單位服務的 Google Cloud CLI 介面,建立從屬 CA 集區和從屬 CA。
如果您有多個憑證核發情境,可以為每個情境建立從屬 CA。此外,在 CA 集區中新增多個從屬 CA,有助於更有效地平衡憑證要求的負載。
使用 gcloud privateca pools create 指令建立從屬 CA 集區。
在 DevOps 級別建立從屬 CA 集區。這個級別適用於大量、短期的憑證核發。
gcloud privateca pools create SUBORDINATE_CA_POOL_ID \ --location=REGION \ --tier=devops
更改下列內容:
- SUBORDINATE_CA_POOL_ID:從屬 CA 集區的專屬 ID。ID 長度最多 64 個字元,且只能包含大小寫英數字元、底線或連字號。集區 ID 在區域內不得重複。
- REGION:建立從屬 CA 集區的區域。
詳情請參閱「建立 CA 集區」。
執行
gcloud privateca subordinates create指令,在從屬 CA 集區中建立從屬 CA。請勿變更預設的以設定為基礎的核發模式。舉例來說,您可以使用類似下列的指令建立從屬 CA。
gcloud privateca subordinates create SUBORDINATE_CA_ID \ --pool=SUBORDINATE_CA_POOL_ID \ --location=REGION \ --issuer-pool=ROOT_CA_POOL_ID \ --issuer-location=REGION \ --subject="CN=SUBORDINATE_CA_CN, O=SUBORDINATE_CA_ORGANIZATION" \ --key-algorithm="ec-p256-sha256" \ --use-preset-profile=subordinate_mtls_pathlen_0
更改下列內容:
- SUBORDINATE_CA_ID:從屬 CA 的專屬名稱。名稱長度最多 64 個字元,且只能使用大小寫英數字元、底線或連字號。CA 名稱在區域內不得重複。
- SUBORDINATE_CA_POOL_ID:從屬 CA 集區的名稱。
- REGION:從屬 CA 集區所在的區域。
- ROOT_CA_POOL_ID:根 CA 集區的 ID。
- REGION:根 CA 集區的區域。
- SUBORDINATE_CA_CN:從屬 CA 的一般名稱。
- SUBORDINATE_CA_ORGANIZATION:從屬 CA 核發機構的名稱。
將 CA 繫結至 workload identity pool
建立 CA 階層後,請使用各個 CA 的憑證核發設定更新集區,將 CA 繫結至 workload identity pool。
建立
issuance-config.yaml檔案,並加入以下內容:inlineCertificateIssuanceConfig: caPools: REGION: projects/PROJECT_ID/locations/REGION/caPools/SUBORDINATE_CA_POOL_ID keyAlgorithm: RSA_2048 lifetime: 86400s rotationWindowPercentage: 50
替換檔案中的下列內容:
REGION:從屬 CA 集區所在的區域。PROJECT_ID:從屬 CA 集區所在專案的 ID。SUBORDINATE_CA_POOL_ID:從屬 CA 集區的 ID。
執行下列指令,更新 workload identity pool:
gcloud iam workload-identity-pools update POOL_ID \ --location="global" \ --inline-certificate-issuance-config-file=ISSUANCE_CONFIG_FILE
更改下列內容:
POOL_ID:集區的專屬 ID。ISSUANCE_CONFIG_FILE:issuance-config.yaml檔案的路徑。
授權代管的工作負載身分向 CA 集區要求憑證
代管工作負載身分必須具備權限,才能向 CA 服務要求憑證,並取得公開憑證。
將各個從屬 CA 集區的 CA 服務工作負載憑證要求者 (
roles/privateca.workloadCertificateRequester) IAM 角色授予代管工作負載身分。下列gcloud privateca pools add-iam-policy-binding指令會授權代管的工作負載身分,向 CA 服務憑證鏈要求憑證。gcloud privateca pools add-iam-policy-binding SUBORDINATE_CA_POOL_ID \ --location=REGION \ --role=roles/privateca.workloadCertificateRequester \ --member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/name/locations/global/workloadIdentityPools/POOL_ID/*"
更改下列內容:
- SUBORDINATE_CA_POOL_ID:從屬 CA 集區的 ID。
- REGION:從屬 CA 集區的區域。
- PROJECT_NUMBER:workload identity pool 所在專案的專案編號。
- POOL_ID:workload identity pool 的 ID。
將從屬 CA 集區的 CA 服務集區讀取者 (
roles/privateca.poolReader) IAM 角色授予代管工作負載身分。這會授權代管的工作負載身分,從 CA 的憑證鏈結取得已簽署的 X.509 憑證。gcloud privateca pools add-iam-policy-binding SUBORDINATE_CA_POOL_ID \ --location=REGION \ --role=roles/privateca.poolReader \ --member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/name/locations/global/workloadIdentityPools/POOL_ID/*"
更改下列內容:
- SUBORDINATE_CA_POOL_ID:從屬 CA 集區的 ID。
- REGION:從屬 CA 集區的區域。
- PROJECT_NUMBER:workload identity pool 所在專案的專案編號。
- POOL_ID:workload identity pool 的 ID。
建立代管工作負載身分
代管的工作負載身分功能可讓您 Google Cloud 自動將 workload identity pool 身分的憑證佈建至工作負載。工作負載身分是在 workload identity pool 中定義,並組織成稱為「命名空間」的管理邊界。
建立命名空間
workload-identity-pools namespaces create 指令可讓您在 workload identity pool 中建立命名空間。
gcloud iam workload-identity-pools namespaces create NAMESPACE_ID \
--workload-identity-pool="POOL_ID" \
--location="global"
更改下列內容:
NAMESPACE_ID:命名空間的專屬 ID。ID 長度必須介於 2 到 63 個字元之間,只能使用小寫英數字元和連字號,且開頭和結尾須為英數字元。命名空間建立後,就無法變更 ID。POOL_ID:先前建立的 workload identity pool ID。
建立代管工作負載身分
workload-identity-pools managed-identities create 指令可讓您在 workload identity pool 命名空間中,建立代管的工作負載身分。
gcloud iam workload-identity-pools managed-identities create MANAGED_IDENTITY_ID \
--namespace="NAMESPACE_ID" \
--workload-identity-pool="POOL_ID" \
--location="global"
更改下列內容:
MANAGED_IDENTITY_ID:受管理身分的專屬 ID。ID 長度必須介於 2 至 63 個字元之間,只能使用小寫英數字元和破折號,且開頭和結尾須為英數字元。建立代管工作負載身分後,即無法變更其 ID。NAMESPACE_ID:您先前建立的命名空間 ID。POOL_ID:先前建立的 workload identity pool ID。
代管工作負載身分 ID 是 SPIFFE ID,格式如下:
spiffe://POOL_ID.global.PROJECT_NUMBER.workload.id.goog/ns/NAMESPACE_ID/sa/MANAGED_IDENTITY_ID
定義工作負載驗證政策
本節說明如何設定驗證政策。這項政策會決定 Google Cloud IAM 使用哪些屬性來驗證工作負載的身分。驗證完成後,呼叫工作負載即可接收憑證。
驗證作業會依據下列其中一項工作負載屬性進行:
- 附加的服務帳戶電子郵件地址
- 附加的服務帳戶 UID
- VM 執行個體名稱
- VM 執行個體 ID
定義工作負載驗證政策和驗證規則
如要建立驗證政策,允許工作負載使用代管身分,請按照下列步驟操作:
決定是否要建立驗證政策,讓工作負載使用附加的服務帳戶、執行個體名稱或執行個體 ID,驗證代管身分。
建立 JSON 格式的驗證政策檔案。
選用:如要在 Compute Engine 執行個體上接收 X.509 憑證,必須啟用附加的服務帳戶。建議您先使用下列指令建立新的服務帳戶,再將其附加至工作負載:
gcloud iam service-accounts create SERVICE_ACCOUNT_NAME
將
SERVICE_ACCOUNT_NAME替換為服務帳戶名稱建立 JSON 格式的驗證政策檔案,根據服務帳戶電子郵件地址、服務帳戶 UID、執行個體名稱或執行個體 ID 進行驗證。
服務帳戶電子郵件地址
如要建立驗證政策檔案,根據服務帳戶電子郵件地址進行驗證,請建立包含下列內容的檔案:
{ "attestationRules": [ { "googleCloudResource": "//compute.googleapis.com/projects/WORKLOAD_PROJECT_NUMBER/type/Instance/attached_service_account.email/SERVICE_ACCOUNT_EMAIL" } ], }更改下列內容:
WORKLOAD_PROJECT_NUMBER:VM 執行個體或服務帳戶所在專案的編號如要取得專案編號,找出含有受管理身分或您剛建立的服務帳戶的專案,請執行下列指令:
gcloud projects describe $(gcloud config get-value project) \ --format="value(projectNumber)"
SERVICE_ACCOUNT_EMAIL:附加至 VM 的服務帳戶電子郵件地址
服務帳戶 UID
如要建立驗證政策檔案,根據服務帳戶 UID 進行驗證,請建立包含下列內容的檔案:
{ "attestationRules": [ { "googleCloudResource": "//compute.googleapis.com/projects/WORKLOAD_PROJECT_NUMBER/type/Instance/attached_service_account.uid/SERVICE_ACCOUNT_UID" } ], }更改下列內容:
WORKLOAD_PROJECT_NUMBER:VM 執行個體或服務帳戶所在專案的編號如要取得專案編號,找出含有受管理身分或您剛建立的服務帳戶的專案,請執行下列指令:
gcloud projects describe $(gcloud config get-value project) \ --format="value(projectNumber)"
SERVICE_ACCOUNT_UID:附加至 VM 的服務帳戶 UID
如要取得服務帳戶的專屬 ID,請執行下列指令:
gcloud iam service-accounts describe SERVICE_ACCOUNT_EMAIL\ --format="value(uniqueId)"執行個體名稱
如要建立驗證政策檔案,並根據執行個體名稱進行驗證,請建立含有下列內容的檔案:
{ "attestationRules": [ { "googleCloudResource": "//compute.googleapis.com/projects/WORKLOAD_PROJECT_NUMBER/name/zones/ZONE/instances/INSTANCE_NAME" } ], }更改下列內容:
WORKLOAD_PROJECT_NUMBER:VM 執行個體或服務帳戶所在專案的編號如要取得專案編號,找出含有受管理身分或您剛建立的服務帳戶的專案,請執行下列指令:
gcloud projects describe $(gcloud config get-value project) \ --format="value(projectNumber)"
ZONE:Compute Engine VM 區域INSTANCE_NAME:新或現有 Compute Engine VM 執行個體的名稱
執行個體 ID
如要建立根據執行個體 ID 驗證的驗證政策檔案,請建立含有下列內容的檔案:
{ "attestationRules": [ { "googleCloudResource": "//compute.googleapis.com/projects/WORKLOAD_PROJECT_NUMBER/uid/zones/ZONE/instances/INSTANCE_ID" } ], }更改下列內容:
WORKLOAD_PROJECT_NUMBER:VM 執行個體或服務帳戶所在專案的編號如要取得專案編號,找出含有受管理身分或您剛建立的服務帳戶的專案,請執行下列指令:
gcloud projects describe $(gcloud config get-value project) \ --format="value(projectNumber)"
INSTANCE_ID:Compute Engine VM 執行個體 ID執行個體 ID 的值必須來自現有的 Compute Engine 執行個體。如要取得執行個體 ID,請執行下列指令:
gcloud compute instances describe INSTANCE_NAME --zone=ZONE --format="get(id)"
INSTANCE_NAME:Compute Engine VM 執行個體名稱ZONE:Compute Engine VM 區域
使用您先前在本文件中建立的政策 JSON 檔案,建立驗證政策:
gcloud iam workload-identity-pools managed-identities set-attestation-rules MANAGED_IDENTITY_ID \ --namespace=NAMESPACE_ID \ --workload-identity-pool=POOL_ID \ --policy-file=PATH_TO_POLICY_JSON_FILE \ --location=global
更改下列內容:
MANAGED_IDENTITY_ID:受管理身分的專屬 ID。ID 長度必須介於 2 至 63 個字元之間,只能使用小寫英數字元和破折號,且開頭和結尾須為英數字元。建立代管工作負載身分後,即無法變更其 ID。NAMESPACE_ID:您先前建立的命名空間 ID。POOL_ID:先前建立的 workload identity pool ID。PATH_TO_POLICY_JSON_FILE:JSON 檔案的路徑,代表您先前建立的驗證政策。
您也可以個別新增或移除認證規則,藉此更新政策。如要將驗證新增至驗證政策,請執行下列指令:
gcloud iam workload-identity-pools managed-identities add-attestation-rule MANAGED_IDENTITY_ID \ --namespace=NAMESPACE_ID \ --workload-identity-pool=POOL_ID \ --google-cloud-resource='//compute.googleapis.com/projects/WORKLOAD_PROJECT_NUMBER/type/Instance/attached_service_account.uid/SERVICE_ACCOUNT_UID' \ --location=global
如要瞭解如何列出或移除認證規則,請執行下列指令:
gcloud iam workload-identity-pools managed-identities list-attestation-rules --help gcloud iam workload-identity-pools managed-identities remove-attestation-rule --help
選用:啟用 workload identity pool 之間的信任聯盟
如要為不同信任網域中的工作負載啟用相互驗證,可以設定信任聯盟。
建立
trust-config.yaml檔案,並加入以下內容:inlineTrustConfig: additionalTrustBundles: POOL_ID.global.PROJECT_NUMBER.workload.id.goog: trustAnchors: - pemCertificate: "-----BEGIN CERTIFICATE-----\nPEM_ENCODED_CERTIFICATE\n-----END CERTIFICATE-----"
替換檔案中的下列內容:
POOL_ID:要與其建立聯合關係的 workload identity pool ID。PROJECT_NUMBER:要與其建立聯合關係的 workload identity pool 專案編號。PEM_ENCODED_CERTIFICATE:要與之建立聯合關係的 workload identity pool,其 PEM 編碼根 CA 憑證。
如要使用信任設定更新 workload identity pool,請執行下列指令:
gcloud iam workload-identity-pools update POOL_ID \ --location="global" \ --inline-trust-config-file=TRUST_CONFIG_FILE
更改下列內容:
POOL_ID:集區的專屬 ID。TRUST_CONFIG_FILE:trust-config.yaml檔案的路徑。