Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

管理憑證對應關係

憑證對應組合會參照一或多個憑證對應關係，後者會將特定憑證指派給特定主機名稱。本頁面說明如何建立及管理憑證對應組合。

詳情請參閱「憑證對應組合」。

建立憑證對應組合

您可以建立憑證對應組合，參照與憑證相關聯的憑證對應關係。

這項工作需要的角色

如要執行這項工作，您必須具備目標 Google Cloud 專案的下列其中一個 IAM 角色。

Certificate Manager 編輯者角色 (roles/certificatemanager.editor)
Certificate Manager 擁有者角色 (roles/certificatemanager.owner)

詳情請參閱「角色和權限」。

注意：如果您未獲派必要角色，請與具備專案 IAM 管理員角色 (roles/resourcemanager.projectIamAdmin) 的 IAM 管理員聯絡，要求授予缺少的角色。

控制台

在 Google Cloud 控制台中，前往「Certificate Manager」頁面，然後按一下「Certificate maps」(憑證對應組合) 分頁標籤。

前往「Certificate Manager」
按一下「 Create certificate map」(建立憑證對應組合)。
在「Name」(名稱) 欄位中，輸入憑證對應組合的名稱，例如 cert-map-8。
在「Description」(說明) 欄位中，輸入憑證對應組合的說明，例如 My new certificate map。
如要建立憑證對應關係並新增至憑證對應組合，請按一下「Add map entry」(新增對應項目)，然後按照後續章節所述步驟操作。
如要新增標籤並與憑證對應組合建立關聯，請按一下「Add label」(新增標籤)，然後輸入標籤的鍵和值。
點選「建立」。

gcloud

如要建立憑證對應組合，請使用 gcloud certificate-manager maps create 指令：

gcloud certificate-manager maps create CERTIFICATE_MAP_NAME

更改下列內容：

CERTIFICATE_MAP_NAME：憑證對應組合的名稱

API

如要建立憑證對應組合，請向 certificateMaps.create 方法發出 POST 要求：

POST /v1/projects/PROJECT_ID/locations/global/certificateMaps?certificate_map_id=CERTIFICATE_MAP_NAME

更改下列內容：

PROJECT_ID： Google Cloud 專案 ID
CERTIFICATE_MAP_NAME：憑證對應組合的名稱

Terraform

如要建立憑證對應組合，請使用 google_certificate_manager_certificate_map 資源：

resource "google_certificate_manager_certificate_map" "default" {
  name        = "${local.name}-certmap1-${random_id.tf_prefix.hex}"
  description = "${local.domain} certificate map"
  labels = {
    "terraform" : true
  }
}

如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。

將憑證對應組合附加至 Proxy

使用憑證對應組合項目建立及設定憑證對應組合後，請將憑證對應組合附加至目標 Proxy。Certificate Manager 支援全域範圍的目標 HTTPS 和目標 SSL Proxy。如要進一步瞭解這些 Proxy 類型的差異，請參閱「使用目標 Proxy」。

如果您將傳輸層安全標準 (TLS) (SSL) 憑證附加至目標 Proxy，並透過憑證對應組合附加憑證，Proxy 會使用憑證對應組合中參照的憑證，並忽略直接附加的憑證。

這項工作需要的角色

如要執行這項工作，您必須具備目標 Google Cloud 專案的下列其中一個 IAM 角色。

Certificate Manager 編輯者角色 (roles/certificatemanager.editor)

詳情請參閱「角色和權限」。

注意：如果您未獲派必要角色，請與具備專案 IAM 管理員角色 (roles/resourcemanager.projectIamAdmin) 的 IAM 管理員聯絡，要求授予缺少的角色。

控制台

如果目標 Proxy 屬於現有負載平衡器，您可以編輯負載平衡器的前端設定，附加憑證對應組合。

前往 Google Cloud 控制台的「Load balancing」(負載平衡) 頁面。

前往「Load balancing」(負載平衡)
按一下要更新的負載平衡器名稱，然後點選「Edit」(編輯)。
按一下「Frontend configuration」(前端設定)，然後選取要編輯的前端 IP 位址和通訊埠設定。
如果畫面上顯示「Choose certificate repository」(選擇憑證存放區)，請選取「Use certificate map」(使用憑證對應關係)。
在「Select a certificate map」(選取憑證對應組合) 清單中，選取憑證對應組合。
按一下「Done」(完成)，然後按一下「Update」(更新)。

gcloud

如要將憑證對應組合附加至目標 HTTPS Proxy，請使用 gcloud compute target-https-proxies update 指令：

