このページは Cloud Translation API によって翻訳されました。

キーセットを作成して更新する

このガイドでは、Media CDN の鍵セットを作成および更新する方法について説明します。

始める前に

署名付きリクエストトークンの検証用に構成する EdgeCacheKeyset には、選択した署名アルゴリズムの正しい鍵を含める必要があります。

次の表に、各署名アルゴリズムと必要な鍵を示します。

署名アルゴリズム	鍵セットに必要な鍵
Ed25519	公開鍵
HMAC-SHA1	共有検証鍵
HMAC-SHA256	共有検証鍵

少なくとも公開鍵または共有検証鍵が必要です。鍵セットあたり、公開鍵と共有検証鍵をそれぞれ 3 つまで、合計 6 つの鍵を指定できます。デュアルトークン認証を使用する場合の HMAC の生成については、トークンを生成するをご覧ください。

鍵セットを作成する

新しい鍵セットを作成するには、次の手順を行います。

Console

Google Cloud コンソールで、[Media CDN] ページに移動します。
Media CDN に移動
[鍵セット] タブをクリックします。
[鍵セットを作成] をクリックします。
[名前] に、一意の鍵セット名を入力します（例: prod-vod-keyset）。
省略可: [説明] に、鍵セットの説明を入力します。
省略可: [ラベルを追加] をクリックして、鍵セットの Key-Value ペアを 1 つ以上入力します。
少なくとも 1 つの公開鍵または検証鍵を指定します。
公開鍵を指定するには、[公開鍵を追加] をクリックして、次の操作を行います。
1. [ID] に英数字の ID を入力します。
2. [値を入力] を選択し、Ed25519 公開鍵の base64 でエンコードされた値を指定します。または、[デュアルトークン認証に Google が管理する鍵を使用する] を選択します。
検証共有鍵を指定するには、[検証共有鍵を追加] をクリックして、次の操作を行います。
1. [シークレット] で、リストからシークレットを選択し、リソース ID を指定して手動でシークレットを入力するか、新しいシークレットを作成して選択します。
2. [シークレットのバージョン] で、リストからシークレットバージョンを選択するか、新しいシークレットバージョンを作成して選択します。
[鍵セットを作成] をクリックします。

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
  }
}

鍵セットを変更する

鍵セットを変更する手順は次のとおりです。

Console

Google Cloud コンソールで、[Media CDN] ページに移動します。
Media CDN に移動
[鍵セット] タブをクリックします。
キーセット名をクリックします。
編集モードに切り替えるには、[編集] ボタンをクリックします。
必要な変更を加えて、[キーセットを更新] をクリックします。

gcloud

gcloud edge-cache keysets update コマンドを使用します。

gcloud edge-cache keysets update KEYSET_NAME