Glosario

bioProve — la palabra de kovra para una verificación atendida que autoriza una acción sensible: en una Mac, en la ventana de revisión de kovra (el sensor de Touch ID dentro de ella, o un código y el diálogo de macOS, que acepta la contraseña de su sesión, en una Mac sin Touch ID). Se usa como verbo: “kovra le pide bioProve para confirmarlo”.

Coordenada — la dirección de un secreto, secret:<env>/<component>/<key> (p. ej. secret:dev/db/password). Ver Coordenadas.

Entorno / componente / clave — los tres segmentos de una coordenada: la etapa de despliegue (dev, prod, …), la parte del sistema, y el secreto específico.

Vault — el almacén local y cifrado de los secretos. Uno global más uno por proyecto. Ver El vault.

Master key — la clave de 256 bits que cifra cada entrada del vault; custodiada en el keyring del OS (o derivada en modo passphrase). La raíz de confianza.

Sensibilidad — cuán protector es kovra con un secreto: low, medium, high o inject-only. Ver Niveles de sensibilidad.

Scope — la frontera de capacidad bajo la que opera una sesión (especialmente un agente): qué operaciones, proyectos y entornos puede direccionar. Ver Scope de agente.

Operación — lo que un llamador puede hacer con un valor: leer metadata, inyectar (entregar a través de un proceso), o revelar (devolver el texto plano al llamador).

Reveal — traer un valor en texto plano de vuelta a las manos del llamador. El camino protegido; nunca permitido para inject-only, y nunca a un agente para high/prod.

Inyección — entregar un valor a través de una operación al entorno de un proceso hijo; el valor nunca vuelve al llamador. Ver El contrato de .env.refs.

Literal — una entrada del vault que contiene un valor real (a diferencia de una referencia o una credencial tipada).

Referencia — una entrada del vault que apunta a un valor en un gestor de secretos cloud (azure-kv://, aws-sm://), resuelta en tiempo de ejecución bajo la propia identidad. Ver Referencias cloud.

Fingerprint — un hash BLAKE3 con clave, corto y truncado, del valor de un secreto, mostrado en list para confirmar “¿cambió el valor de este secreto?” sin revelarlo. Solo los valores low/medium fuera de prod tienen uno; los valores high, inject-only y de prod muestran —.

Allowlist — el conjunto de ejecutables revisados en los que puede inyectarse un valor high/prod. Cada entrada fija el contenido del programa (una edición lo saca de la lista), y se rechazan los intérpretes y lanzadores genéricos (sh, python, node, make, …). Independiente del prompt de confirmación.

Comprobación de la clave — keycheck.sec, un valor fijo sellado bajo una subclave de la master key. kovra se niega a leer o sellar con una master key que no la abre, así que una clave del Keychain sustituida se detecta.

Broker — el canal de confirmación de kovra. En una Mac siempre es la ventana de revisión de kovra, con el sensor de Touch ID dentro de ella (el diálogo de macOS se abre solo cuando usted hace clic en la huella, o después de que la ventana muestra un código si la Mac no tiene Touch ID); sin sesión gráfica (p. ej. por SSH) la solicitud va al teléfono vinculado, en la app de aprobación de kovra (kovra Mobile, próximamente), y sin teléfono vinculado se rechaza. El file broker entre procesos de kovra approve existe solo en builds de desarrollo y en plataformas que kovra 0.12.1 no entrega.

.env.refs — el archivo commiteable que mapea nombres de variables de entorno a coordenadas — direcciones, nunca valores.

agent.toml — el archivo en la raíz del vault que da scope al ssh-agent gobernado.

MCP — el Model Context Protocol; cómo kovra expone herramientas gobernadas a agentes de IA. Ver kovra sobre MCP.