创建和更新键集

本指南介绍了如何为媒体 CDN 创建和更新密钥集。

准备工作

您为验证已签名请求令牌而配置的 EdgeCacheKeyset 必须包含您选择的签名算法的正确密钥。

下表介绍了每种签名算法及其所需的密钥。

签名算法 密钥集中所需的密钥
Ed25519 公钥
HMAC-SHA1 验证共享密钥
HMAC-SHA256 验证共享密钥

您必须至少拥有一个公钥或一个验证共享密钥。对于每个密钥集，最多可以指定 3 个公钥和 3 个验证共享密钥，共计 6 个密钥。如需了解在使用 双令牌身份验证时如何生成 HMAC， 请参阅生成令牌。

创建密钥集

如需创建新密钥集，请执行以下操作：

控制台

  1. 在 Google Cloud 控制台中，前往 媒体 CDN 页面。

    转到“媒体 CDN”

  2. 点击密钥集 标签页。
  3. 点击 创建密钥集 。
  4. 对于名称，输入唯一的密钥集名称，例如 prod-vod-keyset。
  5. 可选：对于说明，输入密钥集的说明。
  6. 可选：点击添加标签 ，然后为密钥集输入一个或多个键值对。
  7. 至少指定一个公钥或一个验证密钥。

    如需指定公钥，请点击添加公钥 ，然后执行以下操作：

    1. 对于 ID，输入字母数字 ID。
    2. 选择输入值 ，然后指定 Ed25519 公钥的 base64 编码 值。或者，选择 使用 Google 管理的密钥进行双令牌身份验证。
  8. 如需指定验证共享密钥，请点击添加验证 共享密钥，然后执行以下操作：
    1. 对于密钥，从列表中选择一个密钥，通过指定其资源 ID 手动输入密钥，或者 创建新密钥，然后选择该密钥。
    2. 对于密钥版本，从 列表中选择一个密钥版本，或者 创建新密钥版本，然后选择该版本。
  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 控制台中，前往 媒体 CDN 页面。

    转到“媒体 CDN”

  2. 点击密钥集 标签页。
  3. 点击密钥集名称。
  4. 如需切换到修改模式，请点击修改 按钮。
  5. 进行所需的更改，然后点击更新密钥集 。

gcloud

使用 gcloud edge-cache keysets update 命令： 

gcloud edge-cache keysets update KEYSET_NAME