Conector Python
Passwork Python Connector es una herramienta que simplifica la integración de Passwork para programadores e ingenieros DevOps. El conector permite automatizar de forma rápida y segura la gestión de contraseñas, bóvedas y accesos sin profundizar en los detalles de la interacción de bajo nivel con la API y la criptografía.
Características y beneficios principales
- Simplificación de la integración: El conector elimina la necesidad de implementar manualmente la API, el cifrado y las sesiones. Todas las operaciones básicas se reducen a métodos simples.
- Seguridad del lado del cliente: Toda la criptografía del cliente (cifrado, descifrado, clave maestra) está implementada dentro del conector. Sus secretos están siempre protegidos, incluso al trabajar con la API abierta.
- Gestión de sesiones: El conector permite guardar y restaurar sesiones para evitar la necesidad de volver a autorizarse en cada ejecución de script.
- Flexibilidad: Para todos los métodos de la API que no están cubiertos por funciones separadas del conector, se implementa un método de llamada universal. Con él, puede acceder a cualquier endpoint de la API de Passwork manteniendo la seguridad y la comodidad.
Ejemplos de uso
- Crear una nueva contraseña
password = {
"name": "Service Name",
"login": "username",
"password": "secure-password",
"vaultId": vault_id,
"folderId": folder_id, # Optional
"description": "Description",
"url": "https://service-url.com",
"tags": ["tag1", "tag2"],
"customs": [
{
"name": "Additional login",
"value": "second-username",
"type": "text"
},
{
"name": "Recovery code",
"value": "recovery-code-value",
"type": "password"
},
{
"name": "TOTP",
"value": "JBSWY3DPEHPK3PXP",
"type": "totp"
}
],
"attachments": [
{
"path": "path/to/file.png",
"name": "file.png"
}
]
}
password_id = client.create_password(password)
- Llamadas directas a la API para operaciones no cubiertas por los métodos auxiliares:
# Direct API call
response = client.call("DELETE", f"/api/v1/folders/{folder_id}")
Para qué es adecuado el conector Python
- Automatización de la gestión de contraseñas y bóvedas desde scripts de Python;
- Integración de Passwork con pipelines de CI/CD y servicios internos;
- Gestión centralizada y segura de accesos y auditoría de cambios;
- Implementación rápida de Passwork en la infraestructura corporativa sin conocimientos profundos de la API.
Seguridad
- Todos los secretos se cifran y descifran solo en el lado del cliente (si el cifrado del lado del cliente está habilitado);
- Los datos de sesión se pueden almacenar en forma cifrada;
- Todas las operaciones utilizan una clave maestra que nunca abandona su entorno.