Creare e aggiornare set di chiavi

Questa guida mostra come creare e aggiornare i set di chiavi per Media CDN.

Prima di iniziare

L'EdgeCacheKeyset che configuri per la verifica dei token delle richieste firmate deve includere le chiavi corrette per l'algoritmo di firma che scegli.

La tabella seguente descrive ciascuno degli algoritmi di firma e le chiavi richieste.

Algoritmo di firma Chiavi richieste nel set di chiavi
Ed25519 Chiavi pubbliche
HMAC-SHA1 Chiavi condivise di convalida
HMAC-SHA256 Chiavi condivise di convalida

Come minimo, devi avere una chiave pubblica o una chiave condivisa di convalida. Puoi specificare fino a tre chiavi pubbliche e tre chiavi condivise di convalida, per un totale di sei chiavi per set di chiavi. Per informazioni sulla generazione di HMAC quando utilizzi l'autenticazione con doppio token, consulta Generare token.

Creare un set di chiavi

Per creare un nuovo set di chiavi:

Console

  1. Nella Google Cloud console, vai alla pagina Media CDN.

    Vai a Media CDN

  2. Fai clic sulla scheda Set di chiavi.
  3. Fai clic su Crea set di chiavi.
  4. In Nome, inserisci un nome univoco per il set di chiavi, ad esempio, prod-vod-keyset.
  5. (Facoltativo) In Descrizione, inserisci una descrizione per il set di chiavi.
  6. (Facoltativo) Fai clic su Aggiungi etichetta e inserisci una o più coppie chiave-valore per il set di chiavi.
  7. Specifica almeno una chiave pubblica o una chiave di convalida.

    Per specificare una chiave pubblica, fai clic su Aggiungi chiave pubblica e poi segui questi passaggi:

    1. In ID, inserisci un ID alfanumerico.
    2. Seleziona Inserisci il valore e specifica il valore con codifica Base64 della chiave pubblica Ed25519. In alternativa, seleziona Utilizza la chiave gestita da Google per l'autenticazione con doppio token.
  8. Per specificare una chiave condivisa di convalida, fai clic su Aggiungi chiave condivisa di convalida e poi segui questi passaggi:
    1. In Secret, seleziona un secret dall'elenco, inserisci un secret manualmente specificandone l'ID risorsa oppure crea un nuovo secret e poi selezionalo.
    2. In Versione secret, seleziona una versione secret dall'elenco oppure crea una nuova versione secret e poi selezionala.
  9. Fai clic su Crea set di chiavi.

gcloud

Utilizza il gcloud edge-cache keysets create comando.

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

Sostituisci quanto segue:

  • SHORT_KEYSET_NAME: un nome univoco per il set di chiavi, ad esempio prod-vod-keyset
  • SSL_PUBLIC_KEY_NAME: il nome della chiave pubblica SSL
  • SSL_PUBLIC_KEY_VALUE: il valore della chiave pubblica SSL

Esamina le chiavi associate a un set di chiavi. Utilizza il gcloud edge-cache keysets describe comando. 

gcloud edge-cache keysets describe prod-vod-keyset

L'output è simile al seguente:

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

Modificare un set di chiavi

Per modificare un set di chiavi:

Console

  1. Nella Google Cloud console, vai alla pagina Media CDN.

    Vai a Media CDN

  2. Fai clic sulla scheda Set di chiavi.
  3. Fai clic sul nome del set di chiavi.
  4. Per passare alla modalità di modifica, fai clic sul pulsante Modifica.
  5. Apporta le modifiche necessarie, quindi fai clic su Aggiorna set di chiavi.

gcloud

Utilizza il gcloud edge-cache keysets update comando: 

gcloud edge-cache keysets update KEYSET_NAME