Rotation manuelle des secrets

Rotation des secrets arbitraires

Vous pouvez utiliser l'interface utilisateur Secrets Manager pour la rotation manuelle de vos secrets.

1. Dans la console, cliquez sur l'icône Menu > Liste de ressources.
2. Dans la liste des services, sélectionnez votre instance de Secrets Manager.
3. Dans l'interface utilisateur Secrets Manager, accédez à la liste desSecrets.
4. Dans la ligne dans laquelle se trouve le secret que vous souhaitez pivoter, cliquez sur le menuActions > Rotation.
5. Sélectionnez un nouveau fichier ou entrez une nouvelle valeur de secret.
6. Facultatif: ajoutez des métadonnées à votre secret ou à une version spécifique de votre secret.
   1. Téléchargez un fichier ou entrez les métadonnées et les métadonnées de version au format JSON.
7. Pour faire pivoter le secret immédiatement, cliquez sur Rotation.
8. Facultatif : consultez l'historique des versions pour afficher les dernières mises à jour.

Création de nouvelles versions de secrets clé-valeur

Vous pouvez utiliser l'interface utilisateur Secrets Manager pour la rotation manuelle de vos secrets clé-valeur.

1. Dans la console, cliquez sur l'icône Menu > Liste de ressources.
2. Dans la liste des services, sélectionnez votre instance de Secrets Manager.
3. Dans l'interface utilisateur Secrets Manager, accédez à la liste desSecrets.
4. Dans la ligne dans laquelle se trouve le secret que vous souhaitez pivoter, cliquez sur le menuActions > Rotation.
5. Sélectionnez un fichier ou entrez une nouvelle valeur de secret au format JSON.
6. Facultatif: ajoutez des métadonnées à votre secret ou à une version spécifique de votre secret.
   1. Téléchargez un fichier ou entrez les métadonnées et les métadonnées de version au format JSON.
7. Pour faire pivoter le secret immédiatement, cliquez sur Rotation.
8. Facultatif : consultez l'historique des versions pour afficher les dernières mises à jour.

Création de nouvelles versions des données d'identification de l'utilisateur

Vous pouvez utiliser l'interface utilisateur Secrets Manager pour effectuer une rotation manuelle des valeurs de mot de passe associées à un secret d'utilisateur.

1. Dans la console, cliquez sur l'icône Menu > Liste de ressources.

2. Dans la liste des services, sélectionnez votre instance de Secrets Manager.

3. Dans l'interface utilisateur Secrets Manager, accédez à la liste desSecrets.

4. Dans la ligne dans laquelle se trouve le secret que vous souhaitez pivoter, cliquez sur le menuActions > Rotation.

5. Déterminez si vous souhaitez entrer votre propre mot de passe ou en générer un nouveau.

   Si vous choisissez de générer un nouveau mot de passe, Secrets Manager remplace la valeur existante par un mot de passe de 32 caractères généré aléatoirement, contenant des lettres majuscules, des lettres minuscules, des chiffres et des symboles.

6. Facultatif: ajoutez des métadonnées à votre secret ou à une version spécifique de votre secret.

   1. Téléchargez un fichier ou entrez les métadonnées et les métadonnées de version au format JSON.

7. Pour faire pivoter le secret immédiatement, cliquez sur Rotation.

8. Facultatif : consultez l'historique des versions pour afficher les dernières mises à jour.

Création de nouvelles versions des informations d'identification IAM

Vous pouvez utiliser l'interface utilisateur Secrets Manager pour modifier manuellement les valeurs des mots de passe associés à un secret d'identification IAM.

1. Dans la console, cliquez sur l'icône Menu > Liste de ressources.
2. Dans la liste des services, sélectionnez votre instance de Secrets Manager.
3. Dans l'interface utilisateur Secrets Manager, accédez à la liste desSecrets.
4. Dans la ligne dans laquelle se trouve le secret que vous souhaitez pivoter, cliquez sur le menuActions > Rotation.
5. Facultatif: ajoutez des métadonnées à votre secret ou à une version spécifique de votre secret.
   1. Téléchargez un fichier ou entrez les métadonnées et les métadonnées de version au format JSON.
6. Pour faire pivoter le secret immédiatement, cliquez sur Rotation.
7. Facultatif : consultez l'historique des versions pour afficher les dernières mises à jour.

Création de nouvelles versions des données d'identification du service

Vous pouvez utiliser l'interface utilisateur Secrets Manager pour modifier manuellement les valeurs de mot de passe associées à un secret d'identification de service.