gcloud compute target-https-proxies update PROXY_NAME \
    --certificate-map="CERTIFICATE_MAP_NAME"

如要將憑證對應組合附加至目標 SSL Proxy，請使用 gcloud compute target-ssl-proxies update 指令：

gcloud compute target-ssl-proxies update PROXY_NAME \
    --certificate-map="CERTIFICATE_MAP_NAME"

更改下列內容：

PROXY_NAME：目標 Proxy 的名稱
CERTIFICATE_MAP_NAME：憑證對應組合的名稱，其中包含參照目標憑證的對應項目

API

如要將憑證對應組合附加至目標 HTTPS Proxy，請向 targetHttpsProxies 方法發出 POST 要求：

POST /projects/PROJECT_ID/global/targetHttpsProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "//certificatemanager.googleapis.com/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME",
}

如要將憑證對應組合附加至目標 SSL Proxy，請向 targetSslProxies 方法發出 POST 要求：

POST /projects/PROJECT_ID/global/targetSslProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "//certificatemanager.googleapis.com/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME",
}

更改下列內容：

PROJECT_ID： Google Cloud 專案 ID
PROXY_NAME：目標 Proxy 的名稱
CERTIFICATE_MAP_NAME：憑證對應組合的名稱，其中包含參照目標憑證的對應項目

從 Proxy 卸載憑證對應組合

從 Proxy 卸載憑證對應組合前，請注意下列事項：

如果任何 TLS (SSL) 憑證直接附加至 Proxy，卸載憑證對應組合會導致 Proxy 繼續使用這些憑證。
如果沒有 TLS (SSL) 憑證直接附加至 Proxy，就無法卸載憑證對應組合。請先將至少一個 TLS 憑證直接附加至 Proxy，再卸載憑證對應組合。

這項工作需要的角色

如要執行這項工作，您必須具備目標 Google Cloud 專案的下列其中一個 IAM 角色。

Compute 負載平衡器管理員角色 (roles/compute.loadBalancerAdmin)

詳情請參閱「角色和權限」。

注意：如果您未獲派必要角色，請與具備專案 IAM 管理員角色 (roles/resourcemanager.projectIamAdmin) 的 IAM 管理員聯絡，要求授予缺少的角色。

gcloud

如要從目標 HTTPS Proxy 卸載任何附加的憑證對應組合，請使用 gcloud compute target-https-proxies update 指令：

gcloud compute target-https-proxies update PROXY_NAME \
    --clear-certificate-map

如要從目標 SSL Proxy 卸載任何附加的憑證對應組合，請使用 gcloud compute target-ssl-proxies update 指令：

gcloud compute target-ssl-proxies update PROXY_NAME \
    --clear-certificate-map

更改下列內容：

PROXY_NAME：目標 Proxy 的名稱

API

如要從目標 HTTPS Proxy 卸載任何附加的憑證對應組合，請向 targetHttpsProxies 方法發出 POST 要求：

POST /projects/PROJECT_ID/global/targetHttpsProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "",
}

如要從目標 SSL Proxy 卸載任何附加的憑證對應組合，請向 targetSslProxies 方法發出 POST 要求：

POST /projects/PROJECT_ID/global/targetSslProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "",
}

更改下列內容：

PROJECT_ID： Google Cloud 專案 ID
PROXY_NAME：目標 Proxy 的名稱

更新憑證對應組合

您可以更新憑證對應組合的說明和標籤。如果使用Google Cloud 控制台，您可以在憑證對應組合中新增對應項目，或編輯/刪除與憑證對應組合相關聯的對應項目。

這項工作需要的角色

如要執行這項工作，您必須具備目標 Google Cloud 專案的下列其中一個 IAM 角色。

Certificate Manager 編輯者角色 (roles/certificatemanager.editor)
Certificate Manager 擁有者角色 (roles/certificatemanager.owner)

詳情請參閱「角色和權限」。

注意：如果您未獲派必要角色，請與具備專案 IAM 管理員角色 (roles/resourcemanager.projectIamAdmin) 的 IAM 管理員聯絡，要求授予缺少的角色。

控制台

在 Google Cloud 控制台中，前往「Certificate Manager」頁面，然後按一下「Certificate maps」(憑證對應組合) 分頁標籤。

