Passwork CLI
Passwork CLI es una herramienta de línea de comandos para obtener contraseñas de Passwork y trabajar con ellas de forma segura mediante scripts, automatización y CI/CD.
Modos de operación principales
- exec — obtiene contraseñas de elementos o accesos directos, las coloca en variables de entorno y ejecuta el comando especificado con estas variables.
- get — obtiene el valor de un campo de un elemento o acceso directo, lo descifra localmente y lo redirige a STDOUT.
- update — actualiza de forma segura un campo de un elemento o acceso directo a través de CLI.
- api — permite ejecutar cualquier método de la API de Passwork y recibir una respuesta en formato JSON.
Para qué se utiliza Passwork CLI
- Conexión segura a bases de datos y servicios — las contraseñas no se guardan en disco, no aparecen en el historial de comandos y se sustituyen solo durante la ejecución del comando.
- Automatización de despliegue y CI/CD — los secretos de Passwork están disponibles automáticamente en los pipelines.
- Administración de servidores — las tareas se realizan utilizando variables de entorno temporales.
- Integración con herramientas DevOps — obtención rápida de contraseñas para scripts, Ansible, Terraform y otras herramientas.
Beneficios adicionales de Passwork CLI
- Acceso a contraseñas solo durante la ejecución del proceso
- Compatibilidad con certificados autofirmados
- Filtrado flexible de elementos por etiquetas, carpetas, bóvedas
- Todos los datos se cifran en el lado del cliente (cuando el modo de cifrado del lado del cliente está habilitado)
Instalación
Puede instalar el paquete directamente desde Github:
- shell
pip install git+ssh://[email protected]:passwork-me/passwork-python.git
o
- shell
pip install git+https://github.com/passwork-me/passwork-python.git
Ejemplos de uso
Modo EXEC — ejecutar comandos con variables de entorno especificadas
Iniciar una base de datos con la contraseña de un elemento:
- shell
passwork-cli exec --password-id "db_password_id" \
mysql -u admin -h localhost -p"$DB_PASSWORD" database_name
Modo GET — obtención de datos
Obtener la contraseña de un elemento por ID:
- shell
passwork-cli get --password-id "68793e13dfc88d879e0f2e39"
Modo UPDATE — actualización de datos
Actualizar la contraseña de un elemento:
- shell
passwork-cli update \
--password-id "68793e13dfc88d879e0f2e39" \
--password "new-password-value"
Modo API — llamadas directas a la API
Obtener una lista de todas las bóvedas:
- shell
passwork-cli api --method GET --endpoint "v1/vaults"
aviso
Se recomienda utilizar variables de entorno para almacenar tokens y claves maestras