1. Dans la console, cliquez sur l'icône Menu > Liste de ressources.
2. Dans la liste des services, sélectionnez votre instance de Secrets Manager.
3. Dans l'interface utilisateur Secrets Manager, accédez à la liste desSecrets.
4. Dans la ligne dans laquelle se trouve le secret que vous souhaitez pivoter, cliquez sur le menuActions > Rotation.
5. Facultatif: ajoutez des métadonnées à votre secret ou à une version spécifique de votre secret.
   1. Téléchargez un fichier ou entrez les métadonnées et les métadonnées de version au format JSON.
6. Pour faire pivoter le secret immédiatement, cliquez sur Rotation.
7. Facultatif : consultez l'historique des versions pour afficher les dernières mises à jour.

Création de nouvelles versions d'informations d'identification personnalisées

Vous pouvez utiliser l'interface utilisateur Secrets Manager pour modifier manuellement les valeurs de mot de passe associées à un secret d'identification personnalisé.

1. Dans la console, cliquez sur l'icône Menu > Liste de ressources.
2. Dans la liste des services, sélectionnez votre instance de Secrets Manager.
3. Dans l'interface utilisateur Secrets Manager, accédez à la liste desSecrets.
4. Dans la ligne dans laquelle se trouve le secret que vous souhaitez pivoter, cliquez sur le menuActions > Rotation.
5. Facultatif: ajoutez des métadonnées à votre secret ou à une version spécifique de votre secret.
   1. Téléchargez un fichier ou entrez les métadonnées et les métadonnées de version au format JSON.
6. Pour faire pivoter le secret immédiatement, cliquez sur Rotation.
7. Facultatif : consultez l'historique des versions pour afficher les dernières mises à jour.

Création de nouvelles versions de certificats importés

Lorsqu'il est temps de renouveler un certificat initialement importé dans le service, vous pouvez utiliser l'interface utilisateur Secrets Manager pour l'importer manuellement. Une fois la rotation appliquée à un certificat, sa version précédente est conservée au cas où vous en auriez besoin.

Si le certificat concerné a été importé précédemment avec un certificat intermédiaire et une clé privée, incluez ces éléments lors de la rotation pour éviter toute interruption du service.

1. Dans la console, cliquez sur l'icône Menu > Liste de ressources.

2. Dans la liste des services, sélectionnez votre instance de Secrets Manager.

3. Dans l'interface utilisateur Secrets Manager, accédez à la liste desSecrets.

4. Dans la ligne dans laquelle se trouve le certificat que vous voulez pivoter, cliques sur le menuActions > Rotation.

5. Sélectionnez ou entrez les nouvelles données de certificat.

   N'oubliez pas que le contenu du certificat auquel vous appliquez une rotation est remplacé uniquement par les nouvelles données que vous fournissez. Les clés privées et les certificats intermédiaires provenant des versions précédentes ne sont pas conservés.

6. Pour faire pivoter le certificat immédiatement, cliquez sur Rotation.

7. Facultatif : consultez l'historique des versions pour afficher les dernières mises à jour.

8. Redéployez la dernière version de certificat sur votre point de terminaison TLS.

   Pour accéder à la version actuelle, vous pouvez télécharger le certificat ou l'extraire à l'aide d'un programme à l'aide de l'API Obtenir un secret.

Création de nouvelles versions de certificats importés avec une CSR gérée

Vous pouvez utiliser l'interface utilisateur d' Secrets Manager, pour créer la première version du certificat, ou la version suivante lorsqu'il est temps de renouveler le certificat.

1. Dans la console, cliquez sur l'icône Menu > Liste de ressources.
2. Dans la liste des services, sélectionnez votre instance de Secrets Manager.
3. Dans l'interface utilisateur Secrets Manager, accédez à la liste desSecrets.
4. Dans la ligne dans laquelle se trouve le certificat que vous voulez pivoter, cliques sur le menuActions > Rotation.
5. Sélectionnez le fichier de certificat qui a été signé à l'aide de la CSR actuelle ou entrez ses données.
6. Facultatif : Sélectionner le fichier de l'AC intermédiaire de signature ou saisir ses données.
7. Pour faire pivoter le certificat immédiatement, cliquez sur Rotation.
8. Facultatif : consultez l'historique des versions pour afficher les dernières mises à jour.
9. Redéployez la dernière version de certificat sur votre point de terminaison TLS.

Pour accéder à la version actuelle, vous pouvez télécharger le certificat ou le récupérer par programme à l'aide de l'API "Obtenir un secret".

