Ajout d'une configuration de fournisseur DNS dans l'interface utilisateur

Vous pouvez ajouter des configurations de fournisseur DNS à votre instance de service à l'aide de l'interface utilisateur Secrets Manager.

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 page Moteurs de secrets, cliquez sur l'onglet Certificats publics.

4. Dans la table des fournisseurs DNS, cliquez sur Ajouter.

5. Sélectionnez le fournisseur DNS à utiliser.

   Actuellement, vous pouvez ajouter des configurations pour Cloud Internet Services (CIS) et l'infrastructure classique IBM Cloud. Vous pouvez également utiliser votre propre fournisseur de DNS, mais aucune configuration n'est nécessaire dans ce cas.

6. Accordez un accès au service entre Secrets Manager et votre fournisseur DNS sélectionné.

   1. Si vous choisissez CIS, accordez l'accès en sélectionnant une liste d'instances CIS autorisées.

      Vous n'avez pas d'autorisation ? Vous pouvez en créer un dans la console IAM. Vous pouvez accorder l'accès à CIS en fournissant une clé API ou le CRN de l'instance. Vous pouvez trouver le CRN dans la page Présentation de votre instance de service CIS. Si vous préférez utiliser une clé d'API pour CIS, voir Accorder l'accès au service en utilisant une clé d'API. Sinon, fournir le CRN de l'instance après avoir créé l'autorisation.

   2. Si vous choisissez une infrastructure classique, entrez le nom d'utilisateur et la clé d'API associés à votre compte.

   3. Si vous choisissez d'utiliser votre propre fournisseur de DNS, reportez-vous à la documentation de votre fournisseur pour obtenir des instructions. Aucune configuration du fournisseur DNS n'est requise dans Secrets Manager.

7. Cliquez sur Ajouter.

Ajout d'une configuration de fournisseur DNS à partir de l'interface de gestion

Vous pouvez ajouter des configurations de fournisseurs DNS à votre instance de service en utilisant le CLI Secrets Manager. Les fournisseurs DNS manuels ne peuvent être configurés qu'en utilisant l'API.

Pour configurer un moteur de secrets à partir de l'interface CLI de IBM Cloud, exécutez la commande ibmcloud secrets-manager configuration-create commande.

ibmcloud secrets-manager configuration-create {
  "cloud_internet_services_apikey": "MY_APIKEY_WITH_MANAGER_ACCESS_TO_CIS",
  "cloud_internet_services_crn": "MY_CIS_CRN",
  "config_type": "public_cert_configuration_dns_cloud_internet_services",
  "name": "my-cloud-internet-services-config"}'

Si vous choisissez d'utiliser votre propre fournisseur de DNS, reportez-vous à la documentation de votre fournisseur pour obtenir des instructions. Aucune configuration du fournisseur DNS n'est requise dans Secrets Manager. Si vous préférez utiliser une autorisation de service IAM, omettez cloud_internet_services_apikey.

Ajout d'une configuration de fournisseur DNS à l'aide de l'API

Vous pouvez ajouter des configurations de fournisseur DNS à votre instance de service à l'aide de l'API Secrets Manager.

Si vous choisissez d'utiliser votre propre fournisseur de DNS, reportez-vous à la documentation de votre fournisseur pour obtenir des instructions. Aucune configuration du fournisseur DNS n'est requise dans Secrets Manager.

curl -X POST
  --H "Authorization: Bearer {iam_token}" \
  --H "Accept: application/json" \
  --H "Content-Type: application/json" \
  --d '{
    "cloud_internet_services_apikey": "5ipu..",
    "cloud_internet_services_crn": "crn:v1:bluemix:public:internet-svcs:global:a/128e84fcca45c1224aae525d31ef2b52:009a0357-1460-42b4-b903-10580aba7dd8::",
    "config_type": "public_cert_configuration_dns_cloud_internet_services",
    "name": "cloud-internet-services-config"
  }' \
  "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/configurations"

curl -X POST
  --H 'Authorization: Bearer {iam_token}" \
  --H "Accept: application/json" \
  --H "Content-Type: application/json" \
  --d '{
  "classic_infrastructure_password": "sRBm1jkHOH2kn9oBnK5R0ODsRBm1jkHOH2kn9oBnK5R0ODsRBm1jkHOH2kn9oBnK5R0OD",
  "classic_infrastructure_username": "1234567_JohnDoe@mail.com",
  "config_type": "public_cert_configuration_dns_classic_infrastructure",
  "name": "classic-infrastructure-config"
}' \
  "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/configurations"

Ajouter une configuration de fournisseur DNS avec Terraform

Vous pouvez ajouter des configurations de fournisseurs DNS à votre instance de service en utilisant Terraform pour Secrets Manager.

Si vous choisissez d'utiliser votre propre fournisseur de DNS, reportez-vous à la documentation de votre fournisseur pour obtenir des instructions. Aucune configuration du fournisseur DNS n'est requise dans Secrets Manager.

