Schritt 1: Verbindung herstellen
Bevor Daten zwischen Ihrem ERP-System und Workist ausgetauscht werden können, muss eine Verbindung eingerichtet werden. Workist bietet hierfür zwei Optionen, zwischen denen Sie frei wählen können:
| Option | Empfohlen für |
|---|---|
| SFTP | Datei-basierter Austausch (z. B. CSV/XML-Exporte aus dem ERP), keine eigene Integration nötig |
| API | Programmatische Integration, ereignisgesteuerte Übertragung, eigene Anwendungen |
Beide Optionen können auch in Kombination genutzt werden — z. B. Stammdaten per SFTP, Ausgaben per API.
Option A: SFTP
Workist stellt im Standard einen SFTP-Server bereit, der mittels Public-Key-Authentifizierung gesichert ist. Detaillierte Informationen zu Verbindungsdaten, Verzeichnisstruktur und Testbefehlen finden Sie in der SFTP-Dokumentation.
Die Einrichtung erfolgt in drei Teilschritten:
A1 — SSH-Schlüsselpaar erzeugen
Erzeugen Sie auf Ihrem System ein neues SSH-Schlüsselpaar. Auf macOS oder Linux genügt folgender Befehl:
ssh-keygen -t rsa -b 4096 -C "ihr-team@example.com" -f ~/.ssh/workist_sftp
Damit entstehen zwei Dateien:
~/.ssh/workist_sftp— der private Schlüssel. Diese Datei bleibt ausschließlich auf Ihrem System und darf niemals weitergegeben werden.~/.ssh/workist_sftp.pub— der öffentliche Schlüssel. Der Inhalt wird in Schritt A2 in die Workbench eingefügt.
Weitere Plattformen (Windows mit PuTTY, Ed25519 etc.) sind in der SFTP-Dokumentation beschrieben.
Geben Sie ausschließlich den öffentlichen Schlüssel weiter. Der private Schlüssel darf nicht an Workist oder Dritte übermittelt werden.
A2 — Öffentlichen Schlüssel in der Workbench hinterlegen
Sobald der öffentliche Schlüssel in Ihrem Workist-Konto hinterlegt ist, kann sich der dazugehörige private Schlüssel ohne Passwort am SFTP-Server anmelden. Schlüssel können hinzugefügt und gelöscht, aber nicht bearbeitet werden.
Voraussetzungen
- Ein Workbench-Konto mit Zugriff auf die Einstellungen Ihrer Organisation.
- Ein öffentlicher SSH-Schlüssel im OpenSSH-Format (Schlüsseltext beginnt mit
ssh-rsaoder einem anderen OpenSSH-Algorithmus-Präfix).
1. In der Workbench anmelden
Öffnen Sie die Workbench in Ihrem Browser und melden Sie sich mit Ihrem Workist-Konto an. Nach der Anmeldung landen Sie auf der Übersichtsseite für eingehende Dokumente.
2. Einstellungen öffnen
Klicken Sie in der linken Navigationsleiste unten auf Einstellungen. Es erscheint ein kleines Menü mit den Bereichen Organisation, Teams, Mitarbeiter*innen und Integrationen.
Wählen Sie dort Integrationen.
3. Bereich „Integrationen" öffnen
Sie befinden sich nun im Einstellungsbereich. Auf der linken Seite sehen Sie die Unter-Navigation mit allen Einstellungskategorien. Unter dem Abschnitt Entwickler-Tools finden Sie den Eintrag Öffentliche SFTP-Schlüssel.
Klicken Sie auf Öffentliche SFTP-Schlüssel.
4. Seite „Öffentliche SFTP-Schlüssel"
Sie sehen nun das Formular SFTP-Öffentlichen Schlüssel hinzufügen. Im oberen Bereich der Seite finden Sie unter SSH-Benutzername den Benutzernamen, den Sie für die Verbindung zum SFTP-Server von Workist verwenden — über die Schaltfläche Kopieren lässt er sich direkt in die Zwischenablage übernehmen. Sofern bereits Schlüssel hinterlegt sind, werden diese zusätzlich in einer Tabelle oberhalb des Formulars angezeigt. Über das Mülleimer-Symbol in der jeweiligen Zeile lässt sich ein bestehender Schlüssel löschen.
5. Öffentlichen Schlüssel einfügen
Öffnen Sie die Datei workist_sftp.pub (bzw. Ihre .pub-Datei) in einem Texteditor und kopieren Sie den gesamten Inhalt. Fügen Sie den Schlüssel anschließend in das Feld Öffentlicher Schlüssel (im OpenSSH-Format, beginnend mit „ssh-rsa") ein.
Beispiel für einen gültigen Schlüssel:
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC1zFZpL9a6bVQMWS20u3y3WzVCq6tbm... ihr-team@example.com
Der Schlüssel ist eine einzelne lange Zeile. Achten Sie darauf, dass beim Kopieren keine zusätzlichen Zeilenumbrüche entstehen.
6. Schlüssel hinzufügen
Klicken Sie unten rechts in der Karte auf Hinzufügen.
Bei Erfolg erscheint eine grüne Bestätigungsmeldung und der neue Schlüssel wird in der Tabelle oberhalb des Formulars mit dem Zeitstempel der Hinzufügung angezeigt.
Schlüssel wieder entfernen
Auf derselben Seite befindet sich in jeder Zeile ein Mülleimer-Symbol. Ein Klick darauf entfernt den Schlüssel sofort vom SFTP-Server — eine Rückfrage erscheint nicht. Prüfen Sie daher vor dem Löschen, dass Sie den richtigen Schlüssel ausgewählt haben.
A3 — Verbindung testen
Den benötigten SFTP-Benutzernamen finden Sie direkt auf der Seite Öffentliche SFTP-Schlüssel im Bereich SSH-Benutzername.
sftp -i ~/.ssh/workist_sftp <ssh-benutzername>@<sftp-host>
Vollständige Verbindungsdaten (Host, Port, Fingerprint, IP-Adressen) und weitere Testbefehle finden Sie in der SFTP-Dokumentation.
Option B: API
Workist stellt eine REST-API für den Datenaustausch bereit. Über die API können sowohl Stammdaten übertragen als auch verarbeitete Dokumente abgerufen werden.
Eine vollständige Anleitung zur Authentifizierung und Nutzung finden Sie in der API-Dokumentation. Der Quickstart führt Sie durch den ersten Aufruf.
Hilfe und Support
Wenn die Verbindung trotz hinterlegtem Schlüssel scheitert oder der API-Zugang nicht wie erwartet funktioniert, wenden Sie sich bitte an Ihre Ansprechperson bei Workist und halten Sie die folgenden Informationen bereit:
- den Kurznamen Ihrer Organisation
- bei SFTP: den Fingerabdruck Ihres Schlüssels (
ssh-keygen -lf ~/.ssh/workist_sftp.pub) - den Zeitpunkt des letzten Verbindungsversuchs sowie die Fehlermeldung Ihres Clients