Création de nouvelles versions de certificats privés

Si votre instance de service Secrets Manager est activée pour les Certificats privés, vous pouvez renouveler manuellement un certificat précédemment émis par une autorité de certification configurée pour votre instance de service.

1. Dans la console, cliquez sur l'icône Menu > Liste de ressources.

2. Dans la liste des services, sélectionnez votre instance de Secrets Manager.

3. Dans l'interface utilisateur Secrets Manager, accédez à la liste desSecrets.

4. Dans la ligne dans laquelle se trouve le certificat que vous voulez pivoter, cliques sur le menuActions > Rotation.

5. Facultatif: ajoutez des métadonnées à votre secret ou à une version spécifique de votre secret.

   1. Téléchargez un fichier ou entrez les métadonnées et les métadonnées de version au format JSON.

6. Cliquez sur Rotation.

7. Redéployez la dernière version de certificat sur votre point de terminaison TLS.

   Pour accéder à la version actuelle, vous pouvez télécharger le certificat ou l'extraire à l'aide d'un programme à l'aide de l'API Obtenir un secret.

Création de nouvelles versions de certificats publics

Si votre instance de service Secrets Manager est activée pour les certificats publics, vous pouvez renouveler manuellement un certificat précédemment commandé auprès d'une autorité de certification tierce.

1. Dans la console, cliquez sur l'icône Menu > Liste de ressources.

2. Dans la liste des services, sélectionnez votre instance de Secrets Manager.

3. Dans l'interface utilisateur Secrets Manager, accédez à la liste desSecrets.

4. Dans la ligne dans laquelle se trouve le certificat que vous voulez pivoter, cliques sur le menuActions > Rotation.

5. Facultatif: ajoutez des métadonnées à votre secret ou à une version spécifique de votre secret.

   1. Téléchargez un fichier ou entrez les métadonnées et les métadonnées de version au format JSON.

6. Cliquez sur Rotation.

   Un message de réussite s'affiche pour indiquer que votre commande est en cours de traitement. Si la validation aboutit, un nouveau certificat est émis et le statut du certificat passe de Actif, Rotation en attente à Actif. Dans le cas contraire, le certificat passe à l'état Actif, Rotation failed.

7. Facultatif : vérifiez les détails de l'émission d'un certificat.

   Vous pouvez vérifier les détails de l'émission d'un certificat public en cliquant sur l’icône Actions > Détails. En cas de problème lié à la demande, la zone Statut fournit des informations sur les raisons de l'échec de la rotation.

8. Redéployez la dernière version de certificat sur votre point de terminaison TLS.

   Pour accéder à la version actuelle, vous pouvez télécharger le certificat ou l'extraire à l'aide d'un programme à l'aide de l'API Obtenir un secret.

Création de nouvelles versions de certificats publics avec votre propre fournisseur DNS dans l'interface utilisateur

Pour effectuer une rotation d'un certificat public créé à l'aide d'un fournisseur DNS manuel dans l'interface utilisateur, procédez comme suit.

1. Dans la console, cliquez sur l'icône Menu > Liste de ressources.

2. Dans la liste des services, sélectionnez votre instance de Secrets Manager.

3. Dans la ligne dans laquelle se trouve le certificat que vous voulez pivoter, cliques sur le menuActions > Rotation.

4. Optionnel : Ajoutez un nom et une description pour identifier facilement votre certificat.

5. Facultatif: cliquez sur Mettre à jour.

6. Cliquez sur Défis pour accéder au nom et à la valeur de l'enregistrement TXT qui sont associés à chacun de vos domaines. Vous en avez besoin pour relever les défis.

7. Pour valider la propriété de vos domaines, ajoutez manuellement les enregistrements TXT fournis pour chacun de vos domaines à votre compte de fournisseur DNS. Vous devez traiter uniquement les demandes d'authentification qui ne sont pas validées avant la date d'expiration.

   Si vous commandez un certificat pour des sous-domaines, par exemple sub1.sub2.domain.com, vous devez ajouter les enregistrements TXT à votre domaine enregistré domain.com.

8. Vérifiez que les enregistrements TXT que vous avez ajoutés à vos domaines sont propagés. En fonction de votre fournisseur DNS, cette opération peut prendre un certain temps.

9. Une fois que vous avez confirmé que les enregistrements sont propagés, cliquez sur Valider pour demander Let's Encrypt afin de valider les demandes d'authentification de vos domaines et de créer un certificat public.

   Si la commande échoue, par exemple, si les enregistrements TXT n'ont pas été propagés correctement, vous devez démarrer une nouvelle commande pour continuer.

