Acerca de HashiCorp Vault
Iru lee los montajes de motores de secretos, la configuración de métodos de autenticación, las políticas con nombre, los dispositivos de auditoría y los metadatos relacionados de sys/ mediante la API HTTP de Vault. Cada solicitud envía tu token de cliente enX-Vault-Token. Iru recopila evidencia de configuración, no los valores de los secretos en texto sin formato.
Funciona con Vault OSS, Enterprise (los espacios de nombres pueden requerir configuración adicional) y HCP Vault.
Cómo funciona
vault_addr (por ejemplo, https://vault.example.com:8200) y luego acepta el token.
Referencias oficiales: Conceptos de autenticación, API HTTP, Políticas, AppRole.
Requisitos previos
- Un clúster de Vault accesible desde Iru (red, firewall o PrivateLink, según corresponda).
- Permiso para crear una política y un token (o AppRole) con acceso de solo lectura a
sys/como en el ejemplo siguiente.
Ejemplo de política de solo lectura (HCL)
Guárdala como archivo.hcl y aplícala con vault policy write iru-compliance your-file.hcl.
Conectar HashiCorp Vault a Iru
Aplicar la política y emitir un token
1
Prepara una estación de trabajo con acceso a la CLI de Vault
Usa un host de salto o una estación de trabajo de administración que pueda acceder a
VAULT_ADDR mediante TLS y que tenga instalada la CLI de Vault (binario vault).2
Autentica la CLI en Vault
Inicia sesión con el método compatible de tu organización (
vault login, OIDC, etc.) para que los comandos siguientes se ejecuten con privilegios suficientes para escribir políticas y crear tokens.3
Escribe el archivo de política
Guarda la política de ejemplo anterior como archivo
.hcl en esa máquina (por ejemplo, iru-compliance.hcl).4
Aplica la política en Vault
Ejecuta
vault policy write iru-compliance con la ruta de tu archivo de política.5
Crea un token renovable
Crea un token renovable vinculado a esa política (por ejemplo,
vault token create -policy=iru-compliance -ttl=720h -renewable=true). Copia el valor del token hvs..6
Es preferible AppRole en producción
En producción, es preferible usar AppRole u otro flujo automatizado en lugar de tokens estáticos de larga duración.
Completar el conector en Iru
1
Abre Sources
En Iru Compliance, en la barra de navegación izquierda, expande Cumplimiento y selecciona Fuentes.
2
Activa HashiCorp Vault
Busca HashiCorp Vault (usa Categoría o Buscar por nombre o descripción). En esa tarjeta, activa el interruptor. Es posible que se abra una pestaña o ventana del navegador para el asistente del conector.
3
Configura las variables del servidor
Introduce
vault_addr (por ejemplo, https://vault.example.com:8200) y confirma las variables del servidor cuando se te solicite.4
Pega el token de Vault
Pega el token en el campo
X-Vault-Token cuando se te solicite.5
Finaliza la conexión
Selecciona Enviar clave de API. Cuando la conexión se realiza correctamente, el asistente muestra Conexión configurada.
6
Confirma que la fuente está activa
Cierra la pestaña del navegador Iru está solicitando acceso a servicios externos, luego vuelve a Cumplimiento → Fuentes y confirma que la tarjeta de HashiCorp Vault está Activo.
Solución de problemas
No se abre nada al activar la fuente
No se abre nada al activar la fuente
Revisa la configuración del bloqueador de ventanas emergentes para el sitio de Iru e inténtalo de nuevo.
Error en las variables del servidor
Error en las variables del servidor
Actualiza el asistente desactivando y activando la fuente; vuelve a introducir
vault_addr.403 permission denied
403 permission denied
Asocia la política
iru-compliance al token; revisa los espacios de nombres de Enterprise.Token caducado
Token caducado
Emite un token nuevo y actualiza Iru; habilita la renovación o usa la rotación de AppRole.
Conexión rechazada
Conexión rechazada
Revisa el nombre de host, el puerto (8200), TLS y las rutas salientes desde Iru.
503 sealed
503 sealed
Desella (unseal) Vault antes de probar.
Consideraciones
Los espacios de nombres de Vault Enterprise pueden requerir rutas o…
Los espacios de nombres de Vault Enterprise pueden requerir rutas o configuraciones adicionales a esta base: coordínalo con los administradores de Vault.
Artículos relacionados
Gestión de fuentes
Explora y gestiona todas las fuentes de Compliance.
Introducción a Compliance
Marcos, acciones y Artefactos.
Descripción general de Iru
Cómo encajan Endpoint, Compliance e Identity.
Gestión de artefactos
Sube, revisa y organiza la evidencia de fuentes y acciones.