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 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 der Verwendung von Dual-Token-Authentifizierung Weitere Informationen 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. Klicken Sie 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 des Schlüsselsatzes 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 die base64-codierte Ihres öffentlichen Ed25519-Schlüssels. Sie können auch Verwenden Sie einen von Google verwalteten Schlüssel für die Dual-Token-Authentifizierung.
  8. Klicken Sie auf Validierung hinzufügen, um einen freigegebenen Validierungsschlüssel anzugeben. freigegebene Schlüssel 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 für Secret-Version eine Secret-Version aus der list oder Erstellen Sie eine neue Secret-Version und wählen Sie sie dann aus.
  9. Klicken Sie auf Schlüsselsatz erstellen.

gcloud

Verwenden Sie die Methode 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 die Keyset, z. B. prod-vod-keyset
  • SSL_PUBLIC_KEY_NAME: der Name Ihrer SSL-Verbindung öffentlicher Schlüssel
  • SSL_PUBLIC_KEY_VALUE: der Wert Ihres Öffentlicher SSL-Schlüssel

Prü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 gewünschten Änderungen vor und klicken Sie auf Schlüsselsatz aktualisieren.

gcloud

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

gcloud edge-cache keysets update KEYSET_NAME