10. Lorsque votre certificat est émis, nettoyez et supprimez les enregistrements TXT des domaines de votre compte de fournisseur DNS.

Rotation des secrets arbitraires

Pour faire pivoter un secret arbitraire à l'aide du plug-in de l'interface de ligne de commande Secrets Manager, exécutez la commande ibmcloud secrets-manager secret-version-create. Par exemple, la commande suivante permet de faire pivoter un secret et d'en attribuer la nouvelle version à new-secret-data.

ibmcloud secrets-manager secret-version-create \    
   --secret-id=SECRET_ID \    
   --secret-version-prototype='{"payload": "updated secret credentials", "custom_metadata": {"anyKey": "anyValue"}, "version_custom_metadata": {"anyKey": "anyValue"}}'

La commande génère la valeur du secret ainsi que d'autres métadonnées. Pour plus d'informations sur les options de commande, voir ibmcloud secrets-manager secret-version-create.

Rotation des secrets d'identification des services

Pour changer le secret d'identification d'un service à l'aide du plug-in CLI Secrets Manager, exécutez la commande ibmcloud secrets-manager secret-version-create commande. Par exemple, la commande suivante permet de faire pivoter un secret et d'en attribuer la nouvelle version à new-secret-data.

ibmcloud secrets-manager secret-version-create --secret-id SECRET_ID

La commande génère la valeur du secret ainsi que d'autres métadonnées. Pour plus d'informations sur les options de commande, voir ibmcloud secrets-manager secret-version-create.

Rotation des secrets d'identification personnalisés

Pour rooter un secret d'identification personnalisé à l'aide du plug-in CLI Secrets Manager, exécutez la commande ibmcloud secrets-manager secret-version-create commande. Par exemple, la commande suivante permet de faire pivoter un secret et d'en attribuer la nouvelle version à new-secret-data.

ibmcloud secrets-manager secret-version-create --secret-id SECRET_ID

La commande génère la valeur du secret ainsi que d'autres métadonnées. Pour plus d'informations sur les options de commande, voir ibmcloud secrets-manager secret-version-create.

Rotation des données d'identification de l'utilisateur

Pour faire pivoter un secret d'identification utilisateur à l'aide du plug-in de l'interface de ligne de commandeSecrets Manager, exécutez la commande ibmcloud secrets-manager secret-version-create . Par exemple, la commande suivante permet de faire pivoter un secret et d'en attribuer la nouvelle version à new-password.

ibmcloud secrets-manager secret-version-create \    
   --secret-id SECRET_ID \    
   --secret-version-prototype='{"password": "new-password", "custom_metadata": {"anyKey": "anyValue"}, "version_custom_metadata": {"anyKey": "anyValue"}}'

Pour que le service génère et affecte un mot de passe aléatoire à vos données d'identification, omettez la zone password. Par exemple, {}. Secrets Manager remplace la valeur existante par un mot de passe de 32 caractères généré aléatoirement, contenant des lettres majuscules, des lettres minuscules, des chiffres et des symboles.

La commande génère la valeur du secret ainsi que d'autres métadonnées. Pour plus d'informations sur les options de commande, voir ibmcloud secrets-manager secret-version-create.

Rotation des données d'identification IAM

Pour effectuer une rotation d'un secret de données d'identification IAM à l'aide du plug-in d'interface de ligne de commande Secrets Manager, exécutez la commande ibmcloud secrets-manager secret-version-create. Par exemple, la commande suivante crée une nouvelle clé d'API

ibmcloud secrets-manager secret-version-create \    
   --secret-id SECRET_ID

La rotation manuelle des identifiants IAM n'est possible que si l'option Réutiliser les identifiants IAM est activée.

La commande génère la valeur du secret ainsi que d'autres métadonnées. Pour plus d'informations sur les options de commande, voir ibmcloud secrets-manager secret-version-create.

Rotation des certificats importés

Pour rooter un certificat à l'aide du plug-in CLI Secrets Manager, exécutez la commande ibmcloud secrets-manager secret-version-create commande. Par exemple, la commande suivante permet de faire pivoter un secret et d'en attribuer la nouvelle version à new-secret-data.

certificate=$(cat cert.pem)
intermediate=$(cat intermediate.pem)
private_key=$(cat private_key.pem)
ibmcloud secrets-manager secret-version-create --secret-id SECRET_ID --imported-cert-certificate ${certificate} --imported-cert-intermediate ${intermediate} --imported-cert-private-key ${private_key}

