Création d'une instance Secrets Manager dans l'interface utilisateur

Pour créer une instance de Secrets Manager à partir de la console IBM Cloud, procédez comme suit.

1. Dans la console, accédez à la page de détails de l'offre « Secrets Manager ».

2. Dans l'onglet Créer, sélectionnez la région qui représente la zone géographique dans laquelle vous souhaitez fournir votre instance.

3. Consultez et sélectionnez un plan de tarification.

   Vous ne pouvez créer qu'une seule instance d'essai d' Secrets Manager par compte. Avant de créer une nouvelle instance d'essai, vous devez supprimer l'instance d'essai existante et sa récupération.

4. Indiquez un nom pour votre instance.

5. Sélectionnez un groupe de ressources.

6. Facultatif : Ajoutez des étiquettes pour faciliter l'organisation de l'instance dans votre compte.

7. Choisissez une option pour activer le chiffrement géré par le client pour votre instance.

   Vous pouvez améliorer la sécurité de vos secrets au repos en les intégrant à un service de gestion des clés. Pour plus d'informations sur le chiffrement géré par le client, consultez Protection de vos données sensibles dans Secrets Manager.

   Vous pouvez également utiliser le module Key Management Services All-Inclusive pour rationaliser la gestion des clés. Pour en savoir plus, consultez les modules Terraform IBM.

8. Déterminez une option pour la connexion à Secrets Manager. Par défaut, les instances de Secrets Manager sont créées avec un seul point d'accès privé.

   Sélectionnez soit private-only soit public-and-private. Pour plus d'informations sur la configuration de votre compte en vue de la prise en charge de l'option de connectivité privée, voir Activation de VRF et des noeuds finaux de service.

9. Cliquez sur Créer pour créer une instance de Secrets Manager dans le compte, la région et le groupe de ressources que vous avez sélectionnés.

   Pour mettre à jour votre plan de service après avoir créé une instance, voir Mise à jour de votre plan de service.

Création d'une instance Secrets Manager à partir de l'interface de ligne de commande

Pour créer une instance d' Secrets Manager à l'aide de l'interface de ligne de commande (CLI) d' IBM Cloud, procédez comme suit.

1. Connectez-vous à IBM Cloud via l'interface de ligne de commande(CLI)de IBM Cloud.

   ibmcloud login
   

   Si la connexion échoue, exécutez la commande ibmcloud login --sso pour réessayer. Le paramètre --sso est requis lorsque vous vous connectez avec un ID fédéré. Si cette option est utilisée, allez sur le lien répertorié dans la sortie d'interface de ligne de commande pour générer un code d'accès unique.

2. Sélectionnez le compte, la région et le groupe de ressources dans lesquels vous souhaitez créer une instance de service Secrets Manager.

   ibmcloud target -r REGION_NAME -g RESOURCE_GROUP_NAME
   

3. Créez une instance de Secrets Manager dans ce compte et dans ce groupe de ressources.

   ibmcloud resource service-instance-create INSTANCE_NAME secrets-manager PLAN REGION_NAME [OPTIONS]
   

   Description des informations requises pour provisionner le service Secrets Manager à l'aide de l'interface de gestion

   Variable	Description
   Nom d'instance (instance_name)	Un alias unique pour votre instance de service.
   Région (region)	Région dans laquelle l'instance doit être mise à disposition. Régions prises en charge.
   Plan de tarification (plan)	Le plan tarifaire que vous souhaitez utiliser. Rendez-vous sur trial ou standard.
   Points finaux (options)	Optionnel. Par défaut, les instances de Secrets Manager sont créées avec un seul point d'accès privé (private-only). Si vous devez provisionner une instance de Secrets Manager qui utilise également un point de terminaison public, ajoutez l'option --service-endpoints public-and-private à votre commande.
   Chiffrement (options)	Pour mettre à disposition une instance de Secrets Manager qui utilise le chiffrement géré par le client, ajoutez -p '{"kms_key": "<root_key_crn>"}'. Remplacez <root_key_crn> par la valeur CRN de la clé racine que vous souhaitez intégrer.

   Vous ne pouvez créer qu'une seule instance d'essai d' Secrets Manager par compte. Avant de créer une nouvelle instance d'essai, vous devez supprimer l'instance d'essai existante et sa récupération.

   Pour mettre à jour votre plan de service après avoir créé une instance, voir Mise à jour de votre plan de service.

