Conector Python
Descripción general
Passwork Python Connector es una herramienta que simplifica la integración de Passwork con la infraestructura de la empresa para programadores e ingenieros DevOps. El conector permite una automatización rápida y segura del trabajo con contraseñas, bóvedas y accesos sin profundizar en la interacción de bajo nivel con la API y los detalles de la criptografía.
Tareas principales y ventajas
- Simplificación de la integración: El conector elimina la necesidad de implementar manualmente el manejo de la API, el cifrado y las sesiones. Todas las operaciones principales se reducen a métodos sencillos.
- Seguridad del lado del cliente: Toda la criptografía del lado del cliente (cifrado, descifrado, trabajo con la clave maestra) está implementada dentro del conector. Sus secretos están siempre protegidos — incluso cuando se trabaja con una API abierta.
- Gestión de sesiones: El conector permite guardar y restaurar sesiones para evitar la reautenticación en cada ejecución del script.
- Flexibilidad:
Para todos los métodos de la API no cubiertos por funciones específicas del conector, se implementa un método universal
call. Permite acceder a cualquier endpoint de Passwork API manteniendo la seguridad y la facilidad de uso.
Requisitos
- Python 3.10+
- requests>=2.31.0
- python-dotenv>=1.0.0
- cryptography>=42.0.0
- pbkdf2>=1.3
Instalación
Puede instalar el paquete desde PyPI o GitHub:
- PyPI
- GitHub (SSH)
- GitHub (HTTPS)
pip install passwork-python
pip install git+ssh://[email protected]:passwork-me/passwork-python.git
pip install git+https://github.com/passwork-me/passwork-python.git
Funcionalidades
- Cifrado del lado del cliente con soporte de contraseña maestra;
- Actualización automática de tokens;
- Almacenamiento cifrado y restauración de sesiones;
- Cifrado multinivel (PBKDF2, RSA, AES);
- Manejo de archivos adjuntos;
- Gestión de usuarios y roles;
- Gestión de bóvedas;
- Compartir contraseñas mediante «bandeja de entrada»;
- Soporte de campos personalizados;
- Sistema de etiquetas;