Automatizar la rotación de contraseñas de cuentas de servicio en Linux con Python y Vault
Introducción
En entornos de producción, las cuentas de servicio (service accounts) suelen tener privilegios amplios y su exposición representa un riesgo crítico. La rotación periódica de contraseñas reduce la ventana de ataque y cumple con normas de seguridad como PCI‑DSS o ISO 27001. HashiCorp Vault provee un motor de secrets dinámico que genera credenciales temporales y las revoca automáticamente, pero muchos equipos prefieren mantener cuentas estáticas en sus sistemas operativos. En este artículo veremos cómo automatizar la rotación de esas contraseñas estáticas usando un script Python que interactúa con la API HTTP de Vault.
El objetivo es:
- Crear una política en Vault que permita generar/actualizar contraseñas.
- Configurar un role que defina la longitud y complejidad.
- Desarrollar un script Python que obtenga una nueva contraseña y la aplique a la cuenta de Linux.
- Programar el script con
systemd timerpara que se ejecute automáticamente.
Preparativos previos
1. Instalación de Vault y habilitación del secrets engine
Asumimos que Vault ya está instalado y en modo dev o production. Para este escenario usaremos el secrets engine database porque permite generar contraseñas dinámicas para bases de datos, pero también podemos utilizar el generic para almacenar contraseñas arbitrarias.
# Iniciar Vault (modo dev) vault server -dev -dev-root-token-id=rootEn otra terminal, exportar el token
export VAULT_ADDR=‘http://127.0.0.1:8200’ export VAULT_TOKEN=‘root’
2. Habilitar el motor de secrets genéricos
# Habilitar el motor KV v2 en la ruta secret/
vault secrets enable -path=secret kv-v2
3. Crear la política de acceso
Guardamos la política en un archivo svc-pass-policy.hcl:
path "secret/data/svc_accounts/*" {
capabilities = ["create", "read", "update", "delete", "list"]
}
Luego la aplicamos y creamos un token con esa política:
vault policy write svc-pass-policy svc-pass-policy.hcl
vault token create -policy=svc-pass-policy -ttl=72h
Copiamos el valor del token; lo usaremos en el script Python.
Desarrollo del script Python
1. Dependencias
Instalamos las librerías necesarias:
sudo apt-get update && sudo apt-get install -y python3-pip
pip3 install hvac
hvac es el cliente oficial de Vault para Python.
2. Estructura del script
A continuación el código completo con explicaciones en línea:
#!/usr/bin/env python3 """ rotate_svc_pass.py – Rotación automática de contraseñas de cuentas de servicio. Requiere: - hvac (pip install hvac) - token de Vault con política adecuada """import os import subprocess import sys import hvac import logging from datetime import datetime
---------- Configuración ----------
VAULT_ADDR = os.getenv(‘VAULT_ADDR’, ‘http://127.0.0.1:8200’) VAULT_TOKEN = os.getenv(‘VAULT_TOKEN’) # <— definir en environment SECRET_PATH = ‘secret/data/svc_accounts’ # KV v2 path SERVICE_USER = ‘svc_app’ # cuenta de Linux a rotar PASS_LENGTH = 32
-----------------------------------
logging.basicConfig( level=logging.INFO, format=’%(asctime)s %(levelname)s %(message)s’, handlers=[logging.StreamHandler(sys.stdout)] )
def get_new_password(): """ Genera una contraseña aleatoria usando el motor de secrets genéricos de Vault. Guardamos la contraseña bajo la ruta secret/data/svc_accounts/
. """ client = hvac.Client(url=VAULT_ADDR, token=VAULT_TOKEN) if not client.is_authenticated(): logging.error(‘No se pudo autenticar con Vault’) sys.exit(1) # Generar la contraseña (usamos el endpoint /random/bytes) rand_bytes = client.secrets.kv.v2.generate_random_bytes(num_bytes=PASS_LENGTH) password = rand_bytes['data']['random_bytes'].hex()[:PASS_LENGTH] # Guardar en KV full_path = f'{SECRET_PATH}/{SERVICE_USER}' client.secrets.kv.v2.create_or_update_secret( path=full_path, secret={'password': password}, mount_point='secret' ) logging.info(f'Nueva contraseña almacenada en Vault bajo {full_path}') return passworddef apply_password_linux(password): """ Cambia la contraseña del usuario del sistema usando
chpasswd. Se ejecuta como root. """ cmd = f’echo “{SERVICE_USER}:{password}” | chpasswd’ try: subprocess.run(cmd, shell=True, check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE) logging.info(f’Contraseña del usuario {SERVICE_USER} actualizada en el SO’) except subprocess.CalledProcessError as e: logging.error(f’Error al cambiar la contraseña: {e.stderr.decode()}’) sys.exit(1)def main(): new_pass = get_new_password() apply_password_linux(new_pass)
if name == ‘main’: main()
Explicación de los pasos clave:
hvac.Clientcrea una conexión segura a Vault usandoVAULT_ADDRyVAULT_TOKEN.- El endpoint
/random/bytesde Vault genera una cadena aleatoria sin necesidad de almacenar nada. - La contraseña se guarda en KV v2 bajo
secret/data/svc_accounts/para auditoría. - Se utiliza
chpasswd(ejecutado como root) para actualizar la cuenta del sistema.
3. Seguridad del script
Para evitar que el token quede expuesto:
- Defínalo en un archivo
/etc/vault/tokencon permisos600y exportalo en el service unit. - Considera usar
AppRoleen lugar de token estático para una mayor rotación.
Programación con systemd timer
1. Crear el service unit
[Unit] Description=Rotación de contraseña de cuenta de servicio After=network-online.target[Service] Type=oneshot EnvironmentFile=/etc/vault/env ExecStart=/usr/local/bin/rotate_svc_pass.py User=root Group=root
Aseguramos que el token se cargue desde el archivo
/etc/vault/env contiene: VAULT_TOKEN=xxxx
2. Crear el timer unit
[Unit] Description=Timer para rotar la contraseña cada 30 días[Timer] OnCalendar=--01/30 00:00:00 Persistent=true
[Install] WantedBy=timers.target
Los archivos deben guardarse como /etc/systemd/system/rotate-svc-pass.service y /etc/systemd/system/rotate-svc-pass.timer.
# Recargar systemd, habilitar y arrancar
systemctl daemon-reload
systemctl enable --now rotate-svc-pass.timer
systemctl status rotate-svc-pass.timer
Sección de troubleshooting
Errores comunes
- 401 Unauthorized – El token usado no tiene la política adecuada o está expirado. Verifique
vault token lookup <token>. - Permission denied al ejecutar chpasswd – El service unit no se está ejecutando como root. Añada
User=rooto usesudocon NOPASSWD en/etc/sudoers.d/rotate-svc-pass. - Vault connection timeout – Asegúrese de que
VAULT_ADDRsea accesible desde la máquina y que no haya firewall bloqueando el puerto 8200. - La contraseña no cambia en el SO – Revise el log del service (
journalctl -u rotate-svc-pass.service) para ver la salida dechpasswd. También confirme que el usuario existe. - El archivo de token es legible por otros usuarios – Asegure permisos
chmod 600 /etc/vault/tokeny propietario root.
Comandos de diagnóstico
# Ver token y políticas vault token lookup $(cat /etc/vault/token)Probar la API manualmente
curl -H “X-Vault-Token: $(cat /etc/vault/token)”
$VAULT_ADDR/v1/secret/data/svc_accounts/svc_appRevisar estado del timer
systemctl list-timers —all | grep rotate-svc-pass
Ver logs del service
journalctl -u rotate-svc-pass.service -f
Conclusión
Automatizar la rotación de contraseñas de cuentas de servicio en Linux con Python y Vault brinda varios beneficios:
- Seguridad mejorada: las credenciales cambian regularmente y quedan registradas en Vault.
- Auditoría centralizada: cada generación queda almacenada en el motor KV, facilitando cumplimiento.
- Operación sin intervención humana: el
systemd timergarantiza la ejecución periódica. - Escalabilidad: basta con replicar el script o parametrizarlo para múltiples usuarios.
Adapte los valores de longitud, complejidad y periodicidad a las políticas de su organización y considere integrar AppRole o OIDC para evitar tokens estáticos. Con esta base, podrá extender la solución a bases de datos, APIs o cualquier otro recurso que requiera credenciales dinámicas.