建立及更新金鑰組

本指南說明如何建立及更新 Media CDN 的金鑰組。

事前準備

您為驗證已簽章要求符記設定的 EdgeCacheKeyset 必須包含所選簽章演算法的正確金鑰。

下表說明每個簽章演算法及其必要金鑰。

簽名演算法	金鑰組中的必要金鑰
Ed25519	公開金鑰
HMAC-SHA1	驗證共用金鑰
HMAC-SHA256	驗證共用金鑰

至少須提供一個公開金鑰或驗證共用金鑰。最多可以有三個公開金鑰和三個驗證共用金鑰 (每個金鑰組總計不超過六個金鑰)。如要瞭解如何在使用雙權杖驗證時產生 HMAC，請參閱「產生權杖」。

建立金鑰組

如要建立新的金鑰集，請按照下列步驟操作：

控制台

1. 前往 Google Cloud 控制台的「Media CDN」頁面。

   前往 Media CDN

2. 按一下「Keysets」(金鑰集) 分頁標籤。
3. 按一下「建立金鑰集」。
4. 在「Name」(名稱) 部分，輸入不重複的鍵集名稱，例如 prod-vod-keyset。
5. 選用：在「Description」(說明) 中輸入金鑰集的說明。
6. 選用：按一下「新增標籤」，然後為金鑰集輸入一或多個鍵/值組合。
7. 至少須指定一個公開金鑰或一個驗證金鑰。

   如要指定公開金鑰，請按一下「新增公開金鑰」，然後執行下列操作：

   1. 在「ID」中輸入英數字元 ID。
   2. 選取「輸入值」，然後指定 Ed25519 公開金鑰的 Base64 編碼值。或者，選取「使用 Google 代管的金鑰進行雙重權杖驗證」。
8. 如要指定驗證共用金鑰，請按一下「新增驗證共用金鑰」，然後執行下列步驟：
   1. 在「密鑰」部分，從清單中選取密鑰、指定資源 ID 手動輸入密鑰，或 建立新密鑰，然後選取該密鑰。
   2. 在「Secret version」(密鑰版本) 中，從清單中選取密鑰版本，或 建立新的密鑰版本，然後選取該版本。
9. 按一下「建立金鑰集」。

gcloud

使用 gcloud edge-cache keysets create 指令。

gcloud edge-cache keysets create SHORT_KEYSET_NAME \
    --public-key='id=SSL_PUBLIC_KEY_NAME,value=SSL_PUBLIC_KEY_VALUE'

更改下列內容：

• SHORT_KEYSET_NAME：金鑰集的專屬名稱，例如 prod-vod-keyset
• SSL_PUBLIC_KEY_NAME：SSL 公開金鑰的名稱
• SSL_PUBLIC_KEY_VALUE：SSL 公開金鑰的值

查看與金鑰集相關聯的金鑰。使用 gcloud edge-cache keysets describe 指令。

gcloud edge-cache keysets describe prod-vod-keyset

輸出結果會與下列內容相似：

name: prod-vod-keyset
description: "Keyset for prod.example.com"
publicKeys:
  - id: "key-20200918"
    value: "DThVLjhAKm3VYOvLBAwFZ5XbjVyF98Ias8NZU0WEM9w"
  - id: "key-20200808"
    value: "Lw7LDSaDUrbDdqpPA6JEmMF5BA5GPtd7sAjvsnh7uDA="

Terraform

resource "google_network_services_edge_cache_keyset" "default" {
  name        = "prod-vod-keyset"
  description = "Keyset for prod.example.com"
  public_key {
    id    = "key-20200918"
    value = "FHsTyFHNmvNpw4o7-rp-M1yqMyBF8vXSBRkZtkQ0RKY" # Update Ed25519 public key
  }
  public_key {
    id    = "key-20200808"
    value = "Lw7LDSaDUrbDdqpPA6JEmMF5BA5GPtd7sAjvsnh7uDA=" # Update Ed25519 public key
  }
}

修改金鑰組

如要修改鍵集，請執行下列步驟：

控制台

1. 前往 Google Cloud 控制台的「Media CDN」頁面。

   前往 Media CDN

2. 按一下「Keysets」(金鑰集) 分頁標籤。
3. 按一下金鑰集名稱。
4. 如要切換至編輯模式，請按一下「編輯」按鈕。
5. 進行所需變更，然後按一下「更新金鑰集」。

gcloud

使用 gcloud edge-cache keysets update 指令：

gcloud edge-cache keysets update KEYSET_NAME