TCPP 1.3.0
Referenzknoten · Schema · Handbuch Entwurf

Downloads

Alles, was zu TCPP 1.3.0 veröffentlicht ist

Der Referenzknoten ist eine Binärdatei ohne Abhängigkeiten und ohne Installation. Er liefert eine schemagesteuerte Weboberfläche zum Erstellen und Prüfen von TCPP-Nachrichten, signiert sie und tauscht sie über TLS mit anderen Knoten aus.

Referenzknoten

Alles, was der Knoten zur Laufzeit braucht, ist einkompiliert: Schemasatz, ausgearbeitete Beispiele und die Weboberfläche. Schlüssel, Zertifikat und Protokolle legt er beim ersten Start neben sich ab.

PlattformArchitekturDateiGröße
Windowsx86-64 tcpp-node-1.3.0-windows-amd64.zip 3.8 MB

Prüfsummen zu allen Dateien dieser Seite: SHA256SUMS.txt.

Weitere Plattformen auf Anfrage. Der Knoten ist reines Go ohne Abhängigkeiten und lässt sich unverändert für Linux, macOS und ARM-Maschinen übersetzen. Diese Binärdateien sind hier nicht veröffentlicht, wir stellen sie aber gern bereit: eine Anfrage an info@iw-service.de genügt, mit Angabe von Betriebssystem und Prozessorarchitektur.

Starten

# .zip entpacken, dann in diesem Ordner
tcpp-node.exe

Der Knoten öffnet https://localhost:8443/. Das Zertifikat, das er sich selbst ausstellt, ist selbstsigniert; der Browser warnt daher einmal. Endpunkt wählen, Beispiel laden, dann Sign & Send.

Interessant wird es mit zwei Knoten, die miteinander sprechen; dafür genügen zwei Kopien in zwei Verzeichnissen:

a\tcpp-node.exe --port 8443 --node-type CSU --peer localhost:8444
b\tcpp-node.exe --port 8444 --node-type TMH --peer localhost:8443

Ein auf A signierter Frame erscheint sofort im Posteingang von B; ihn auszuwählen öffnet ein vorbefülltes Antwortformular. Das Handbuch beschreibt jeden Bildschirm, die Kommandozeile, die Dateien des Knotens und seine HTTP-Schnittstelle.

Schlüssel und Zertifikat sind die Identität des Knotens. Beide entstehen beim ersten Start neben der Binärdatei, und dasselbe Paar signiert Nachrichten und terminiert TLS. Einem Knoten eine eigene Identität zu geben heißt also, beide Dateien danebenzulegen und neu zu starten.

Handbuch

Die Betreibersicht auf den Knoten: jeder Bildschirm und jeder Arbeitsablauf, illustriert mit Abbildungen aus einem laufenden Zwei-Knoten-Labor, dazu Kommandozeile, Dateien, HTTP-Schnittstelle und der Aufbau einer TCPP-Nachricht.

Online lesen

Deutsch

Das Handbuch als eine Seite, mit allen Abbildungen.

Öffnen
Read online

English

Dieselbe Anleitung auf Englisch.

Open

Schema 1.3.0

Alle 55 Schemadateien: 27 Request/Response-Paare und der gemeinsame Rahmen. Derselbe Satz, den der Knoten mitbringt, und derselbe, der hier unter den URLs ausgeliefert wird, die die $id der Dateien selbst nennt.

Lizenz

TCPP ist ein offenes Protokoll. Schemas, Beispiele und diese Dokumentation dürfen frei verwendet und weiterverarbeitet werden, auch in kommerziellen Produkten. Die Spezifikation ist ein Entwurf: Version 1.3.0 ist vollständig genug, um dagegen zu entwickeln; Änderungen werden hier veröffentlicht.