resource "ibm_sm_public_certificate_configuration_dns_cis" "my_dns_cis_config" {
   instance_id = local.instance_id
   region = local.region
   name = "my_DNS_CIS_config"
   cloud_internet_services_apikey = var.my_cis_apikey
   cloud_internet_services_crn = var.my_cis_crn
   }

resource "ibm_sm_public_certificate_configuration_dns_classic_infrastructure" "my_dns_classic_config" {
   instance_id = local.instance_id
   region = local.region
   name = "my_DNS_config"
   classic_infrastructure_password = "username"
   classic_infrastructure_username = "password"
}

Suppression d'une configuration de fournisseur DNS dans l'interface utilisateur

Si vous n'avez plus besoin d'une configuration, vous pouvez la supprimer à l'aide de l'interface utilisateur Secrets Manager.

Une fois la configuration supprimée, plus aucune rotation automatique ne peut être appliquée aux certificats qui sont associés au fournisseur DNS. Ne supprimez pas les configurations qui sont associées aux certificats dans vos applications ou services de production.

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 page Moteurs de secrets, cliquez sur l'onglet Certificats publics.

4. Utilisez le tableau Section des fournisseurs DNS pour afficher les configurations dans votre instance.

5. Dans la ligne dans laquelle se trouve la configuration que vous souhaitez supprimer, cliquez sur le menu, Actions > Supprimer.

6. Entrez le nom de la configuration pour confirmer sa suppression.

7. Cliquez sur Supprimer.

Suppression d'une configuration de fournisseur DNS à l'aide de l'API

Vous pouvez supprimer des configurations en appelant l'API Secrets Manager.

L'exemple suivant présente une requête que vous pouvez utiliser afin de supprimer une configuration de fournisseur DNS de votre instance. Lorsque vous appelez l'API, remplacez {config_name} par le nom de la configuration que vous souhaitez supprimer.

Une fois la configuration supprimée, plus aucune rotation automatique ne peut être appliquée aux certificats qui sont associés au fournisseur DNS. Ne supprimez pas les configurations qui sont associées aux certificats dans vos applications ou services de production.

curl -X DELETE
--H "Authorization: Bearer {iam_token}" \
 "https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/configurations/{name}"

Une réponse ayant abouti supprime la configuration de votre instance de service. Pour plus d'informations sur les paramètres de demande obligatoires et facultatifs, voir Supprimer une configuration.

Récupération de la configuration d'un fournisseur DNS dans l'interface utilisateur

Vous pouvez récupérer la valeur d'un fournisseur DNS en utilisant l'interface utilisateur Secrets Manager.

1. Dans le moteur de secrets des certificats publics, cliquez sur l' du menu Actions dans le tableau des fournisseurs DNS pour ouvrir une liste d'options de configuration de votre moteur.
2. Pour afficher la valeur de la configuration, cliquez sur Afficher la configuration.
3. Cliquez sur Confirmer après vous être assuré que vous êtes dans un environnement sûr.

La valeur secrète est affichée pendant 15 secondes, puis la boîte de dialogue se ferme.

Récupération de la configuration d'un fournisseur DNS à l'aide de la CLI

Vous pouvez récupérer la valeur d'un fournisseur DNS en utilisant le CLI Secrets Manager. Dans l'exemple de commande suivant, remplacez le nom de la configuration du moteur par le nom de votre configuration.

ibmcloud secrets-manager configuration --name EXAMPLE_CONFIG --service-url https://{instance_ID}.{region}.secrets-manager.appdomain.cloud

Remplacez {instance_ID} et {region} par les valeurs qui s'appliquent à votre instance de service Secrets Manager. Pour trouver l'URL de point d'extrémité spécifique à votre instance, vous pouvez la copier à partir de la page Noeuds finaux de l'interface utilisateur Secrets Manager. Pour plus d'informations, voir Affichage de vos URL de point d'extrémité

Récupération de la configuration d'un fournisseur DNS à l'aide de l'API

Vous pouvez récupérer la valeur d'un fournisseur DNS en utilisant l'API Secrets Manager. Dans l'exemple de demande suivant, remplacez le nom de la configuration du moteur par le nom de votre configuration.

curl -X GET --location --header "Authorization: Bearer {iam_token}" \
--header "Accept: application/json" \
"https://{instance_ID}.{region}.secrets-manager.appdomain.cloud/api/v2/configurations/{name}"

Remplacez {instance_ID} et {region} par les valeurs qui s'appliquent à votre instance de service Secrets Manager. Pour trouver l'URL de point d'extrémité spécifique à votre instance, vous pouvez la copier à partir de la page Noeuds finaux de l'interface utilisateur Secrets Manager. Pour plus d'informations, voir Affichage de vos URL de point d'extrémité

Une réponse positive renvoie la valeur de la configuration du moteur, ainsi que d'autres métadonnées. Pour plus d'informations sur les paramètres de demande obligatoires et facultatifs, voir Obtenir un secret.