Adición de una configuración de proveedor de DNS en la interfaz de usuario

Puede añadir configuraciones de proveedor de DNS a la instancia de servicio utilizando la interfaz de usuario de Secrets Manager.

1. En la consola, pulse el icono Menú > Lista de recursos.

2. En la lista de servicios, seleccione la instancia de Secrets Manager.

3. En la página Motores de secretos, pulse la pestaña Certificados públicos.

4. En la tabla de proveedores de DNS, pulse Añadir.

5. Seleccione el protocolo web que desee utilizar.

   Actualmente, puede añadir configuraciones para Cloud Internet Services (CIS) e infraestructura clásica de IBM Cloud. También puede utilizar su propio proveedor de DNS, pero en este caso no es necesaria ninguna configuración.

6. Otorgue acceso de servicio entre Secrets Manager y el proveedor de DNS seleccionado.

   1. Si elige CIS, conceda acceso seleccionando de una lista de instancias autorizadas CIS.

      ¿Aún no tiene una autorización? Puede crear una en la consola de IAM. Puede conceder acceso a CIS proporcionando una clave de API o el CRN de la instancia. Puede encontrar el CRN en la página Visión general de la instancia de servicio de CIS. Si prefiere utilizar una clave API para CIS, consulte Concesión de acceso a servicios mediante una clave API. En caso contrario, proporcione el CRN de la instancia después de crear la autorización.

   2. Si elige la infraestructura clásica, entre el nombre de usuario y la clave de API que están asociados a su cuenta.

   3. Si decide utilizar su propio proveedor de DNS, consulte la documentación de su proveedor para obtener instrucciones. No es necesario configurar el proveedor de DNS en Secrets Manager.

7. Pulse Añadir.

Añadir una configuración de proveedor DNS desde la CLI

Puede añadir configuraciones de proveedores DNS a su instancia de servicio utilizando la CLI de Secrets Manager. Los proveedores de DNS manuales sólo pueden configurarse mediante la API.

Para configurar un motor de secretos desde la CLI de IBM Cloud, ejecute el comando ibmcloud secrets-manager configuration-create comando.

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 decide utilizar su propio proveedor de DNS, consulte la documentación de su proveedor para obtener instrucciones. No es necesario configurar el proveedor de DNS en Secrets Manager. Si prefiere utilizar una autorización de servicio IAM, omita cloud_internet_services_apikey.

Adición de una configuración de proveedor de DNS con la API

Puede añadir configuraciones de proveedor de DNS a la instancia de servicio utilizando la API de Secrets Manager.

Si decide utilizar su propio proveedor de DNS, consulte la documentación de su proveedor para obtener instrucciones. No es necesario configurar el proveedor de DNS en 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"

Añadir una configuración de proveedor DNS con Terraform

Puede añadir configuraciones de proveedores DNS a su instancia de servicio utilizando Terraform para Secrets Manager.

Si decide utilizar su propio proveedor de DNS, consulte la documentación de su proveedor para obtener instrucciones. No es necesario configurar el proveedor de DNS en 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"
}

Supresión de una configuración de proveedor de DNS en la interfaz de usuario

Si ya no necesita una configuración, puede suprimirla utilizando la interfaz de usuario de Secrets Manager.

Una vez borrada esta configuración, los certificados que estén asociados al proveedor de DNS ya no se podrán renovar automáticamente. No suprima las configuraciones que están asociadas con certificados en sus aplicaciones o servicios de producción.

1. En la consola, pulse el icono Menú > Lista de recursos.

2. En la lista de servicios, seleccione la instancia de Secrets Manager.

3. En la página Motores de secretos, pulse la pestaña Certificados públicos.

4. Utilice la tabla Sección de proveedores de DNS para ver las configuraciones de la instancia.

5. En la fila correspondiente a la configuración que desea suprimir, pulse el menú Acciones > Suprimir.

6. Especifique el nombre de la configuración para confirmar su supresión.

7. Pulse Suprimir.

Supresión de una configuración de proveedor de DNS con la API

Puede suprimir configuraciones llamando a la API de Secrets Manager.

El ejemplo siguiente muestra una consulta que puede utilizar para eliminar una configuración de proveedor de DNS de la instancia. Cuando llame a la API, sustituya {config_name} por el nombre de la configuración que desea suprimir.

Una vez borrada esta configuración, los certificados que estén asociados al proveedor de DNS ya no se podrán renovar automáticamente. No suprima las configuraciones que están asociadas con certificados en sus aplicaciones o servicios de producción.

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

Una respuesta satisfactoria elimina la configuración de la instancia de servicio. Para obtener más información sobre los parámetros de solicitud obligatorios y opcionales, consulte Eliminar una configuración.

Recuperación de la configuración de un proveedor DNS en la interfaz de usuario

Puede recuperar el valor de un proveedor DNS utilizando la interfaz de usuario Secrets Manager.

1. En el motor secreto de certificados públicos, haga clic en el del menú Acciones de la tabla de proveedores de DNS para abrir una lista de opciones para la configuración del motor.
2. Para ver el valor de configuración, haga clic en Ver configuración.
3. Haga clic en Confirmar después de asegurarse de que se encuentra en un entorno seguro.

El valor secreto se muestra durante 15 segundos y, a continuación, se cierra el cuadro de diálogo.

Recuperación de la configuración de un proveedor DNS mediante CLI

Puede recuperar el valor de un proveedor DNS utilizando la CLI Secrets Manager. En el siguiente comando ejemplo, sustituya el nombre de la configuración del motor por el nombre de su configuración.

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

Sustituya {instance_ID} y {region} por los valores que se aplican a la instancia de servicio de Secrets Manager. Para encontrar el URL de punto final específico de la instancia, puede copiarlo de la página Puntos finales en la interfaz de usuario de Secrets Manager. Para obtener más información, consulte Visualización de URL de punto final

Recuperación de la configuración de un proveedor DNS mediante API

Puede recuperar el valor de un proveedor DNS utilizando la API Secrets Manager. En el siguiente ejemplo de solicitud, sustituya el nombre de la configuración del motor por el nombre de su configuración.

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}"

Sustituya {instance_ID} y {region} por los valores que se aplican a la instancia de servicio de Secrets Manager. Para encontrar el URL de punto final específico de la instancia, puede copiarlo de la página Puntos finales en la interfaz de usuario de Secrets Manager. Para obtener más información, consulte Visualización de URL de punto final

Una respuesta correcta devuelve el valor de la configuración del motor, junto con otros metadatos. Para obtener más información sobre los parámetros de solicitud obligatorios y opcionales, consulta Obtener un secreto.