Schlüsselsätze erstellen und aktualisieren

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

Hinweise

Die EdgeCacheKeyset, die Sie zum Überprüfen signierter Anforderungstokens 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 dafür 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 Keyset-Namen ein, z. B. prod-vod-keyset.
  5. Optional: Geben Sie unter Beschreibung eine Beschreibung für Ihren 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 als 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 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 für 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 Keyset, 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

Schlüssel ansehen, die einem Schlüsselsatz zugeordnet sind Führen Sie den Befehl gcloud edge-cache keysets describe aus.

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 erforderlichen Änderungen vor und klicken Sie dann auf Keyset aktualisieren.

gcloud

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

gcloud edge-cache keysets update KEYSET_NAME