La commande génère la valeur du secret ainsi que d'autres métadonnées. Pour plus d'informations sur les options de commande, voir ibmcloud secrets-manager secret-version-create.

Rotation des certificats importés avec gestion de la CSR

Pour réimporter un certificat à l'aide du plug-in Secrets Manager CLI, exécutez la commande ibmcloud secrets-manager secret-version-create commande. Par exemple, la commande suivante permet de faire pivoter un secret et d'en attribuer la nouvelle version à new-secret-data.

Lorsque le secret de certificat importé gère une CSR, le champ « private_key » n'est pas autorisé.

certificate=$(cat cert.pem)
intermediate=$(cat intermediate.pem)
ibmcloud secrets-manager secret-version-create --secret-id SECRET_ID --imported-cert-certificate ${certificate} --imported-cert-intermediate ${intermediate}

La commande génère la valeur du secret ainsi que d'autres métadonnées. Pour plus d'informations sur les options de commande, voir ibmcloud secrets-manager secret-version-create.

Rotation des certificats privés

Pour créer un nouveau secret de certificat privé à l'aide du plug-in CLI d' Secrets Manager, exécutez la ibmcloud secrets-manager secret-version-create commande.

ibmcloud secrets-manager secret-version-create \
   --secret-id SECRET_ID
   --secret-version-prototype '{"csr":"..."}' # Keep empty JSON if not needed

La commande génère la valeur du secret ainsi que d'autres métadonnées. Pour plus d'informations sur les options de commande, voir ibmcloud secrets-manager secret-version-create.

Rotation des certificats publics

Pour commander un nouveau secret de certificat public à l'aide du plug-in d'interface de ligne de commande Secrets Manager, exécutez la commande ibmcloud secrets-manager secret-version-create.

ibmcloud secrets-manager secret-version-create \
   --secret-id SECRET_ID \
   --public-cert-rotation '{"rotate_keys": true|false}'

Lors de la rotation d'un certificat, choisissez si vous souhaitez également effectuer une rotation de sa clé privée pour affecter true ou false à la zone rotate_keys.

La commande génère la valeur du secret ainsi que d'autres métadonnées. Pour plus d'informations sur les options de commande, voir ibmcloud secrets-manager secret-version-create.

Rotation des secrets KV

Pour effectuer une rotation d'un secret KV à l'aide du plug-in d'interface de ligne de commande Secrets Manager, exécutez la commande ibmcloud secrets-manager secret-version-create. Par exemple, la commande suivante permet de faire pivoter un secret et d'en attribuer la nouvelle version à new-secret-data.

ibmcloud secrets-manager secret-version-create \    
   --secret-id=SECRET_ID \    
   --secret-version-prototype='{"data": {"key":"value"}, "custom_metadata": {"anyKey": "anyValue"}, "version_custom_metadata": {"anyKey": "anyValue"}}'

La commande génère la valeur du secret ainsi que d'autres métadonnées. Pour plus d'informations sur les options de commande, voir ibmcloud secrets-manager secret-version-create.

Rotation des secrets arbitraires

Vous pouvez effectuer une rotation des secrets arbitraires en appelant l'API Secrets Manager.

L'exemple de demande suivant crée une nouvelle version de votre secret. Lorsque vous appelez l'API, remplacez les variables d'ID et le jeton IAM par les valeurs spécifiques à votre instance Secrets Manager.

Vous pouvez stocker des métadonnées adaptées aux besoins de votre organisation à l'aide des paramètres de demande custom_metadata et version_custom_metadata. Les valeurs de version_custom_metadata sont renvoyées uniquement pour les versions d'un secret. Les métadonnées personnalisées de votre secret sont stockées comme toutes les autres métadonnées, pour un maximum de 50 versions, et vous ne devez pas inclure de données confidentielles.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
         "custom_metadata": {
            "metadata_custom_key": "metadata_custom_value"
            },
         "payload": "Updated arbitrary data",
         "version_custom_metadata": {
            "custom_version_key": "custom_version_value"
            }
         }' \
      "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Une réponse réussie renvoie la valeur d'ID du secret, ainsi que d'autres métadonnées. Pour plus d'informations sur les paramètres de demande obligatoires et facultatifs, consultez la Référence des API.

Rotation de secrets clé-valeur

Vous pouvez effectuer une rotation des secrets en appelant l'API Secrets Manager.

L'exemple de demande suivant crée une nouvelle version de votre secret. Lorsque vous appelez l'API, remplacez les variables d'ID et le jeton IAM par les valeurs spécifiques à votre instance Secrets Manager.

