Schlüsselsätze erstellen und aktualisieren

In dieser Anleitung wird beschrieben, wie du Schlüsselsätze für Media CDN erstellst und aktualisierst.

Hinweise

Die EdgeCacheKeyset, die Sie zum Verifizieren signierter Anfragetokens konfigurieren, muss die richtigen Schlüssel für den 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 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.

   Zu Media CDN

2. Klicken Sie auf den Tab Schlüsselsätze.
3. Klicke auf Schlüsselsatz erstellen.
4. Geben Sie unter Name einen eindeutigen Namen für das Schlüsselset 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 Ihren Schlüsselsatz ein.
7. Geben Sie mindestens einen öffentlichen Schlüssel oder einen Validierungsschlüssel an.

   Wenn Sie einen öffentlichen Schlüssel angeben möchten, klicken Sie auf Öffentlichen Schlüssel hinzufügen und gehen Sie dann 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 Ihres öffentlichen Ed25519-Schlüssels an. Alternativ können Sie auch Von Google verwalteten Schlüssel für Dual-Token-Authentifizierung verwenden auswählen.
8. Wenn Sie einen freigegebenen Validierungsschlüssel angeben möchten, klicken Sie auf Freigegebenen Validierungsschlüssel hinzufügen und gehen Sie dann 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

Führen Sie den Befehl gcloud edge-cache keysets create aus.

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 das Schlüsselset, 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

Überprüfen Sie die mit einem Schlüsselsatz verknüpften Schlüssel. Führen Sie den Befehl gcloud edge-cache keysets describe aus.

gcloud edge-cache keysets describe prod-vod-keyset

Die Ausgabe sieht in 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.

   Zu 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 erforderlichen Änderungen vor und klicken Sie dann auf Schlüsselsatz aktualisieren.

gcloud

Führen Sie folgenden gcloud edge-cache keysets update-Befehl aus:

gcloud edge-cache keysets update KEYSET_NAME