Saltar al contenido principal

Secretos

Un secreto es un conjunto con nombre de entradas de clave y valor, con la misma forma que usa el motor KV de HashiCorp Vault, en el que una ruta contiene un mapa de claves a valores. Las credenciales que van juntas, como un ID de clave de acceso de AWS y su clave de acceso secreta, se guardan en un solo secreto como dos entradas, y no en dos secretos separados.

Abre Secretos en la barra lateral de administración para gestionarlos. Cada registro tiene un Nombre, una Descripción opcional, sus etiquetas y un tipo.

Dónde se usa un secreto​

  • Servidores MCP: cualquier valor de encabezado o de variable de entorno puede incluir ${secret:name/key}, que se expande al conectar.
  • Skills de agente: la Contraseña de autenticación de una skill es una referencia a una entrada, que se elige en listas desplegables en lugar de escribirse.

Una entrada concreta siempre se indica como name/key. La clave es obligatoria aunque el secreto contenga una sola entrada, porque un nombre solo identifica un mapa, no un valor; por eso, un ${secret:name} sin clave no se resuelve, en lugar de pasarse como una cadena literal.

Los dos tipos​

Local (cifrado)HashiCorp Vault
Qué se almacenaLas propias entradas, con cada valor cifradoSolo una referencia a KV v2: Montaje de Vault y Ruta de Vault
De dónde salen los valoresDel almacén cifradoSe leen directamente de Vault cada vez que se resuelven
Qué muestra la página de detalleTodas las claves almacenadas, con el valor en blancoEl montaje y la ruta
Cómo se edita una entradaDeja el valor en blanco para conservarlo, vuelve a escribirlo para sustituirlo o quita la fila para eliminar la entradaEn Vault

Los valores nunca se devuelven en ninguno de los dos tipos, ni como texto sin cifrar ni como texto cifrado; por eso la página de detalle del tipo local muestra las claves con los valores en blanco. Lo único que se puede leer son las claves, de modo que un selector puede listarlas: en un secreto local proceden del mapa almacenado y en un secreto de Vault se leen de Vault en ese momento.

Un secreto de Vault se lee del Vault de su propio tenant, que el administrador del tenant conecta en Configuración de administrador. Un tenant que no tenga ninguno lee del Vault global con una credencial propia, cuyas políticas de Vault deciden qué puede leer. Sin ninguno de los dos, los secretos de tipo Vault no se pueden resolver. La clave con la que se cifran los secretos locales se configura una sola vez; consulta la referencia de configuración.

Cambiar el nombre y eliminar​

Los secretos se referencian por nombre y se resuelven en el momento de usarlos. Cambiar el nombre de un secreto al que algo sigue haciendo referencia, o eliminarlo, no falla al editar: el que falla es el siguiente uso, que indica el nombre del secreto que no ha encontrado. Una skill de agente cuya referencia ha quedado obsoleta anota el motivo en su propio registro la próxima vez que se actualiza desde el repositorio.

Eso sí, al guardar una referencia se comprueba. Cuando guardas un servidor MCP cuyos encabezados o variables de entorno mencionan un secreto, usas Ejecución de prueba en un script o guardas la Contraseña de autenticación de una skill, el secreto debe existir y debes poder abrirlo. Un secreto que tienes oculto por una etiqueta de control de acceso se rechaza exactamente igual que uno que no existe. Lo mismo ocurre cuando editas un registro que ya hace referencia a un secreto así, aunque solo cambies otro campo.