| Erweitern | ||||
|---|---|---|---|---|
| ||||
|
Stand: 11.11.2026, Release 9.3.
Ausgangslage
Formulare und Prozesse in JAXForms tauschen Daten mit Drittsystemen aus: mit Fachanwendungen, Registern, Zahlungsanbietern oder Signaturdiensten. Jede dieser Schnittstellen braucht eine Adresse und Zugangsdaten, oft auch ein Zertifikat.
Bisher standen diese Angaben in Konfigurationsdateien des Mandanten. Das hatte Nachteile:
- Zugangsdaten im Klartext. Passwörter und Schlüssel standen lesbar in den Dateien.
- Pflege nur über Dateien. Eine Änderung brauchte den Austausch einer Datei, es gab keine Oberfläche dafür.
- Kein Überblick. Welche Schnittstellen ein Mandant hat, welche aktiv sind und wann ein Zertifikat abläuft, war nirgends auf einen Blick sichtbar.
- Mehrfach abgelegte Zertifikate. Dieselbe Zertifikatsdatei lag für mehrere Schnittstellen mehrfach vor.
Lösung in Kürze
Die Schnittstellen-Verwaltung ist ein neuer Bereich der Administration. Dort erfassen und pflegen Sie die Schnittstellen Ihres Mandanten in Formularen statt in Dateien.
- Verschlüsselte Ablage. Passwörter, Schlüssel und Zertifikate liegen verschlüsselt in einem Tresor in der Datenbank.
- Kein Auslesen. Ein gespeicherter Wert lässt sich überschreiben, aber nicht mehr anzeigen. Eine Ausnahme gilt für berechtigte Support-Benutzer des Betreibers; jede solche Anzeige wird protokolliert.
- Nachvollziehbarkeit. Jede Änderung an einer Schnittstelle und an ihren Zugangsdaten wird protokolliert.
- Überblick. Listen zeigen alle Schnittstellen und Zertifikate des Mandanten mit Zustand und Ablaufdatum.
- Trennung der Mandanten. Jeder Mandant sieht und pflegt nur seine eigenen Einträge.
Bestehende Schnittstellen arbeiten unverändert weiter. Die Übernahme der bisherigen Konfiguration in die Schnittstellen-Verwaltung erledigt der Betreiber der Plattform.
...
Grundkonzept
Die Schnittstellen-Verwaltung besteht aus drei Teilen, die aufeinander verweisen:
| Teil | Was er enthält | Beispiel |
|---|---|---|
| Schnittstelle | Die Verbindung zu einem Drittsystem: ein eindeutiger Schlüssel, die Adresse, die Art der Anmeldung und die Zugangsdaten. | Der Adressdienst mit Benutzername und Passwort. |
| Keystore | Eine Zertifikatsdatei mit ihrem Passwort. Mehrere Schnittstellen können denselben Keystore verwenden. | Das Client-Zertifikat, mit dem sich drei Schnittstellen beim selben Anbieter ausweisen. |
| Transaktion | Der einzelne Aufruf über eine Schnittstelle: was gesendet wird und was mit der Antwort geschieht. | Die Abfrage einer Adresse beim Absenden eines Formulars. |
Eine Transaktion nennt die Schnittstelle über deren Schlüssel. Ändern sich Adresse oder Zugangsdaten eines Drittsystems, passen Sie nur die Schnittstelle an; alle Transaktionen, die sie verwenden, arbeiten mit den neuen Angaben.
Der Tresor
Jedes Passwort und jede Zertifikatsdatei wird mit einem eigenen Schlüssel verschlüsselt (AES-256). Diese Schlüssel sind ihrerseits durch einen Hauptschlüssel geschützt. Das Passwort zum Hauptschlüssel liegt nicht in der Datenbank, sondern getrennt davon auf den Servern.
Eine Kopie der Datenbank allein genügt deshalb nicht, um Zugangsdaten zu lesen.
Wer was pflegt
- Der Administrator eines Mandanten pflegt Schnittstellen, Keystores und Transaktionen dieses Mandanten.
- Eine Schnittstelle kann für untergeordnete Mandanten freigegeben werden. Diese sehen sie schreibgeschützt und können sie verwenden.
- Eine neue Schnittstelle ist nach dem Speichern aktiv. Eine deaktivierte Schnittstelle bleibt gespeichert, wird aber nicht verwendet.
...
Weiterführende Seite
- Schnittstellen-Verwaltung – Bedienung: Schnittstellen, Keystores und Transaktionen erfassen und pflegen.