python-connector

---

path: api-and-integrations/python-connector.mdx title: Conector Python slug: python-connector pagination_next: null pagination_prev: null sidebar_position: 2 description: >- Passwork Python Connector es una herramienta para una integración rápida y segura con Passwork a través de la API. Permite automatizar el trabajo con contraseñas, bóvedas, usuarios y sesiones sin profundizar en los detalles de la criptografía. keywords:

• Passwork
• Python
• API
• connector
• integration
• automation
• encryption
• sessions
• passwords
• vault
• users

---

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

pip install passwork-python

GitHub (SSH)

pip install git+ssh://[email protected]:passwork-me/passwork-python.git

GitHub (HTTPS)

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;