前往「Certificate Manager」
在憑證對應組合清單中，按一下所需的憑證對應組合。「Certificate Map Details」(憑證對應組合詳細資料) 頁面隨即開啟。
按一下「編輯」圖示。「Edit certificate map」(編輯憑證對應組合) 頁面隨即開啟。
在「Description」(說明) 欄位中，輸入憑證對應組合的新說明。
如要在憑證對應組合中新增對應關係，請按一下「Add map entry」(新增對應項目)，然後按照「建立憑證對應關係」一節所述的步驟操作。

如要編輯憑證對應關係，請在憑證對應關係列的「Actions」(動作) 欄下方，按一下圖示，選取「Edit」(編輯)，然後按照「更新憑證對應關係」一節所述的步驟操作。

如要刪除憑證對應關係，請在憑證對應關係列的「Actions」(動作) 欄下方，按一下圖示，選取「Delete」(刪除)，然後按照「刪除憑證對應關係」一節所述的步驟操作。
您可以新增、刪除或更新與憑證對應組合相關聯的標籤。

如要新增標籤，請按一下「Add label」(新增標籤)，然後指定標籤的鍵和值。

如要刪除標籤，請按一下所需標籤的「Delete item」(刪除項目)。
按一下 [儲存]。

gcloud

如要更新憑證對應組合，請使用 gcloud certificate-manager maps update 指令：

gcloud certificate-manager maps update CERTIFICATE_MAP_NAME \
    --description="DESCRIPTION"
    --update-labels="LABELS"

更改下列內容：

CERTIFICATE_MAP_NAME：憑證對應組合的名稱
DESCRIPTION：這個憑證對應組合的新說明
LABELS：以半形逗號分隔的清單，列出套用至這個憑證對應組合的標籤

API

如要更新憑證對應組合，請向 certificateMaps.patch 方法發出 PATCH 要求：

PATCH /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME?updateMask=labels,description
{
  "description": "DESCRIPTION",
  "labels": {
    "LABEL_KEY": "LABEL_VALUE",
  }
}

更改下列內容：

PROJECT_ID： Google Cloud 專案 ID
CERTIFICATE_MAP_NAME：憑證對應組合的名稱
DESCRIPTION：這個憑證對應組合的新說明
LABEL_KEY：套用至這個憑證對應組合的標籤鍵
LABEL_VALUE：套用至這個憑證對應組合的標籤

列出憑證對應組合

您可以查看、篩選及排序已建立的所有憑證對應組合清單。

這項工作需要的角色

如要執行這項工作，您必須具備目標 Google Cloud 專案的下列其中一個 IAM 角色。

Certificate Manager 檢視者角色 (roles/certificatemanager.viewer)
Certificate Manager 編輯者角色 (roles/certificatemanager.editor)
Certificate Manager 擁有者角色 (roles/certificatemanager.owner)

詳情請參閱「角色和權限」。

注意：如果您未獲派必要角色，請與具備專案 IAM 管理員角色 (roles/resourcemanager.projectIamAdmin) 的 IAM 管理員聯絡，要求授予缺少的角色。

控制台

前往 Google Cloud 控制台的「Certificate Manager」頁面。

前往「Certificate Manager」
按一下「憑證對應組合」分頁標籤。您可以查看、篩選及設定所選專案中所有憑證對應組合的顯示欄。

gcloud

如要列出憑證對應組合，請使用 gcloud certificate-manager maps list 指令：

gcloud certificate-manager maps list \
    --filter="FILTER" \
    --page-size="PAGE_SIZE" \
    --limit="LIMIT" \
    --sort-by="SORT_BY"

更改下列內容：

FILTER：運算式，用於將傳回結果限制為特定值。

舉例來說，如要依標籤和建立時間篩選結果，可以指定 --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'。

如要查看更多可與 Certificate Manager 搭配使用的篩選範例，請參閱 Cloud Key Management Service 說明文件中的「排序及篩選清單結果」。
PAGE_SIZE：每頁要傳回的結果數量
LIMIT：要傳回的結果數量上限
SORT_BY：以半形逗號分隔的 name 欄位清單，傳回的結果會依這些欄位排序。預設排列順序為遞增；如要遞減排列順序，請在欄位前面加上波浪號 (~)。

API

如要列出已設定的憑證對應組合，請向 certificateMaps.list 方法發出 LIST 要求：

GET /v1/projects/PROJECT_ID/locations/global/certificateMaps?filter=FILTER&pageSize=PAGE_SIZE&sortBy=SORT_BY

更改下列內容：

PROJECT_ID： Google Cloud 專案 ID
FILTER：運算式，用於將傳回結果限制為特定值。

舉例來說，如要依標籤和建立時間篩選結果，可以指定： --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'

