Zum Hauptinhalt springen

Python Connector

Der Passwork Python Connector ist ein Tool, das die Integration von Passwork für Programmierer und DevOps-Ingenieure vereinfacht. Der Connector ermöglicht eine schnelle und sichere Automatisierung der Verwaltung von Passwörtern, Tresoren und Zugriffsrechten, ohne sich mit den Details der Low-Level-API-Interaktion und Kryptografie befassen zu müssen.

Hauptfunktionen und Vorteile

  • Vereinfachung der Integration: Der Connector macht die manuelle Implementierung von API, Verschlüsselung und Sitzungen überflüssig. Alle grundlegenden Vorgänge werden auf einfache Methoden reduziert.
  • Clientseitige Sicherheit: Die gesamte Client-Kryptografie (Verschlüsselung, Entschlüsselung, Masterschlüssel) ist im Connector implementiert. Ihre Geheimnisse sind stets geschützt — auch bei der Arbeit mit der offenen API.
  • Sitzungsverwaltung: Der Connector ermöglicht das Speichern und Wiederherstellen von Sitzungen, um eine erneute Autorisierung bei jedem Skriptlauf zu vermeiden.
  • Flexibilität: Für alle API-Methoden, die nicht durch separate Connector-Funktionen abgedeckt sind, ist eine universelle Aufrufmethode implementiert. Damit können Sie auf beliebige Passwork-API-Endpunkte zugreifen und gleichzeitig Sicherheit und Komfort gewährleisten.

Anwendungsbeispiele

  • Ein neues Passwort erstellen
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)
  • Direkte API-Aufrufe für Vorgänge, die nicht durch Hilfsmethoden abgedeckt sind:
# Direct API call
response = client.call("DELETE", f"/api/v1/folders/{folder_id}")

Wofür der Python Connector geeignet ist

  • Automatisierung der Passwort- und Tresorverwaltung aus Python-Skripten;
  • Integration von Passwork in CI/CD-Pipelines und interne Dienste;
  • Sichere zentrale Zugriffsverwaltung und Änderungsaudit;
  • Schnelle Implementierung von Passwork in die Unternehmensinfrastruktur ohne tiefgreifende API-Kenntnisse.

Sicherheit

  • Alle Geheimnisse werden nur clientseitig verschlüsselt und entschlüsselt (wenn die clientseitige Verschlüsselung aktiviert ist);
  • Sitzungsdaten können in verschlüsselter Form gespeichert werden;
  • Alle Vorgänge verwenden einen Masterschlüssel, der Ihre Umgebung nie verlässt.

Technische Dokumentation

Technische Dokumentation für den Python Connector einsehen