// Engineering Log
Secretos y zero trust: Parte 1 — Modelo de amenazas y principios
Publicado el 16.11.2026 · Autor: Mikhail Gorbachev
// Ruta rápida
Este artículo pertenece al tema Despliegue y estabilidad.
El secreto — cualquier dato que por sí mismo da acceso: contraseña, token de API, clave SSH privada, clave de cifrado, contraseña maestra del gestor de contraseñas. El principal problema con los secretos no es que sean difíciles de almacenar, sino que se copian en distintos lugares: el mismo token aparece en el código, en una variable de CI, en el registro de compilación y en el chat. El enfoque zero trust («confianza cero») responde a esto con una regla simple: el lugar desde el que llega la petición no le otorga derechos. Cada acceso se verifica de nuevo, se concede por tiempo limitado y en la mínima medida necesaria.
En este artículo —sin instalaciones ni comandos— se explica qué se considera secreto, dónde se filtran los secretos, contra qué amenazas hay que protegerse, qué dicen sobre el acceso NIST SP 800-207 y OWASP, y de qué capas se compone un esquema práctico.
Qué se considera secreto
Se considera secreto todo lo que permite pasar la verificación en nombre de otro o leer datos protegidos:
- contraseñas de cuentas, bases de datos, paneles de control, routers;
- tokens de API y claves de nubes, sistemas de pago, proveedores DNS, bots;
- claves SSH privadas y claves de certificados TLS;
- claves de cifrado de discos, copias de seguridad, archivos;
- tokens de registro de runners de CI y cuentas de servicio;
- contraseña maestra del gestor de contraseñas y la clave de su sesión;
- códigos de recuperación de la autenticación de dos factores.
Los dos últimos puntos se olvidan con frecuencia. La clave de sesión del gestor de contraseñas permite, mientras dura la sesión, leer y modificar los datos del almacén igual que tras desbloquearlo. Los códigos de recuperación permiten eludir el segundo factor, por lo que no deben estar junto a la contraseña.
No es secreto —nombre de usuario, dirección del servidor, clave pública. Su filtración facilita la recogida de información, pero no da acceso. Esta distinción es importante: los datos abiertos se pueden mantener en repositorios y documentación, los secretos no. Para repositorios públicos decidid por separado: direcciones de servidores y nombres de cuenta facilitan el reconocimiento.
Dónde viven los secretos y cómo se filtran
Un secreto no se filtra desde el almacén, sino desde los lugares a los que se ha copiado. Lugares típicos:
- Código e historial de Git. Eliminar un secreto en el siguiente commit no arregla nada: la versión antigua del archivo queda en el historial y en todos los clones. El orden de acciones ante tal filtración se analiza en el artículo «Desarrollo seguro: Parte 2 — Secretos en el código».
- Archivos
.env. Convenientes en desarrollo, pero están en disco en texto plano, aparecen en los archivos del proyecto, en copias de seguridad y en imágenes de contenedor si no se excluyen explícitamente. - Variables CI/CD. La variable del proyecto está disponible para los jobs del pipeline, y por tanto para cualquiera que pueda cambiar la configuración del job; las ramas protegidas (protected) reducen este ámbito. La documentación de GitLab advierte directamente que el enmascaramiento de una variable no garantiza protección frente a un atacante: un valor modificado (por ejemplo, con caracteres escapados por el shell) no será enmascarado, y para evitar que
envyprintenvimpriman el secreto recomienda almacenes externos de secretos y variables de tipo File. - Registros. Salida de depuración, traza de error con parámetros de conexión, registro del servidor web con token en la URL. Los registros suelen guardarse más tiempo y estar disponibles a más personas que el almacén de secretos.
- Correspondencia. Una contraseña enviada por mensajería o correo queda en el historial de ambas partes, en sus dispositivos y en las copias de seguridad del servicio.
- Copias de seguridad. La copia de un servidor contiene configs con contraseñas,
.env, claves. Si la copia no está cifrada, su robo equivale al robo de todos esos secretos. - Discos y soportes. Disco dado de baja, tarjeta de memoria de un SBC, portátil olvidado en un taxi. Todo lo que esté en ellos en texto plano se lee sin la contraseña del sistema.
De aquí surge la primera regla práctica: cuantos menos lugares contengan el secreto en texto plano, menos vías de filtración. Cada copia adicional es un lugar más desde donde se puede robar el secreto.
Modelo de amenazas
El modelo de amenazas responde a dos preguntas: quién y por qué medios puede obtener el secreto y qué de esas vías vais a cerrar. Abajo cinco escenarios típicos para una infraestructura pequeña; la lista no es exhaustiva, añadid la vuestra.
Robo del soporte. El atacante obtiene un disco, tarjeta de memoria, portátil o una copia de la imagen de la máquina virtual. Puede leer archivos, pero no controla el sistema en ejecución. Protección: los secretos en disco se guardan solo cifrados, y la clave de descifrado no está en ese mismo disco.
Runner o dependencia comprometida. Un paquete malicioso del registro, una acción CI infectada o un servidor de build hackeado ejecutan código en el mismo entorno donde hay secretos. Ese código ve variables de entorno y archivos del job. Protección: dar al job solo los secretos que necesita y solo durante su ejecución; fijar versiones de dependencias; no ejecutar código no confiable donde haya acceso a secretos de producción.
Filtración de logs. El log de compilación, la salida de depuración de la aplicación o un sistema centralizado de logs se vuelven accesibles a terceros. Protección: no imprimir secretos en absoluto; el enmascaramiento es una medida de mitigación, no una protección completa.
Pull request desde un fork. Un externo propone un cambio que al ejecutar CI ejecuta su código. Si dicho job recibe secretos del repositorio, los obtendrá. GitHub Actions no pasa secretos a workflows iniciados desde forks (excepto GITHUB_TOKEN) y recomienda evitar el evento pull_request_target, en el que el código de la solicitud se ejecuta con acceso a secretos. En Gitea el token del job para peticiones desde forks siempre es de solo lectura, y la ejecución de jobs desde forks de usuarios externos puede requerir aprobación (las reglas dependen de la versión de Gitea).
Ex-empleado o contratista. La persona se va, pero recuerda contraseñas que vio, guarda una copia de .env o exportó el almacén. Deshabilitar su cuenta no revoca las contraseñas compartidas que conocía. Protección: cuentas personales en lugar de compartidas, acceso a secretos compartidos a través de grupos y colecciones que se revocan con una acción, y cambiar todos los secretos compartidos a los que tenía acceso.
Conviene decir aparte de qué no protege este modelo: de root en la máquina donde se usa el secreto, y del proceso del mismo usuario en el momento en que el almacén está abierto. Si el atacante controla la máquina de trabajo mientras se usa, ve lo mismo que vosotros.
Zero trust según NIST SP 800-207
El documento NIST SP 800-207 «Zero Trust Architecture» (agosto de 2020) define zero trust como un conjunto de ideas orientadas a minimizar la incertidumbre al tomar decisiones precisas sobre acceso con privilegios mínimos para cada petición, partiendo de que la red se considera comprometida.
El documento está escrito sobre redes y servicios. Abajo sus siete principios (tenets) se relacionan con el trabajo con secretos: la correspondencia es del autor del artículo y no forma parte del documento.
- Todas las fuentes de datos y servicios de cómputo son recursos. Para los secretos: el gestor de contraseñas, el runner de CI, la estación de trabajo del administrador, el router —cada uno es un recurso con sus reglas de acceso, no una “parte confiable de la infraestructura”.
- Todo el intercambio está protegido independientemente de la ubicación en la red. Estar en la red interna no genera confianza. Para los secretos: el gestor de contraseñas en la red interna sigue funcionando solo por HTTPS, y los secretos no se transmiten en texto plano ni siquiera dentro de una VPN.
- El acceso a cada recurso se otorga por sesión separada con los mínimos privilegios necesarios. Para los secretos: el almacén se abre por sesión y se cierra después del trabajo; el job de CI recibe un token por el tiempo de ejecución y no una clave permanente.
- El acceso se determina por políticas dinámicas que consideran el estado del cliente, la aplicación, el dispositivo, atributos de comportamiento y del entorno. Para los secretos: los secretos de producción solo están disponibles desde ramas y entornos protegidos, la entrada al almacén requiere segundo factor y para el desbloqueo en la estación de trabajo se usa una llave hardware.
- La organización supervisa la integridad y el estado de todos los activos, ninguno se confía por defecto. Para los secretos: los runners y estaciones donde se abre el almacén se actualizan y verifican igual que los servidores, y el estado del runner se tiene en cuenta al emitir secretos; un runner que compila código ajeno no recibe secretos de producción.
- La autenticación y autorización son dinámicas y se aplican estrictamente antes de permitir el acceso. Para los secretos: cada entrada al almacén y cada emisión de token pasan por comprobaciones completas; no se permite el “una vez que entras, ya puedes todo”.
- La organización reúne la mayor cantidad de datos posible sobre el estado de activos, la red y las comunicaciones y los usa para mejorar la protección. Para los secretos: registro de accesos y peticiones a secretos, alertas por intentos fallidos, revisiones periódicas de quién y a qué tiene acceso.
Un breve orientador para la práctica diaria (formulación del autor, no NIST): cinco reglas — acceso por sesión, mínimos privilegios, políticas dinámicas, monitoreo, verificación continua.
Qué recomienda OWASP
OWASP Secrets Management Cheat Sheet describe las mismas ideas a nivel práctico:
- Centralización. La gestión de secretos está reunida en un único sistema y estandarizada; OWASP recomienda llevar un inventario: para qué sirve cada secreto y dónde se almacena.
- Privilegios mínimos. El acceso se da a nivel de objetos individuales, no “a todo el almacén”; es mejor separar los secretos de producción y los de desarrollo en distintos sistemas.
- Secretos dinámicos. Siempre que sea posible los secretos se crean por corto tiempo para una tarea concreta. OWASP señala aparte que reiniciar la aplicación no invalida datos ya robados.
- Rotación. Los secretos se cambian regularmente, preferiblemente de forma automática; OWASP sugiere cambiar contraseñas de cuentas humanas si se sospecha una compromisión.
- Auditoría. Un registro que no se pueda manipular o borrar sin dejar rastro: es útil ver quién solicitó un secreto, cuándo se usó, intentos fallidos de autenticación y cambios.
- Los secretos no están en texto plano. No se pasan a Docker mediante
ENVyARG, no se comitean en el repositorio y antes de commitear se buscan con un escáner.
Las recomendaciones de NIST y OWASP convergen en lo esencial: acceso limitado en tiempo y alcance y con registro; OWASP añade centralización y estandarización de la gestión de secretos.
De qué capas se compone el esquema
El ciclo descompone el esquema para una infraestructura pequeña. En su centro —gestor de contraseñas Vaultwarden— que en este ciclo sirve como almacén de secretos: la parte servidor no oficial compatible con los clientes de Bitwarden, que despliegas tú mismo tras un reverse proxy con HTTPS («Gestores de contraseñas: Parte 3 — Bitwarden y Vaultwarden»). Las entradas se cifran en el cliente, por lo que el servidor almacena el contenido de las entradas cifrado; los metadatos de las cuentas (direcciones de e-mail, composición de organizaciones, parámetros KDF) se guardan en claro. En servidores y scripts que interactúan con el almacén funciona Bitwarden CLI (bw): el secreto se toma en el momento de uso y no se guarda en el script ni en .env; bw mantiene una copia local del almacén cifrado y la clave de sesión mientras está en uso. La llave hardware FIDO2 actúa como segundo factor en el almacén web (en el propio bw el ingreso por FIDO2 no está soportado: allí están disponibles TOTP, e-mail y YubiKey OTP o ingreso por API key). Para el desbloqueo por toque el ciclo analiza su propia implementación y no la función de Bitwarden: la contraseña maestra se guarda en disco cifrada por un secreto-clave. Esa misma clave guarda la parte privada de claves SSH tipo ed25519-sk: sin el dispositivo conectado no se puede firmar la autenticación. La última capa —CI/CD: los secretos de los jobs se emiten según ramas y entornos, y donde la plataforma lo soporta, en lugar de claves permanentes se usan tokens OIDC de corta duración.
| Capa | Qué amenaza cubre | Qué no cubre |
|---|---|---|
| Vaultwarden | dispersión de secretos por archivos y correspondencia; divulgación del contenido de las entradas si se roba la base del servidor, mientras la contraseña maestra sea robusta (la base puede atacarse por fuerza bruta offline); salida de un empleado — el acceso se revoca mediante organización y colecciones | contraseña maestra débil; máquina del usuario infectada con el almacén abierto; secretos dinámicos: a fecha de 12.10.2026 Vaultwarden no soporta Bitwarden Secrets Manager (bws) |
| Bitwarden CLI | secretos en texto plano en scripts y .env; copiado manual de contraseñas | procesos del mismo usuario o root mientras la sesión está abierta: la clave de sesión da acceso al almacén |
| Llave hardware FIDO2 | almacenamiento de la contraseña maestra en disco en texto plano; robo del soporte si sin la llave la contraseña maestra no se puede descifrar | persona que tenga tanto la máquina como la llave, si el toque no exige PIN; pérdida de la única llave sin repuesto |
| Claves SSH en FIDO2 | robo del archivo de la clave privada: en el archivo solo hay un identificador, la parte privada no abandona el dispositivo | acciones del atacante en el cliente mientras la llave está conectada y el usuario la toca a petición |
| CI/CD | claves permanentes en la configuración del proyecto (usar OIDC); entrega de secretos de producción a ramas y forks no protegidos | salida del secreto en el log en forma modificada; runner comprometido que ejecuta un job con secretos |
Ninguna capa lo cubre todo. La idea del esquema es que para obtener el secreto el atacante tenga que superar varias defensas, no solo una; no todas son independientes: parte se apoya en una misma estación de trabajo.
Limitaciones
Zero trust no hace el sistema invulnerable. Es mejor conocer de antemano los límites del enfoque.
- El endpoint sigue siendo un punto débil. Mientras el almacén esté abierto, los secretos están disponibles para los procesos de tu usuario y para root. Cerrar sesiones tras el trabajo, llaves hardware y tokens cortos reducen la ventana, pero no la eliminan.
- El self-hosting es tu responsabilidad. Actualizaciones, copias de seguridad, HTTPS, protección contra fuerza bruta y el panel administrativo de Vaultwarden dependen de vosotros. El servidor Linux necesita protección básica: firewall, Fail2ban, auditoría (el ciclo «Protección de servidor Linux», empezando por el artículo «Protección de servidor Linux: Parte 1 — Firewall UFW»).
- Hay pocos secretos dinámicos en este esquema. La mayoría de secretos en el gestor son estáticos; los protege la rotación, no la corta vida. Tokens de corta duración están donde la propia plataforma los emite: tokens OIDC para jobs en GitLab y GitHub. Según la documentación de Gitea a 12.10.2026 no se soporta el ámbito
id-token, es decir, Gitea Actions no emite token OIDC para jobs. - El enmascaramiento en CI no es protección. Tanto GitLab como GitHub advierten que un valor modificado no será enmascarado. Protege solo que el secreto no llegue al job que no lo necesita.
- Comodidad versus rigor. Cada verificación adicional ralentiza el trabajo. Si las reglas son demasiado incómodas, la gente las elude: guarda la contraseña en una nota, desactiva el segundo factor, da al token todos los permisos. El esquema debe diseñarse para que la vía segura sea también la más rápida.
- Recuperación tras la pérdida. La llave hardware no se puede copiar. Sin una llave de repuesto registrada de antemano en todos los servicios y sin los códigos de recuperación, perder el dispositivo significa perder el acceso.
Lista de verificación
- Haced un inventario de secretos: qué es, para qué sirve, dónde se almacena, quién tiene acceso. Sin inventario no se puede rotar ni revocar.
- Migrad los secretos desde
.env, configs, notas y correspondencia a un único almacén; en los repositorios dejad solo los nombres de las variables. - Revisad el historial Git y los logs de CI en busca de secretos antiguos; si encontráis alguno, cambiadlo primero en el proveedor y luego limpiad el historial.
- Sustituid cuentas compartidas por personales, y otorgad acceso a secretos compartidos mediante grupos y colecciones.
- Activad el segundo factor para el acceso al almacén; preferible una llave hardware FIDO2, y registrad inmediatamente una de repuesto.
- Separad los secretos de producción y desarrollo; los de producción dadlos solo a ramas y entornos protegidos en CI.
- Prohibid pasar secretos a jobs desde forks y no ejecutéis código no confiable en runners que tengan acceso a secretos de producción.
- Donde la plataforma soporte OIDC, reemplazad claves permanentes en CI por tokens de corta duración.
- Estableced plazos de rotación y el procedimiento ante la salida de un empleado: qué secretos compartidos se cambian y quién lo hace.
- Activad el registro de accesos a secretos y las alertas por intentos de acceso fallidos; cifrad las copias de seguridad del almacén y verificad la recuperación.
// Tarea parecida
Si estás resolviendo algo parecido
Este artículo pertenece a uno de los temas principales de trabajo. Puedes seguir leyendo sobre el tema, ir a la página principal para entender a qué me dedico o abrir directamente los servicios.
Tema del artículo
Despliegue y estabilidad
Docker, CI/CD, despliegues, monitoreo, observabilidad y respuesta a incidentes.
Tareas frecuentes de este tema
- Configurar despliegues sin trabajo manual ni caos
- Añadir monitoreo, alertas y observabilidad base
- Investigar incidentes y estabilizar produccion
// Siguiente paso
Si necesitas ayuda con este tema y no solo otro artículo, es mejor ir directo a la página del servicio. La página principal y la selección de materiales quedan como rutas secundarias.
Abrir servicios// Reviews
Reseñas relacionadas
Llegué con una solicitud costosa para la configuración de un servidor VPS, pero durante la consulta Mikhail propuso una solución mucho más sencilla y económica. Al final ahorré dinero y tiempo. Mikhail — un verdadero experto que trabaja por el resultado del cliente, no por la factura. ¡Lo recomiendo!
Llegué con una solicitud costosa para la configuración de un servidor VPS, pero durante la consulta Mikhail propuso una solución mucho más simple y económica. Al final ahorré presupuesto y tiempo. Mikhail es un …
Configuración de VPS, configuración del servidor
12.05.2026 · ★ 5/5
¡Excelente trabajo! Configuró el servidor muy rápido, instaló el panel y configuró la IP. ¡Sin duda lo recomiendo!
¡Excelente trabajo! Muy rápido configuró el servidor, instaló el panel y configuró la IP. ¡Sin duda lo recomiendo!
Configuración de VPS, configuración del servidor
19.04.2026 · ★ 5/5
Todo perfecto, ayudó de forma rápida y profesional, gracias, lo recomiendo a la comunidad
Todo perfecto, ayudó de forma rápida y profesional, gracias, lo recomiendo a la comunidad
Configuración de VPS, configuración del servidor
16.04.2026 · ★ 5/5
Hubo varios problemas, tanto en la parte técnica como en la comprensión general. Mijaíl respondió rápido a la solicitud, ayudó a aclarar las cosas y resolvió los problemas técnicos; por ello, muchas gracias. Estoy satisfecho con el resultado.
Hubo varios problemas relacionados tanto con la parte técnica como con la comprensión en general. Mijaíl respondió rápidamente a la solicitud, ayudó a aclarar las cosas y resolvió los problemas técnicos, por lo que le …
Configuración de VPS, configuración del servidor
18.02.2026 · ★ 5/5
Todo se hizo de manera rápida y precisa. Lo recomiendo.
Todo se hizo rápido y con precisión. Lo recomiendo.
Configuración de VPS, configuración del servidor
17.01.2026 · ★ 5/5
Todo salió bien, el profesional respondió rápidamente a las preguntas y ayudó a resolver el problema. ¡Gracias!
Todo fue bien, el profesional respondió rápidamente a las preguntas y ayudó a resolver el problema. ¡Gracias!
Configuración de VPS, configuración del servidor
16.12.2025 · ★ 5/5
// Contact
¿Necesitas ayuda?
Escríbeme y te ayudaré a resolver el problema
Respondo en un día laborable (03:00-13:00 GMT)
O deje su solicitud aquí:
// Related