Configuración de su instancia de Vault Dedicated

En este tutorial, aprenderás a configurar una instancia del plan Vault Dedicated IBM Cloud® Secrets Manager mediante el aprovisionamiento de la instancia, la obtención de sus puntos finales, la generación de un token de administrador y el inicio de sesión en la interfaz de usuario de Vault para la configuración inicial.

El plan Vault Dedicated ofrece Vault Enterprise como servicio gestionado en IBM Cloud. Una vez que se haya aprovisionado su instancia, puede utilizar el panel de control de la instancia para consultar los detalles de conexión y abrir la interfaz de usuario de Vault para comenzar a configurar su entorno de Vault.

El plan Vault Dedicated está disponible actualmente en versión beta pública. Las funciones en fase beta se ofrecen con fines de evaluación y prueba, y presentan limitaciones en comparación con las funciones disponibles de forma generalizada.

Limitaciones de la versión beta pública dedicada de Vault

Durante el periodo de beta pública, el plan Vault Dedicated presenta las siguientes restricciones temporales:

  • Límite de instancias: solo una instancia de Vault Dedicated por cuenta durante la fase beta.
  • No hay ruta de actualización: no se puede pasar de la versión beta a la versión GA. Todas las instancias beta se eliminarán antes de la disponibilidad general.
  • Disponibilidad regional: Disponible en Dallas y Fráncfort.
  • Gratis durante la fase beta: no se aplican cargos durante el periodo beta.
  • Migración de la versión beta a la versión general (GA): No se admite la migración de datos de instancias beta a instancias GA.

Estas limitaciones son temporales y solo se aplican durante el periodo de beta pública. Se eliminará o modificará cuando el plan Vault Dedicated alcance la disponibilidad general.

Antes de empezar

Antes de empezar, asegúrate de que dispones de una cuenta de IBM Cloud y del acceso IAM necesario para utilizar el servicio.

Necesitas los siguientes roles:

Aprovisionar una instancia del plan Vault Dedicated

Crea una instancia de plan Vault Dedicated a partir del catálogo de IBM Cloud.

  1. En la consola de IBM Cloud, ve al Catálogo.

  2. Selecciona Secrets Manager.

  3. Elige el plan Vault Dedicated.

  4. Configurar la instancia:

    • Selecciona una región de implementación.
    • Introduce un nombre de instancia único.
    • Seleccione un grupo de recursos.
    • Elige entre el cifrado gestionado por el servicio o el cifrado gestionado por el cliente mediante Key Protect.
    • Seleccione puntos de conexión exclusivamente privados o active un punto de conexión público si es necesario.

    Si seleccionas puntos de conexión exclusivamente privados, ten en cuenta los siguientes requisitos antes de intentar conectarte:

    Si tiene previsto utilizar instancias de los planes Vault Dedicated y Standard, adopte una convención de nomenclatura que permita identificar fácilmente el tipo de instancia, por ejemplo, incluyendo -standard o -vault dedicated en el nombre de la instancia.

  5. Pulse Crear.

El aprovisionamiento suele completarse en unos minutos, pero puede tardar hasta 15 minutos.

Para obtener más información sobre cómo aprovisionar una instancia, consulta Creación de una instancia.

Generar un token de administrador

Para acceder a la interfaz de usuario de Vault y realizar la configuración inicial, genera un token de administrador.

Los tokens de administrador están destinados exclusivamente a la configuración inicial y al acceso de emergencia. Revócalos tan pronto como hayas completado las tareas de configuración.

Generación de un token de administrador en la interfaz de usuario

  1. En el panel de control de tu instancia de Secrets Manager, haz clic en Crear token en la sección Crear un nuevo token de administrador.
  2. Copia el token de administrador generado y guárdalo en un lugar seguro. Necesitarás este token para iniciar sesión en la interfaz de usuario de Vault.

Generación de un token de administrador desde la CLI

Para generar un nuevo token de administrador de Vault mediante la CLI de IBM Cloud, ejecuta el siguiente comando.

ibmcloud secrets-manager-instance-management admin-token-create --id {instance_id}

El comando devuelve el token de administrador de Vault. Guárdalo en un lugar seguro: necesitarás este token para iniciar sesión en la interfaz de usuario de Vault.

Generación de un token de administrador con la API

curl -X POST \
  -H "Authorization: Bearer {iam_token}" \
  -H "Accept: application/json" \
  "https://{region}.secrets-manager.cloud.ibm.com/v2/instances/{id}/admintokens"

Una solicitud correcta devuelve un HTTP201 Created. La respuesta contiene un único token campo: guárdalo de forma segura y utilízalo para iniciar sesión en la interfaz de usuario de Vault. El token tiene una validez de 1 hora.

Cómo generar un token de administrador con Terraform

Para generar un token de administrador de Vault con Terraform, utiliza el recurso ibm_sm_admin_token. El token tiene una validez de 1 hora y se actualiza automáticamente cuando está a punto de caducar.

resource "ibm_sm_admin_token" "sm_admin_token" {
  instance_id = "bfc50c2e-d66d-4f37-9ccf-9713f8325b39"
}

Una vez creado el recurso, el token de administrador de Vault está disponible en el atributo token.

Abrir la interfaz de usuario de Vault

Utilice el punto de conexión de la API de Vault para abrir la interfaz de usuario de Vault e iniciar sesión con el token de administrador.

  1. En el panel de control de la instancia de Secrets Manager, haz clic en Iniciar interfaz de usuario web para acceder a la interfaz de usuario nativa de Vault.
  2. En la página de inicio de sesión de Vault, utiliza el token de administrador que has creado y completa la configuración inicial de Vault.

Revocar el token de administrador

Una vez finalizada la configuración inicial, revoca cualquier token de administrador activo para ayudar a reducir el riesgo de accesos no deseados.

Revocación de tokens de administrador en la interfaz de usuario

  1. En el panel de control de tu instancia de Secrets Manager, haz clic en Revocar en la sección Revocar todos los tokens de administrador.
  2. Confirma la revocación cuando se te solicite.

La revocación del token lo invalida inmediatamente y ayuda a reducir el riesgo de accesos no deseados.

Revocación de tokens de administrador desde la CLI

Para revocar todos los tokens de administrador de Vault activos mediante la CLI de IBM Cloud, ejecuta el siguiente comando.

ibmcloud secrets-manager-instance-management admin-tokens-delete --id {instance_id}

Esta operación invalida inmediatamente todos los tokens de administrador, por lo que será necesario generar nuevos tokens para el acceso administrativo futuro.

Revocación de tokens de administrador mediante la API

curl -X DELETE \
  -H "Authorization: Bearer {iam_token}" \
  "https://{region}.secrets-manager.cloud.ibm.com/v2/instances/{id}/admintokens"

Una revocación correcta devuelve un código de estado 204 No Content.

Próximos pasos

Una vez que haya iniciado sesión en Vault, podrá continuar con la configuración inicial de su instancia.