Vous pouvez stocker des métadonnées adaptées aux besoins de votre organisation à l'aide des paramètres de demande custom_metadata et version_custom_metadata. Les valeurs de version_custom_metadata sont renvoyées uniquement pour les versions d'un secret. Les métadonnées personnalisées de votre secret sont stockées comme toutes les autres métadonnées, pour un maximum de 50 versions, et vous ne devez pas inclure de données confidentielles.

curl -X POST \
   -H "Authorization: Bearer ${iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
      "custom_metadata": {
         "metadata_custom_key": "metadata_custom_value"
         },
      "data": {
            "key1": "val2"
         },
      "version_custom_metadata": {
         "custom_version_key": "custom_version_value"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Une réponse réussie renvoie la valeur d'ID du secret, ainsi que d'autres métadonnées. Pour plus d'informations sur les paramètres de demande obligatoires et facultatifs, consultez la Référence des API.

Rotation des données d'identification de l'utilisateur

Vous pouvez effectuer une rotation des secrets en appelant l'API Secrets Manager.

L'exemple de demande suivant crée une nouvelle version de votre secret. Lorsque vous appelez l'API, remplacez les variables d'ID et le jeton IAM par les valeurs spécifiques à votre instance Secrets Manager.

Vous pouvez stocker des métadonnées adaptées aux besoins de votre organisation à l'aide des paramètres de demande custom_metadata et version_custom_metadata. Les valeurs de version_custom_metadata sont renvoyées uniquement pour les versions d'un secret. Les métadonnées personnalisées de votre secret sont stockées comme toutes les autres métadonnées, pour un maximum de 50 versions, et vous ne devez pas inclure de données confidentielles.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
      "custom_metadata": {
         "metadata_custom_key": "metadata_custom_value"
         },
      "password": "new-password",
      "version_custom_metadata": {
         "custom_version_key": "custom_version_value"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Pour que le service génère et affecte un mot de passe aléatoire à vos données d'identification, omettez la zone password. Par exemple, {}. Secrets Manager remplace la valeur existante par un mot de passe de 32 caractères généré aléatoirement, contenant des lettres majuscules, des lettres minuscules, des chiffres et des symboles.

Une réponse réussie renvoie la valeur d'ID du secret, ainsi que d'autres métadonnées. Pour plus d'informations sur les paramètres de demande obligatoires et facultatifs, consultez la Référence des API.

Rotation des données d'identification IAM

Vous pouvez effectuer une rotation des secrets en appelant l'API Secrets Manager.

L'exemple de demande suivant crée une nouvelle version de votre secret. Lorsque vous appelez l'API, remplacez les variables d'ID et le jeton IAM par les valeurs spécifiques à votre instance Secrets Manager.

Vous pouvez stocker des métadonnées adaptées aux besoins de votre organisation à l'aide des paramètres de demande custom_metadata et version_custom_metadata. Les valeurs de version_custom_metadata sont renvoyées uniquement pour les versions d'un secret. Les métadonnées personnalisées de votre secret sont stockées comme toutes les autres métadonnées, pour un maximum de 50 versions, et vous ne devez pas inclure de données confidentielles.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
      "custom_metadata": {
         "metadata_custom_key": "metadata_custom_value"
         },
      "version_custom_metadata": {
         "custom_version_key": "custom_version_value"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Une réponse réussie renvoie la valeur d'ID du secret, ainsi que d'autres métadonnées. Pour plus d'informations sur les paramètres de demande obligatoires et facultatifs, consultez la Référence des API.

Données d'identification du service tournant

Vous pouvez effectuer une rotation des secrets en appelant l'API Secrets Manager.

L'exemple de demande suivant crée une nouvelle version de votre secret. Lorsque vous appelez l'API, remplacez les variables d'ID et le jeton IAM par les valeurs spécifiques à votre instance Secrets Manager.

Vous pouvez stocker des métadonnées adaptées aux besoins de votre organisation à l'aide des paramètres de demande custom_metadata et version_custom_metadata. Les valeurs de version_custom_metadata sont renvoyées uniquement pour les versions d'un secret. Les métadonnées personnalisées de votre secret sont stockées comme toutes les autres métadonnées, pour un maximum de 50 versions, et vous ne devez pas inclure de données confidentielles.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
      "custom_metadata": {
         "metadata_custom_key": "metadata_custom_value"
         },
      "version_custom_metadata": {
         "custom_version_key": "custom_version_value"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Une réponse réussie renvoie la valeur d'ID du secret, ainsi que d'autres métadonnées. Pour plus d'informations sur les paramètres de demande obligatoires et facultatifs, consultez la Référence des API.

Rotation des lettres de créance personnalisées

Vous pouvez effectuer une rotation des secrets en appelant l'API Secrets Manager.

L'exemple de demande suivant crée une nouvelle version de votre secret. Lorsque vous appelez l'API, remplacez les variables d'ID et le jeton IAM par les valeurs spécifiques à votre instance Secrets Manager.

Vous pouvez stocker des métadonnées adaptées aux besoins de votre organisation à l'aide des paramètres de demande custom_metadata et version_custom_metadata. Les valeurs de version_custom_metadata sont renvoyées uniquement pour les versions d'un secret. Les métadonnées personnalisées de votre secret sont stockées comme toutes les autres métadonnées, pour un maximum de 50 versions, et vous ne devez pas inclure de données confidentielles.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
      "custom_metadata": {
         "metadata_custom_key": "metadata_custom_value"
         },
      "version_custom_metadata": {
         "custom_version_key": "custom_version_value"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Une réponse réussie renvoie la valeur d'ID du secret, ainsi que d'autres métadonnées. Pour plus d'informations sur les paramètres de demande obligatoires et facultatifs, consultez la Référence des API.

Rotation des certificats importés

Vous pouvez effectuer une rotation des secrets en appelant l'API Secrets Manager.

L'exemple de demande suivant crée une nouvelle version de votre secret. Lorsque vous appelez l'API, remplacez les variables d'ID et le jeton IAM par les valeurs spécifiques à votre instance Secrets Manager.

Vous pouvez stocker des métadonnées adaptées aux besoins de votre organisation à l'aide des paramètres de demande custom_metadata et version_custom_metadata. Les valeurs de version_custom_metadata sont renvoyées uniquement pour les versions d'un secret. Les métadonnées personnalisées de votre secret sont stockées comme toutes les autres métadonnées, pour un maximum de 50 versions, et vous ne devez pas inclure de données confidentielles.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
         "certificate": "-----BEGIN CERTIFICATE-----\nMIIE3jCCBGSgAwIBAgIUZfTbf3adn87l5J2Q2Aw+6Vk/qhowCgYIKoZIzj0EAwIwx\n-----END CERTIFICATE-----", "custom_metadata": {
            "metadata_custom_key": "metadata_custom_value"
         },
         "intermediate": "-----BEGIN CERTIFICATE-----\nMIIE3DCCBGKgAwIBAgIUKncnp6BdSUKAFGBcP4YVp/gTb7gwCgYIKoZIzj0EAwIw\n-----END CERTIFICATE-----",
         "private_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQEAqcRbzV1wp0nVrPtEpMtnWMO6Js1q3rhREZluKZfu0Q8SY4H3\n-----END RSA PRIVATE KEY-----", "version_custom_metadata": {
            "custom_version_key": "custom_version_value"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Remplacez les nouvelles lignes dans les données de certificat, de clé intermédiaire et de clé privée par \n.

Une réponse réussie renvoie la valeur d'ID du secret, ainsi que d'autres métadonnées. Pour plus d'informations sur les paramètres de demande obligatoires et facultatifs, consultez la Référence des API.

Rotation des certificats importés avec gestion de la CSR

Vous pouvez effectuer une rotation des secrets en appelant l'API Secrets Manager.
L'exemple de demande suivant crée une nouvelle version de votre secret. Lorsque vous appelez l'API, remplacez les variables d'ID et le jeton IAM par les valeurs spécifiques à votre instance Secrets Manager.

Lorsque le secret de certificat importé gère une CSR, le champ « private_key » n'est pas autorisé.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
         "certificate": "-----BEGIN CERTIFICATE-----\nMIIE3jCCBGSgAwIBAgIUZfTbf3adn87l5J2Q2Aw+6Vk/qhowCgYIKoZIzj0EAwIwx\n-----END CERTIFICATE-----",
         "intermediate": "-----BEGIN CERTIFICATE-----\nMIIE3DCCBGKgAwIBAgIUKncnp6BdSUKAFGBcP4YVp/gTb7gwCgYIKoZIzj0EAwIw\n-----END CERTIFICATE-----"
         }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Une réponse réussie renvoie la valeur d'ID du secret, ainsi que d'autres métadonnées. Pour plus d'informations sur les paramètres de demande obligatoires et facultatifs, consultez la Référence des API.

Rotation des certificats publics

Vous pouvez effectuer une rotation des secrets en appelant l'API Secrets Manager.

L'exemple de demande suivant crée une nouvelle version de votre secret. Lorsque vous appelez l'API, remplacez les variables d'ID et le jeton IAM par les valeurs spécifiques à votre instance Secrets Manager.

Vous pouvez stocker des métadonnées adaptées aux besoins de votre organisation à l'aide des paramètres de demande custom_metadata et version_custom_metadata. Les valeurs de version_custom_metadata sont renvoyées uniquement pour les versions d'un secret. Les métadonnées personnalisées de votre secret sont stockées comme toutes les autres métadonnées, pour un maximum de 50 versions, et vous ne devez pas inclure de données confidentielles.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
        "rotation": {
          "rotate_keys": true # or false
        },
        "version_custom_metadata": {
            "custom_version_key": "custom_version_value"
        }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Remplacez les nouvelles lignes dans les données de certificat, de clé intermédiaire et de clé privée par \n.

Une réponse réussie renvoie la valeur d'ID du secret, ainsi que d'autres métadonnées. Pour plus d'informations sur les paramètres de demande obligatoires et facultatifs, consultez la Référence des API.

Rotation des certificats privés

Vous pouvez effectuer une rotation des secrets en appelant l'API Secrets Manager.

L'exemple de demande suivant crée une nouvelle version de votre secret. Lorsque vous appelez l'API, remplacez les variables d'ID et le jeton IAM par les valeurs spécifiques à votre instance Secrets Manager.

Vous pouvez stocker des métadonnées adaptées aux besoins de votre organisation à l'aide des paramètres de demande custom_metadata et version_custom_metadata. Les valeurs de version_custom_metadata sont renvoyées uniquement pour les versions d'un secret. Les métadonnées personnalisées de votre secret sont stockées comme toutes les autres métadonnées, pour un maximum de 50 versions, et vous ne devez pas inclure de données confidentielles.

curl -X POST \
   -H "Authorization: Bearer {iam_token}" \
   -H "Accept: application/json" \
   -H "Content-Type: application/json" \
   -d '{
        "csr": '{}' # Keep empty if not required
        "version_custom_metadata": {
            "custom_version_key": "custom_version_value"
        }
      }' \
   "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/secrets/{id}/versions"

Remplacez les nouvelles lignes dans les données de certificat, de clé intermédiaire et de clé privée par \n.

Une réponse réussie renvoie la valeur d'ID du secret, ainsi que d'autres métadonnées. Pour plus d'informations sur les paramètres de demande obligatoires et facultatifs, consultez la Référence des API.

Rotation des secrets arbitraires

Vous pouvez effectuer une rotation des secrets arbitraires à l'aide de Terraform pour Secrets Manager.

Pour effectuer une rotation d'un secret arbitraire, modifiez la valeur de l'attribut payload dans votre configuration de ressource ibm_sm_arbitrary_secret et exécutez terraform apply pour appliquer la modification. Si vous utilisez une variable d'entrée pour le contenu, modifiez sa valeur dans le fichier variables.tf.

Vous pouvez également modifier d'autres attributs du secret arbitraire en même temps, y compris des attributs de métadonnées tels que description, custom_metadata ou version_custom_metadata.

Rotation de secrets clé-valeur

Pour effectuer la rotation d'un secret clé-valeur à l'aide de Terraform pour Secrets Manager, modifiez la valeur de l'attribut data dans votre configuration de ressource ibm_sm_kv_secret et exécutez terraform apply pour appliquer la modification. Si vous utilisez une variable d'entrée pour le contenu, modifiez sa valeur dans le fichier variables.tf.

Vous pouvez également modifier d'autres attributs du secret clé-valeur en même temps, notamment des attributs de métadonnées tels que description, custom_metadata ou version_custom_metadata.

Rotation des certificats importés

Vous pouvez effectuer une rotation des certificats importés à l'aide de Terraform pour Secrets Manager.

Pour effectuer une rotation d'un certificat importé, modifiez les valeurs des attributs certificate, intermediate (facultatif) et private_key (facultatif) dans votre configuration de ressource ibm_sm_imported_certificate, puis exécutez terraform apply pour appliquer la modification.

Vous pouvez également modifier d'autres attributs du certificat importé en même temps, notamment des attributs de métadonnées tels que description, custom_metadata ou version_custom_metadata.

Mettez en œuvre des politiques de rotation des secrets avec les modules Terraform IBM (TIM) pour Secrets Manager Secret pour une gestion automatisée du cycle de vie. Reportez-vous à Terraform IBM Modules.