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:
- El rol de servicio Manager para aprovisionar una instancia y generar un token de administrador.
- El rol de servicio Writer, Reader o Viewer para ver los detalles de la instancia.
Aprovisionar una instancia del plan Vault Dedicated
Crea una instancia de plan Vault Dedicated a partir del catálogo de IBM Cloud.
-
En la consola de IBM Cloud, ve al Catálogo.
-
Selecciona Secrets Manager.
-
Elige el plan Vault Dedicated.
-
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:
- Acceso a la API: Debes crear una puerta de enlace VPE (Virtual Private Endpoint) que apunte a tu instancia de Vault Dedicated. Los puntos de conexión de servicios en la nube (CSE) no son compatibles con este plan. Consulte Uso de puntos de conexión del servicio para conectarse de forma privada a Secrets Manager.
- Acceso a la interfaz de usuario de Vault: debe utilizar una VPN de tipo cliente a sitio que dirija el tráfico a través de la VPE. No se puede acceder a la interfaz de usuario privada de Vault URL desde un navegador fuera de la red privada IBM Cloud sin una VPN. Consulte Uso de una VPN de cliente a sitio para conectarse de forma privada a Secrets Manager.
Si tiene previsto utilizar instancias de los planes
Vault DedicatedyStandard, adopte una convención de nomenclatura que permita identificar fácilmente el tipo de instancia, por ejemplo, incluyendo-standardo-vault dedicateden el nombre de la instancia. -
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
- 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.
- 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.
- 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.
- 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
- 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.
- 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.
- Para configurar los métodos de autenticación para sus equipos y aplicaciones, consulte Configuración de métodos de autenticación.
- Para integrar el producto con tus aplicaciones mediante la API de Vault, la CLI o los SDK, consulta Integración con tus aplicaciones.
- Para consultar las funciones de la API y la CLI de Vault, consulta la descripción general de la referencia de la API y la CLI.