Création d'une instance Secrets Manager à partir de l'API

Pour créer une instance d' Secrets Manager via l'API, procédez comme suit.

Pour la prise en charge d'autres langages de programmation, voir la documentation sur les API de contrôleur de ressources.

1. Procurez-vous un jeton d'accès IBM Cloud IAM.

2. Exécutez une commande curl pour mettre à disposition une instance de Secrets Manager.

   curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances -H "Authorization: Bearer <IAM token>" -H 'Content-Type: application/json' -d '{
      "name": "<instance_name>",
      "target": "<region>",
      "resource_group": "<resource_group_id>",
      "resource_plan_id": "<plan>",
      "parameters": {"service-endpoints": "public-and-private","kms_key": "<root_key_crn>"}
   }'
   

   Description des informations requises pour fournir le service Secrets Manager à l'aide de l'API

   Variable	Description
   Nom d'instance (name)	Un alias unique pour votre instance de service.
   Target (region)	Région dans laquelle l'instance doit être mise à disposition. Régions prises en charge.
   Plan de tarification (plan)	Le plan de tarification que vous souhaitez utiliser, fourni sous la forme d'un ID de plan. Utilisez 869c191a-3c2a-4faf-98be-18d48f95ba1f pour trial ou 7713c3a8-3be8-4a9a-81bb-ee822fcaac3d pour standard.
   Noeuds finaux	Par défaut, les instances de Secrets Manager sont créées avec uniquement un point de terminaison privé. Si vous devez provisionner une instance qui Secrets Manager utilise également un point de terminaison public, ajoutez "service-endpoints":"public-and-private" à parameters.
   Chiffrement	Pour mettre à disposition une instance de Secrets Manager qui utilise le chiffrement géré par le client, conservez le paramètre kms_key et remplacez <root_key_crn> par la valeur CRN de la clé racine que vous souhaitez intégrer.

   Vous ne pouvez créer qu'une seule instance d'essai d' Secrets Manager par compte. Avant de créer une nouvelle instance d'essai, vous devez supprimer l'instance d'essai existante et sa récupération.

   Pour mettre à jour votre plan de service après avoir créé une instance, voir Mise à jour de votre plan de service.

Création d'une instance Secrets Manager à l'aide de Terraform

Pour créer une instance de Secrets Manager à l'aide de Terraform, incluez les paramètres suivants dans votre ressource ibm_resource_instance pour Secrets Manager.

• service: secrets-manager
• plan: soit Standard, soit Trial. En savoir plus sur les plans de service
• service_endpoints: Soit private ou public-and-private. Si ce paramètre n'est pas spécifié, la valeur par défaut est private Pour personnaliser davantage le site, ajoutez les éléments suivants dans le fichier « parameters ».
• kms_key: Clé racine CRN de Key Protect. Si elle n'est pas incluse, la clé par défaut est la clé racine gérée par Secrets Manager

Voici à quoi pourrait ressembler une ressource type.

resource "ibm_resource_instance" "sm_instance" {
  name              = "demo-sm-instance"
  service           = "secrets-manager"
  plan              = "standard"
  location          = "us-south"
  service_endpoints = "public-and-private"
}

Vous pouvez également utiliser la fonction IBM Cloud® Secrets Manager pour provisionner et configurer les instances Secrets Manager en tant que code. Pour plus d'informations sur les modules Terraform IBM, voir À propos des modules Terraform IBM.