Cette page explique comment mettre à jour les clés Media CDN utilisées pour les requêtes. Vous pouvez avoir jusqu'à trois clés publiques et trois clés partagées de validation, pour un total de six clés par collection de clés. Pour éviter de dépasser ces limites lors d'une rotation de clé, consultez les instructions suivantes pour supprimer une clé partagée de validation et ajouter une clé.
Avant de commencer
Configurez vos clés partagées de validation dans Secret Manager.
Accordez le rôle d'accès Secret Manager. (
roles/secretmanager.secretAccessor
) vers Media CDN de service géré.Console
Dans la console Google Cloud, accédez à la page Secret Manager.
- Sélectionnez le secret.
- Dans le panneau d'informations, cliquez sur Ajouter un compte principal.
Pour Nouveaux comptes principaux, saisissez le compte de service Media CDN comme suit :
service-PROJECT_NUMBER@gcp-sa-mediaedgefill.iam.gserviceaccount.com
Remplacez
PROJECT_NUMBER
par votre numéro de projet.- Dans le champ Sélectionnez un rôle, choisissez Secret Manager, puis Sélectionnez Accesseur de secrets Secret Manager.
- Cliquez sur Enregistrer.
gcloud
Exécutez la commande
gcloud secrets add-iam-policy-binding
:gcloud secrets add-iam-policy-binding projects/PROJECT_NUMBER/secrets/SECRET_ID \ --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-mediaedgefill.iam.gserviceaccount.com" \ --role="roles/secretmanager.secretAccessor"
Remplacez les éléments suivants :
PROJECT_NUMBER
: votre numéro de projetSECRET_ID
: ID du secret
Supprimer un secret
Console
Dans la console Google Cloud, accédez à la page Media CDN.
Cliquez sur l'onglet Collections de clés.
Sélectionnez la collection de clés contenant le secret que vous souhaitez supprimer, puis cliquez sur Modifier.
Pour supprimer un secret, accédez à la section Clés > Clés de validation partagées : cliquer sur Supprimer à côté du nom du secret.
Cliquez sur Mettre à jour la collection de clés.
gcloud
Pour supprimer une clé secrète d'un ensemble de clés, utilisez la commande gcloud edge-cache keysets
update
. Omettez le jeu de touches que vous souhaitez supprimer et spécifiez les jeux de touches que vous souhaitez conserver.
Dans l'exemple suivant, KEY_VERSION_1
ne figure pas dans la liste, alors que KEY_VERSION_2
et
KEY_VERSION_3
sont répertoriés. Omission
KEY_VERSION_1
le supprime de la collection de clés.
gcloud edge-cache keysets update KEYSET_NAME \ --validation-shared-key='secret_version=projects/PROJECT_NUMBER/secrets/SECRET_ID/versions/KEY_VERSION_2' --validation-shared-key='secret_version=projects/PROJECT_NUMBER/secrets/SECRET_ID/versions/KEY_VERSION_3'
Remplacez les éléments suivants :
KEYSET_NAME
: nom du jeu de clésPROJECT_NUMBER
: votre numéro de projetSECRET_ID
: l'ID du secret que tu mets à jourKEY_VERSION
: version de la clé
éditeur de texte
Exportez votre collection de clés dans un fichier YAML. Utilisez la commande
gcloud edge-cache keysets export
.gcloud edge-cache keysets export KEYSET_NAME \ --destination=FILENAME.yaml
Remplacez les éléments suivants :
KEYSET_NAME
: nom de votre collection de clés (par exemple,prod-vod-keyset
)FILENAME
: nom du fichier YAML
Modifiez le fichier de configuration de collection de clés exporté pour supprimer la clé secrète. L'exemple suivant montre comment supprimer la clé secrète la plus ancienne, qui se termine par KEY_VERSION_1:
name: projects/my-project/locations/global/edgeCacheKeysets/prod-vod-keyset validationSharedKeys: - secretVersion: "projects/PROJECT_NUMBER/secrets/SECRET_ID/versions/KEY_VERSION_1" - secretVersion: "projects/PROJECT_NUMBER/secrets/SECRET_ID/versions/KEY_VERSION_2" - secretVersion: "projects/PROJECT_NUMBER/secrets/SECRET_ID/versions/KEY_VERSION_3"
Remplacez les éléments suivants :
PROJECT_NUMBER
: votre numéro de projetSECRET_ID
: l'ID du secret que tu mets à jourKEY_VERSION
: version de la clé
Le fichier modifié se présente comme suit:
name: projects/my-project/locations/global/edgeCacheKeysets/prod-vod-keyset validationSharedKeys: - secretVersion: "projects/PROJECT_NUMBER/secrets/SECRET_ID/versions/KEY_VERSION_2" - secretVersion: "projects/PROJECT_NUMBER/secrets/SECRET_ID/versions/KEY_VERSION_3"
Importez la collection de clés modifiée. Exécutez la commande
gcloud edge-cache keysets import
:gcloud edge-cache keysets import KEYSET_NAME \ --source=FILENAME.yaml
Ajouter un secret
Console
Dans la console Google Cloud, accédez à la page Media CDN.
Cliquez sur l'onglet Collections de clés.
Sélectionnez le jeu de clés auquel vous souhaitez ajouter un secret, puis cliquez sur Modifier.
Pour ajouter un secret, accédez à la section Clés > Clés de validation partagées : cliquez sur Secret. Ensuite, sélectionnez un secret dans la liste, saisir un secret manuellement en spécifiant son ID de ressource ; ou créer un secret puis sélectionnez-la.
Sélectionnez une version de secret dans la liste ou créez une version de secret. puis sélectionnez-la.
Cliquez sur Mettre à jour la collection de clés.
gcloud
Pour ajouter une clé secrète à une collection de clés, utilisez la fonction gcloud edge-cache keysets update
de commande. Spécifiez les jeux de clés dont vous disposez et celui que vous souhaitez ajouter.
Dans l'exemple suivant, KEY_VERSION_1
était
précédemment supprimé, et KEY_VERSION_4
est
ensemble de clés en cours d'ajout. Référence KEY_VERSION_4
dans
en plus de KEY_VERSION_2
et
KEY_VERSION_3
l'ajoute à la collection de clés.
gcloud edge-cache keysets update KEYSET_NAME \ --validation-shared-key='secret_version=projects/PROJECT_NUMBER/secrets/SECRET_ID/versions/KEY_VERSION_2' --validation-shared-key='secret_version=projects/PROJECT_NUMBER/secrets/SECRET_ID/versions/KEY_VERSION_3' --validation-shared-key='secret_version=projects/PROJECT_NUMBER/secrets/SECRET_ID/versions/KEY_VERSION_4'
Remplacez les éléments suivants :
KEYSET_NAME
: nom du jeu de clésPROJECT_NUMBER
: votre numéro de projetSECRET_ID
: l'ID du secret que vous en cours de mise à jour...KEY_VERSION
: version de la clé
éditeur de texte
Exportez votre ensemble de clés dans un fichier YAML. Utilisez le Commande
gcloud edge-cache keysets export
gcloud edge-cache keysets export KEYSET_NAME \ --destination=FILENAME.yaml
Remplacez les éléments suivants :
KEYSET_NAME
: nom de votre collection de clésFILENAME
: nom du fichier YAML
Dans le fichier de configuration du jeu de clés exporté, ajoutez une ligne
secretVersion
qui inclut une nouvelle version de clé, semblable à celle-ci :name: projects/my-project/locations/global/edgeCacheKeysets/prod-vod-keyset validationSharedKeys: - secretVersion: "projects/PROJECT_NUMBER/secrets/SECRET_ID/versions/KEY_VERSION_2" - secretVersion: "projects/PROJECT_NUMBER/secrets/SECRET_ID/versions/KEY_VERSION_3" - secretVersion: "projects/PROJECT_NUMBER/secrets/SECRET_ID/versions/KEY_VERSION_4"
Importez le jeu de clés modifié. Exécutez la commande
gcloud edge-cache keysets import
:gcloud edge-cache keysets import KEYSET_NAME \ --source=FILENAME.yaml