Vous pouvez attribuer des alias aux versions de secret pour y accéder plus facilement. Une fois qu'un alias est attribué, vous pouvez accéder aux versions de secret à l'aide de leur alias de la même manière que vous pouvez y accéder à l'aide de leur numéro de version.
Rôles requis
Pour obtenir les autorisations nécessaires pour attribuer un alias à une version de secret,
demandez à votre administrateur de vous accorder le
rôle IAM Administrateur Secret Manager (roles/secretmanager.admin) sur le secret, le projet, le dossier ou l'organisation.
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.
Attribuer un alias à une version de secret
Pour attribuer un alias à une version de secret, utilisez l'une des méthodes suivantes :
Console
-
Dans la Google Cloud console, accédez à la page Secret Manager.
-
Pour modifier un secret, utilisez l'une des méthodes suivantes :
-
Cliquez sur Actions pour le secret que vous souhaitez modifier, puis cliquez sur Edit (Modifier).
-
Cliquez sur le nom du secret pour accéder à la page d'informations du secret. Sur la page d'informations du secret, cliquez sur Modifier le secret.
-
-
Sur la page Edit secret (Modifier le secret), accédez à Version aliases (Alias de version), puis cliquez sur Add alias (Ajouter un alias).
-
Procédez comme suit :
-
Spécifiez le nom de l'alias.
-
Sélectionnez la version de secret à laquelle vous allez attribuer cet alias.
-
-
Cliquez sur Update secret (Mettre à jour le secret).
gcloud
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
- SECRET_ID : ID du secret.
- KEY : nom de l'alias de la version de secret.
- VALUE : numéro de la version de secret.
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud secrets update SECRET_ID \ --update-version-aliases=KEY=VALUE
Windows (PowerShell)
gcloud secrets update SECRET_ID ` --update-version-aliases=KEY=VALUE
Windows (cmd.exe)
gcloud secrets update SECRET_ID ^ --update-version-aliases=KEY=VALUE
La réponse contient le secret mis à jour.
REST
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT_ID : ID du Google Cloud projet.
- SECRET_ID : ID du secret.
- KEY : nom de l'alias de la version de secret.
- VALUE : numéro de la version de secret.
Méthode HTTP et URL :
PATCH https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID?updateMask=version_aliases
Corps JSON de la requête :
{'version_aliases': {'KEY': 'VALUE'}}
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID?updateMask=version_aliases"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID?updateMask=version_aliases" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{
"name": "projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID",
"createTime": "2024-09-04T06:34:32.995517Z",
"etag": "\"16214584d1479c\"",
"versionAliases": {
"nonprod": "1"
}
}
C#
Pour exécuter ce code, commencez par configurer un environnement de développement C# et installez le SDK Secret Manager pour C#. Sur Compute Engine ou GKE, vous devez vous authentifier avec le champ d'application cloud-platform.
Go
Pour exécuter ce code, commencez par configurer un environnement de développement Go et installez le SDK Secret Manager pour Go. Sur Compute Engine ou GKE, vous devez vous authentifier avec le champ d'application cloud-platform.
Java
Pour exécuter ce code, commencez par configurer un environnement de développement Java et installez le SDK Secret Manager pour Java. Sur Compute Engine ou GKE, vous devez vous authentifier avec le champ d'application cloud-platform.
Node.js
Pour exécuter ce code, commencez par configurer un environnement de développement Node.js, puis installez le SDK Secret Manager pour Node.js. Sur Compute Engine ou GKE, vous devez vous authentifier avec le champ d'application cloud-platform.
PHP
Pour exécuter ce code, commencez par apprendre à utiliser PHP sur Google Cloud et installer le SDK Secret Manager pour PHP. Sur Compute Engine ou GKE, vous devez vous authentifier avec le champ d'application cloud-platform.
Python
Pour exécuter ce code, commencez par configurer un environnement de développement Python et installez le SDK Secret Manager pour Python. Sur Compute Engine ou GKE, vous devez vous authentifier avec le champ d'application cloud-platform.
Ruby
Pour exécuter ce code, commencez par configurer un environnement de développement Ruby et installez le SDK Secret Manager pour Ruby. Sur Compute Engine ou GKE, vous devez vous authentifier avec le champ d'application cloud-platform.
Étape suivante
- Découvrez comment lister les versions de secret et afficher les détails des versions de secret.
- Découvrez comment assurer l'intégrité des données lorsque vous ajoutez des versions de secret et y accédez.