Schlüsselsätze erstellen und aktualisieren

In dieser Anleitung wird gezeigt, wie Sie Schlüsselsätze für Media CDN erstellen und aktualisieren.

Hinweis

Der EdgeCacheKeyset, den Sie zum Überprüfen signierter Anfragetokens konfigurieren, muss die richtigen Schlüssel für den von Ihnen ausgewählten Signaturalgorithmus enthalten.

In der folgenden Tabelle werden die einzelnen Signaturalgorithmen und die erforderlichen Schlüssel beschrieben.

Signaturalgorithmus	Erforderliche Schlüssel im Schlüsselsatz
Ed25519	Öffentliche Schlüssel
HMAC-SHA1	Freigegebene Validierungsschlüssel
HMAC-SHA256	Freigegebene Validierungsschlüssel

Sie benötigen mindestens einen öffentlichen Schlüssel oder einen freigegebenen Validierungsschlüssel. Sie können bis zu drei öffentliche Schlüssel und drei freigegebene Validierungsschlüssel angeben, also insgesamt sechs Schlüssel pro Schlüsselsatz. Informationen zum Generieren von HMACs bei Verwendung der Dual-Token-Authentifizierung, finden Sie unter Tokens generieren.

Schlüsselsatz erstellen

So erstellen Sie einen neuen Schlüsselsatz:

Console

1. Rufen Sie in der Google Cloud Console die Seite Media CDN auf.

   Zum Media CDN

2. Klicken Sie auf den Tab Schlüsselsätze.
3. Klicken Sie auf Schlüsselsatz erstellen.
4. Geben Sie unter Name einen eindeutigen Namen für den Schlüsselsatz ein, z. B. prod-vod-keyset.
5. Optional: Geben Sie unter Beschreibung eine Beschreibung für den Schlüsselsatz ein.
6. Optional: Klicken Sie auf Label hinzufügen und geben Sie ein oder mehrere Schlüssel/Wert-Paare für den Schlüsselsatz ein.
7. Geben Sie mindestens einen öffentlichen Schlüssel oder einen Validierungsschlüssel an.

   Klicken Sie zum Angeben eines öffentlichen Schlüssels auf Öffentlichen Schlüssel hinzufügen und gehen Sie so vor:

   1. Geben Sie unter ID eine alphanumerische ID ein.
   2. Wählen Sie Wert eingeben aus und geben Sie den base64-codierten Wert des öffentlichen Ed25519-Schlüssels an. Alternativ können Sie Von Google verwalteten Schlüssel für Dual-Token-Authentifizierung verwenden auswählen.
8. Klicken Sie zum Angeben eines freigegebenen Validierungsschlüssels auf Validierung geteilten Schlüssel hinzufügen und gehen Sie so vor:
   1. Wählen Sie unter Secret ein Secret aus der Liste aus, geben Sie ein Secret manuell ein, indem Sie die Ressourcen-ID angeben, oder erstellen Sie ein neues Secret und wählen Sie es dann aus.
   2. Wählen Sie unter Secret-Version eine Secret-Version aus der Liste aus oder erstellen Sie eine neue Secret-Version und wählen Sie sie dann aus.
9. Klicken Sie auf Schlüsselsatz erstellen.

gcloud

Verwenden Sie den gcloud edge-cache keysets create Befehl.

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

Ersetzen Sie Folgendes:

• SHORT_KEYSET_NAME: ein eindeutiger Name für den Schlüsselsatz, z. B. prod-vod-keyset
• SSL_PUBLIC_KEY_NAME: der Name Ihres öffentlichen SSL -Schlüssels
• SSL_PUBLIC_KEY_VALUE: der Wert Ihres öffentlichen SSL-Schlüssels

Prüfen Sie die Schlüssel, die mit einem Schlüsselsatz verknüpft sind. Verwenden Sie den gcloud edge-cache keysets describe Befehl.

gcloud edge-cache keysets describe prod-vod-keyset

Die Ausgabe sieht etwa so aus:

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

Schlüsselsatz ändern

So ändern Sie einen Schlüsselsatz:

Console

1. Rufen Sie in der Google Cloud Console die Seite Media CDN auf.

   Zum Media CDN

2. Klicken Sie auf den Tab Schlüsselsätze.
3. Klicken Sie auf den Namen des Schlüsselsatzes.
4. Klicken Sie auf die Schaltfläche Bearbeiten, um in den Bearbeitungsmodus zu wechseln.
5. Nehmen Sie die gewünschten Änderungen vor und klicken Sie dann auf Schlüsselsatz aktualisieren.

gcloud

Verwenden Sie den gcloud edge-cache keysets update Befehl:

gcloud edge-cache keysets update KEYSET_NAME