0 Acceso de administrador
La primera vez creas una contraseña; en las siguientes, solo la escribes. Los agentes no cambian: siguen usando su token para leer por nombre.
Comprobando el estado de la bóveda…
Sesión de administrador activa.
1 Enmascarado rápido
Para compartir una referencia sin guardar nada. Todo ocurre en tu navegador.
2 Guardar en la bóveda
Se cifra con AES-256-GCM en el servidor. La UI no vuelve a ver el valor.
3 Entradas guardadas
Solo se muestra la versión enmascarada. El valor completo nunca llega a esta vista. Puedes activar/desactivar (bloquea el reveal del agente) o borrar (elimina también el valor cifrado) cada referencia.
Inicia sesión como administrador y pulsa «Actualizar» para cargar la lista.
4 Para agentes
Un agente/LLM obtiene el valor completo por su nombre usando su propio token, sin verlo en el chat.
- Guarda la credencial arriba y anota su referencia (p. ej.
NVIDIA_API_KEY). - Pásale al agente el token de agente por una variable de entorno, nunca por el prompt ni por el chat.
- El agente llama al endpoint de lectura y recibe el valor en el cuerpo de la respuesta.
/api/reveal/:nombre
Cabecera: X-Agent-Token
Ejemplo con token
# El token vive en una variable de entorno del agente, no en el chat
export MASKVAULT_AGENT_TOKEN="<TU_TOKEN_DE_AGENTE>"
curl -sS \
-H "X-Agent-Token: $MASKVAULT_AGENT_TOKEN" \
http://127.0.0.1:8787/api/reveal/NVIDIA_API_KEY
Respuesta 200:
{"ok":true,"nombre":"NVIDIA_API_KEY","tipo":"apikey","plataforma":"nvidia","valor":"<VALOR_COMPLETO>"}
Desde Node (sin dependencias)
const res = await fetch(
'http://127.0.0.1:8787/api/reveal/NVIDIA_API_KEY',
{ headers: { 'X-Agent-Token': process.env.MASKVAULT_AGENT_TOKEN } }
);
const { valor } = await res.json();
// usa `valor` en memoria; nunca lo imprimas ni lo pegues en un chat
Este es el único endpoint que devuelve el valor. La contraseña de administrador no sirve aquí: la UI y los agentes usan credenciales distintas (contraseña/sesión vs. token de agente).