如要查看更多可與 Certificate Manager 搭配使用的篩選範例，請參閱 Cloud Key Management Service 說明文件中的「排序及篩選清單結果」。
PAGE_SIZE：每頁要傳回的結果數量
SORT_BY：以半形逗號分隔的 name 欄位清單，傳回的結果會依這些欄位排序。預設排列順序為遞增；如要遞減排列順序，請在欄位前面加上波浪號 (~)。

查看憑證對應組合的詳細資料

您可以查看現有憑證對應組合的詳細資料，例如建立日期時間、上次更新日期時間和說明。

這項工作需要的角色

如要執行這項工作，您必須具備目標 Google Cloud 專案的下列其中一個 IAM 角色。

Certificate Manager 檢視者角色 (roles/certificatemanager.viewer)
Certificate Manager 編輯者角色 (roles/certificatemanager.editor)
Certificate Manager 擁有者角色 (roles/certificatemanager.owner)

詳情請參閱「角色和權限」。

注意：如果您未獲派必要角色，請與具備專案 IAM 管理員角色 (roles/resourcemanager.projectIamAdmin) 的 IAM 管理員聯絡，要求授予缺少的角色。

控制台

在 Google Cloud 控制台中，前往「Certificate Manager」頁面，然後按一下「Certificate maps」(憑證對應組合) 分頁標籤。

前往「Certificate Manager」
在憑證對應組合清單中，按一下所需的憑證對應組合。「Certificate Map Details」(憑證對應組合詳細資料) 頁面隨即開啟，顯示所選憑證對應組合的詳細資訊。

gcloud

如要查看憑證對應組合的詳細資料，請使用 gcloud certificate-manager maps describe 指令：

gcloud certificate-manager maps describe CERTIFICATE_MAP_NAME

更改下列內容：

CERTIFICATE_MAP_NAME：憑證對應組合的名稱

API

如要查看憑證對應組合的詳細資料，請向 certificateMaps.get 方法發出 GET 要求：

GET /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME

更改下列內容：

PROJECT_ID： Google Cloud 專案 ID
CERTIFICATE_MAP_NAME：憑證對應組合的名稱

刪除憑證對應組合

刪除憑證對應組合前，請先完成下列事項：

從目標 Proxy 卸離憑證對應組合。
如果憑證對應組合已指派任何憑證對應關係，請刪除指派給憑證對應組合的憑證對應關係。

這項工作需要的角色

如要執行這項工作，您必須具備目標 Google Cloud 專案的下列其中一個 IAM 角色。

Certificate Manager 擁有者角色 (roles/certificatemanager.owner)

詳情請參閱「角色和權限」。

注意：如果您未獲派必要角色，請與具備專案 IAM 管理員角色 (roles/resourcemanager.projectIamAdmin) 的 IAM 管理員聯絡，要求授予缺少的角色。

控制台

在 Google Cloud 控制台中，前往「Certificate Manager」頁面，然後按一下「Certificate maps」(憑證對應組合) 分頁標籤。

前往「Certificate Manager」
在憑證對應組合清單中，按一下所需的憑證對應組合。「Certificate Map Details」(憑證對應組合詳細資料) 頁面隨即開啟。
依序點選「 Delete」(刪除) 和「Delete」(刪除)。

gcloud

如要刪除憑證對應組合，請使用 gcloud certificate-manager maps delete 指令：

gcloud certificate-manager maps delete CERTIFICATE_MAP_NAME

更改下列內容：

CERTIFICATE_MAP_NAME：憑證對應組合的名稱

API

如要刪除憑證對應組合，請向 certificateMaps.delete 方法發出 DELETE 要求：

DELETE /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME

更改下列內容：

PROJECT_ID： Google Cloud 專案 ID
CERTIFICATE_MAP_NAME：憑證對應組合的名稱

管理憑證對應關係 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

建立憑證對應組合

這項工作需要的角色

控制台

gcloud

API

Terraform

將憑證對應組合附加至 Proxy

這項工作需要的角色

控制台

gcloud

API

從 Proxy 卸載憑證對應組合

這項工作需要的角色

gcloud

API

更新憑證對應組合

這項工作需要的角色

控制台

gcloud

API

列出憑證對應組合

這項工作需要的角色

控制台

gcloud

API

查看憑證對應組合的詳細資料

這項工作需要的角色

控制台

gcloud

API

刪除憑證對應組合

這項工作需要的角色

控制台

gcloud

API

後續步驟

管理憑證對應關係