> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.
# HashiCorp Vault
> Conecta Vault a Iru Compliance con un token de cliente y una política de mínimo privilegio para obtener evidencia de montajes, políticas y configuración de auditoría.
### 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** en **`X-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
```http theme={null}
X-Vault-Token: hvs.xxxxxxxx
```
Los tokens provienen de cualquier **método de autenticación** de Vault (Token, AppRole, LDAP, etc.). El asistente primero almacena **`vault_addr`** (por ejemplo, `https://vault.example.com:8200`) y luego acepta el token.
| Detalle | Valor |
| - | - |
| **Categoría** | Seguridad |
| **Autenticación** | Token de cliente (`X-Vault-Token`) |
Referencias oficiales: [Conceptos de autenticación](https://developer.hashicorp.com/vault/docs/concepts/auth), [API HTTP](https://developer.hashicorp.com/vault/api-docs), [Políticas](https://developer.hashicorp.com/vault/docs/concepts/policies), [AppRole](https://developer.hashicorp.com/vault/docs/auth/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`**.
```hcl lines theme={null}
path "sys/mounts" {
capabilities = ["read", "list"]
}
path "sys/auth" {
capabilities = ["read", "list"]
}
path "sys/policy" {
capabilities = ["read", "list"]
}
path "sys/policies/acl/*" {
capabilities = ["read", "list"]
}
path "sys/audit" {
capabilities = ["read", "list"]
}
path "auth/token/lookup-self" {
capabilities = ["read"]
}
```
### Conectar HashiCorp Vault a Iru
#### Aplicar la política y emitir un token
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`).
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.
Guarda la política de ejemplo anterior como archivo `.hcl` en esa máquina (por ejemplo, `iru-compliance.hcl`).
Ejecuta **`vault policy write iru-compliance`** con la ruta de tu archivo de política.
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.`**.
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
En Iru Compliance, en la barra de navegación izquierda, expande **Cumplimiento** y selecciona **Fuentes**.
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.
Introduce **`vault_addr`** (por ejemplo, `https://vault.example.com:8200`) y confirma las variables del servidor cuando se te solicite.
Pega el token en el campo **`X-Vault-Token`** cuando se te solicite.
Selecciona **Enviar clave de API**. Cuando la conexión se realiza correctamente, el asistente muestra **Conexión configurada**.
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
Revisa la configuración del **bloqueador de ventanas emergentes** para el sitio de Iru e inténtalo de nuevo.
Actualiza el asistente desactivando y activando la fuente; vuelve a introducir **`vault_addr`**.
Asocia la política **`iru-compliance`** al token; revisa los **espacios de nombres de Enterprise**.
Emite un token nuevo y actualiza Iru; habilita la **renovación** o usa la rotación de AppRole.
Revisa el nombre de host, el puerto (**8200**), TLS y las rutas salientes desde Iru.
**Desella** (unseal) Vault antes de probar.
### Consideraciones
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
Explora y gestiona todas las fuentes de Compliance.
Marcos, acciones y **Artefactos**.
Cómo encajan Endpoint, Compliance e Identity.
Sube, revisa y organiza la evidencia de fuentes y acciones.