OBS/Kostenpflichtige Module/REST-Server: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
Seitenliste: Pflege ersetzt Server-Profile, Zugänge und Endpunkte; Zugang gehört fest zu einem Server-Profil [Volltext ersetzt] |
||
| (26 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
{{Kostenpflichtige Module}} | {{Vorlage:Kostenpflichtige Module}} | ||
=REST-Schnittstelle | {{Seitentyp|Übersicht}} | ||
= REST-Server = | |||
Der REST-Server ist die '''universelle Schnittstelle''' Ihrer OBS-Installation nach außen. Webseiten, Apps, Geräte, Kundensysteme und Cloud-Dienste lesen Daten direkt aus OBS oder liefern neue Daten direkt in OBS ab. Diese Seite zeigt, was der REST-Server leistet, und führt Administratoren und Entwickler zu den passenden Unterseiten. | |||
{{Hinweis|Es handelt sich um ein kostenpflichtiges Modul. Die Schnittstelle muss über den OBS-Support aktiviert werden.}} | {{Hinweis|Es handelt sich um ein kostenpflichtiges Modul. Die Schnittstelle muss über den OBS-Support aktiviert werden.}} | ||
= | Sie erreichen das Modul über '''Stammdaten → Z Weitere Stammdaten → REST-Server'''. | ||
== Nutzen == | |||
Statt Daten zu exportieren, per Mail zu verschicken und woanders wieder einzulesen, holen sich angebundene Systeme genau die Information, die sie brauchen – in dem Moment, in dem sie sie brauchen. '''Was bisher nur manuell, per Datei-Import oder über Spezialschnittstellen ging, lässt sich automatisieren.''' Jeder Anwendungsfall wird einmal eingerichtet und läuft danach von selbst. | |||
Technisch ist der REST-Server ein in OBS integrierter '''HTTPS-Dienst'''. Jeder Endpunkt hat eine eigene Adresse, ein eigenes Skript und eigene Berechtigungen. Die Skripte pflegen Sie direkt in OBS. Antworten liefert der Server als JSON oder als Datei. Externe Systeme erhalten keinen Zugriff auf die Datenbank. Sie sehen nur, was ein Endpunkt-Skript freigibt. | |||
Der REST-Server ist damit ein '''Werkzeugkasten''': Was an Daten oder Funktionen in OBS verfügbar ist, können Sie über einen Endpunkt nach außen anbieten oder von außen entgegennehmen. Die Bandbreite reicht vom einfachen Lese-Endpunkt für eine Webseite bis zur B2B-Anbindung mit getrennten Zugängen je Partner. | |||
=== Was Sie damit erreichen === | |||
* '''Manuelle Arbeit fällt weg.''' Daten fließen direkt, ohne Export, Mail und Import. | |||
* '''Weniger Fehler.''' Jede manuelle Übertragung ist eine Fehlerquelle weniger. | |||
* '''Neue Angebote werden möglich.''' Kunden- und Lieferantenportale, Self-Service und Apps greifen auf OBS zu, ohne dass Sie ein zweites System pflegen. | |||
* '''Bestehende Software bleibt.''' Vorhandene Anwendungen docken über den REST-Server an OBS an, in beide Richtungen. | |||
* '''Wächst mit.''' Ein einzelner Endpunkt für eine Webseite lässt sich zu einer kompletten Integrationsplattform ausbauen, ohne die Grundlage zu wechseln. | |||
=== Anwendungsbereiche === | |||
Die folgenden Einsatzfälle sind Beispiele. Alles, was sich in einem Endpunkt-Skript abbilden lässt, kann der REST-Server bereitstellen. | |||
{{Hinweis|Ob für Ihren Anwendungsfall Entwicklungsaufwand entsteht, klärt Ihr OBS-Betreuer mit Ihnen.}} | |||
==== Webseiten und Kundenportale ==== | |||
* '''Live-Daten auf der eigenen Webseite:''' Lagerbestände, Verfügbarkeiten, Preise oder Auftragsstatus direkt aus OBS, ohne tägliche Datei-Exporte. | |||
* '''Kundenportale:''' Kunden sehen ihre offenen Posten, Aufträge und Lieferscheine. Jeder Kunde sieht nur seine eigenen Daten. | |||
* '''Statusseiten:''' Endkunden fragen den Stand einer Bestellung, eines Auftrags oder einer Reparatur über eine Nummer ab. | |||
==== Mobile Anwendungen und Außendienst ==== | |||
* '''Mobile Zeiterfassung:''' Mitarbeiter buchen Arbeitsbeginn, Pause und Ende am Smartphone. Die Daten landen direkt in OBS. | |||
* '''Scanner und Lagergeräte:''' Wareneingang, Inventur und Kommissionierung direkt in OBS, ohne zwischengeschaltete Software. | |||
* '''Außendienst-Apps:''' Techniker sehen ihre Aufträge, dokumentieren Einsätze, erfassen Material und laden Fotos hoch. | |||
* '''Geräte in Sekunden einrichten:''' Ein Zugangscode als QR-Code bringt Adresse und Zugangsdaten mit einem Scan auf das Gerät. | |||
==== Anbindung von Drittsystemen ==== | |||
* '''Webshops:''' Der Shop meldet Bestellungen direkt an OBS und fragt Bestände und Preise ab. | |||
* '''Buchhaltungs- und ERP-Systeme:''' Austausch von Belegen, Stammdaten und Buchungen in beide Richtungen. | |||
* '''CRM- und Marketing-Werkzeuge:''' Personendaten, Aktivitäten oder Mailing-Empfänger bleiben abgeglichen. | |||
* '''Logistikdienstleister:''' Versandaufträge gehen hinaus, Sendungsinformationen kommen zurück. | |||
==== Automatische Rückmeldungen (WebHooks) ==== | |||
* '''Rückruf-Adressen für Fremdsysteme:''' OBS legt für einen Vorgang eine Adresse an, die genau einmal gilt, z.B. für einen Bezahl- oder Versanddienst. Dessen Rückmeldung landet in OBS und wird dort weiterverarbeitet. | |||
* '''Automatisierungsplattformen''' stoßen über gewöhnliche Endpunkte Vorgänge in OBS an. | |||
==== Geschäftspartner (B2B) ==== | |||
* '''Lieferanten:''' Bestellungen gehen automatisch hinaus, Auftragsbestätigungen und Lieferavise kommen zurück. | |||
* '''Großkunden''' bestellen direkt aus ihrem eigenen System. | |||
* '''Maschine-zu-Maschine mit mTLS:''' Nur Partnersysteme mit einem gültigen Client-Zertifikat sprechen mit OBS. | |||
= | ==== Interne Automatisierungen ==== | ||
* '''Eigene Hilfswerkzeuge''' für Sammelaktionen, Berichte oder zeitgesteuerte Abläufe. | |||
* '''Mehrere Standorte''' tauschen Daten über definierte Endpunkte aus, ohne offene Datenbankverbindungen. | |||
* '''Dashboards und BI-Werkzeuge''' lesen aufbereitete Kennzahlen direkt aus OBS. | |||
== Seiten in diesem Bereich == | |||
=== Einrichten und betreiben === | |||
{| class="wikitable" | |||
! Seite !! Wofür | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Einrichtung|Einrichtung]] || Schritt für Schritt vom Server-Profil bis zum ersten erfolgreichen Aufruf. | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Öffentliche Freigabe|Öffentliche Freigabe]] || Portfreigabe, Reverse-Proxy, VPN und eigener Server im Vergleich. | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Pflege|Pflege]] || Server-Profile, Bindungen, Zugänge und Endpunkte in einem Fenster: TLS, Rate-Limits, Zertifikate, API-Key, CORS, mTLS, JWT, Pfad-Templates und Freischaltungen. | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Zertifikatserneuerung|Zertifikatserneuerung]] || Zertifikate automatisch beantragen und erneuern lassen. | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Zugangscode und Zertifikats-Pin|Zugangscode und Zertifikats-Pin]] || Geräte per QR-Code einrichten und den Server ohne öffentliches Zertifikat absichern. | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Betrieb und Fehlersuche|Betrieb und Fehlersuche]] || Protokoll, Statistik, Konsole, Reverse-Proxy und Wartung der Tabellen. | |||
|} | |||
== | === Entwickeln === | ||
{| class="wikitable" | |||
! Seite !! Wofür | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/HTTP-Schnittstelle|HTTP-Schnittstelle]] || Header, Ablauf einer Anfrage, Fehlerformat, Fehlercodes, Rate-Limit und Idempotenz. | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Anmeldung mit JWT|Anmeldung mit JWT]] || Anmelden, Token erneuern, Abmelden und das Anmeldeskript. | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Scripting|Scripting]] || Aufbau der Endpunkt-Skripte mit Reader und Writer. | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Datei-Upload|Datei-Upload]] || Dateien entgegennehmen, auch fortsetzbar in Teilstücken. | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Datei-Download|Datei-Download]] || Dateien ausliefern, auch in Teilen. | |||
|} | |||
=== Beispiele === | |||
Vollständige, lauffähige Anbindungen zum Nachbauen. Übersicht: [[OBS/Kostenpflichtige Module/REST-Server/Beispiele|Beispiele]]. | |||
{| class="wikitable" | |||
! Seite !! Wofür | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Beispiele/Daten-Abruf mit JWT-Anmeldung|Daten-Abruf mit JWT-Anmeldung]] || Daten aus OBS auf einer Webseite anzeigen, mit Anmeldung. | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Beispiele/Datensatz anlegen mit JSON-Körper|Datensatz anlegen mit JSON-Körper]] || Datensätze eines Fremdsystems anlegen, abrufen und ändern. | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Beispiele/Pfad-Parameter|Pfad-Parameter]] || Einzelne Datensätze über Platzhalter im Pfad ansprechen. | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Beispiele/Schreibzugriff mit Statuscodes, ETag und Idempotenz|Schreibzugriff mit Statuscodes, ETag und Idempotenz]] || Sicher schreiben aus einer mobilen App. | |||
|- | |||
| [[OBS/Kostenpflichtige Module/REST-Server/Beispiele/Datei-Upload und Ablage|Datei-Upload und Ablage]] || Fotos und Dokumente zu einem Vorgang hochladen und ablegen. | |||
|} | |||
= | == Grundlagen == | ||
=== Bausteine === | |||
Alle Bausteine pflegen Sie in OBS. Jeder Baustein hat eine eigene Tabelle. | |||
=Protokoll | {| class="wikitable" | ||
! Baustein !! Tabelle !! Zweck | |||
|- | |||
| Server-Profil || <code>RESTSRV_SERVER</code> || TLS-Einstellungen und Grenzen eines eigenen HTTP-Servers. Mehrere Profile sind möglich. | |||
|- | |||
| Bindung || <code>RESTSRV_BINDINGS</code> || IP-Adresse und Port, auf denen ein Server-Profil lauscht. | |||
|- | |||
| Zugang || <code>RESTSRV_ACCOUNT</code> || API-Key, optionale Host- und CORS-Beschränkung, mTLS und JWT-Anmeldung. Einem Server-Profil fest zugeordnet. | |||
|- | |||
| Endpunkt || <code>RESTSRV_ENDPOINTS</code> || Pfad-Template und Skript. Einem Server-Profil fest zugeordnet. | |||
|- | |||
| Berechtigung || <code>RESTSRV_ACCESS</code> || Verbindet Zugang und Endpunkt. | |||
|- | |||
| Idempotenz || <code>RESTSRV_IDEMPOTENCY</code> || Speichert die Antwort zu jedem ''Idempotency-Key''. | |||
|- | |||
| Sitzung || <code>RESTSRV_TOKEN</code> || Sitzungen der JWT-Anmeldung. Grundlage für das sofortige Abmelden. | |||
|- | |||
| Protokoll || <code>RESTSRV_PROTO</code> || Auffälligkeiten: abgewiesene und fehlerhafte Anfragen, Start, Bindungen, Zertifikate, Skriptfehler. | |||
|- | |||
| Statistik || <code>RESTSRV_STATS</code> || Eine Zeile je verarbeiteter Anfrage mit Zugang, Endpunkt, Status und Laufzeit. | |||
|} | |||
=== So läuft eine Anfrage === | |||
# Der Client verbindet sich per HTTPS mit einer Bindung eines Server-Profils. | |||
# Der Server prüft Rate-Limit und Auslastung des Profils. | |||
# Er ordnet die Anfrage über den API-Key einem Zugang zu und prüft Host, Origin und gegebenenfalls das Client-Zertifikat. | |||
# Verlangt der Zugang JWT, prüft er Token und Sitzung. | |||
# Er findet den Endpunkt über das Pfad-Template und prüft die Berechtigung des Zugangs. | |||
# Bei schreibenden Anfragen prüft er den ''Idempotency-Key''. | |||
# Das Skript des Endpunkts läuft. Schreibende Anfragen laufen in einer Datenbanktransaktion. | |||
# Der Server sendet die Antwort mit einer Korrelations-ID und schreibt die Statistik. | |||
Die vollständige Reihenfolge mit allen Statuscodes beschreibt [[OBS/Kostenpflichtige Module/REST-Server/HTTP-Schnittstelle#Ablauf einer Anfrage|HTTP-Schnittstelle]]. | |||
=== Sicherheit === | |||
Der REST-Server ist für den Betrieb im Internet gebaut: | |||
* '''Verschlüsselung ist Pflicht.''' Server-Profile sprechen ausschließlich TLS 1.2 mit Forward Secrecy. Klartext gibt es nur mit dem Haken '''kein SSL (Plain-HTTP - nur für Debug!)'''. Zertifikate erneuert der Dienst auf Wunsch selbst. Siehe [[OBS/Kostenpflichtige Module/REST-Server/Pflege#Server-Profil|Pflege]] und [[OBS/Kostenpflichtige Module/REST-Server/Zertifikatserneuerung|Zertifikatserneuerung]]. | |||
* '''Ein API-Key je Zugang.''' Jeder Zugang sieht nur die Endpunkte, für die er freigeschaltet ist. Zusätzlich beschränken Sie ihn auf einen Host, auf erlaubte Browser-Origins oder per mTLS auf ein Client-Zertifikat. Siehe [[OBS/Kostenpflichtige Module/REST-Server/Pflege#Absicherung eines Zugangs|Pflege]]. | |||
* '''JWT-Anmeldung mit Sitzungen.''' Benutzer melden sich einzeln an. Ein Abmelden wirkt sofort. Siehe [[OBS/Kostenpflichtige Module/REST-Server/Anmeldung mit JWT|Anmeldung mit JWT]]. | |||
* '''Rate-Limit und Andrangsgrenze''' bremsen Missbrauch und Lastspitzen. Gezählt wird je API-Key, ohne Key je IP-Adresse. | |||
* '''Keine Doppelbuchungen.''' Schreibende Anfragen tragen einen ''Idempotency-Key''. Eine Wiederholung wirkt nur einmal. Siehe [[OBS/Kostenpflichtige Module/REST-Server/HTTP-Schnittstelle|HTTP-Schnittstelle]]. | |||
* '''Keine internen Details nach außen.''' Fehlerantworten sind allgemein gehalten. Den Grund findet der Betreiber über die Korrelations-ID im Protokoll. Siehe [[OBS/Kostenpflichtige Module/REST-Server/Betrieb und Fehlersuche|Betrieb und Fehlersuche]]. | |||
Aktuelle Version vom 17. November 2026, 11:53 Uhr
REST-Server
Der REST-Server ist die universelle Schnittstelle Ihrer OBS-Installation nach außen. Webseiten, Apps, Geräte, Kundensysteme und Cloud-Dienste lesen Daten direkt aus OBS oder liefern neue Daten direkt in OBS ab. Diese Seite zeigt, was der REST-Server leistet, und führt Administratoren und Entwickler zu den passenden Unterseiten.
Sie erreichen das Modul über Stammdaten → Z Weitere Stammdaten → REST-Server.
Nutzen
Statt Daten zu exportieren, per Mail zu verschicken und woanders wieder einzulesen, holen sich angebundene Systeme genau die Information, die sie brauchen – in dem Moment, in dem sie sie brauchen. Was bisher nur manuell, per Datei-Import oder über Spezialschnittstellen ging, lässt sich automatisieren. Jeder Anwendungsfall wird einmal eingerichtet und läuft danach von selbst.
Technisch ist der REST-Server ein in OBS integrierter HTTPS-Dienst. Jeder Endpunkt hat eine eigene Adresse, ein eigenes Skript und eigene Berechtigungen. Die Skripte pflegen Sie direkt in OBS. Antworten liefert der Server als JSON oder als Datei. Externe Systeme erhalten keinen Zugriff auf die Datenbank. Sie sehen nur, was ein Endpunkt-Skript freigibt.
Der REST-Server ist damit ein Werkzeugkasten: Was an Daten oder Funktionen in OBS verfügbar ist, können Sie über einen Endpunkt nach außen anbieten oder von außen entgegennehmen. Die Bandbreite reicht vom einfachen Lese-Endpunkt für eine Webseite bis zur B2B-Anbindung mit getrennten Zugängen je Partner.
Was Sie damit erreichen
- Manuelle Arbeit fällt weg. Daten fließen direkt, ohne Export, Mail und Import.
- Weniger Fehler. Jede manuelle Übertragung ist eine Fehlerquelle weniger.
- Neue Angebote werden möglich. Kunden- und Lieferantenportale, Self-Service und Apps greifen auf OBS zu, ohne dass Sie ein zweites System pflegen.
- Bestehende Software bleibt. Vorhandene Anwendungen docken über den REST-Server an OBS an, in beide Richtungen.
- Wächst mit. Ein einzelner Endpunkt für eine Webseite lässt sich zu einer kompletten Integrationsplattform ausbauen, ohne die Grundlage zu wechseln.
Anwendungsbereiche
Die folgenden Einsatzfälle sind Beispiele. Alles, was sich in einem Endpunkt-Skript abbilden lässt, kann der REST-Server bereitstellen.
Webseiten und Kundenportale
- Live-Daten auf der eigenen Webseite: Lagerbestände, Verfügbarkeiten, Preise oder Auftragsstatus direkt aus OBS, ohne tägliche Datei-Exporte.
- Kundenportale: Kunden sehen ihre offenen Posten, Aufträge und Lieferscheine. Jeder Kunde sieht nur seine eigenen Daten.
- Statusseiten: Endkunden fragen den Stand einer Bestellung, eines Auftrags oder einer Reparatur über eine Nummer ab.
Mobile Anwendungen und Außendienst
- Mobile Zeiterfassung: Mitarbeiter buchen Arbeitsbeginn, Pause und Ende am Smartphone. Die Daten landen direkt in OBS.
- Scanner und Lagergeräte: Wareneingang, Inventur und Kommissionierung direkt in OBS, ohne zwischengeschaltete Software.
- Außendienst-Apps: Techniker sehen ihre Aufträge, dokumentieren Einsätze, erfassen Material und laden Fotos hoch.
- Geräte in Sekunden einrichten: Ein Zugangscode als QR-Code bringt Adresse und Zugangsdaten mit einem Scan auf das Gerät.
Anbindung von Drittsystemen
- Webshops: Der Shop meldet Bestellungen direkt an OBS und fragt Bestände und Preise ab.
- Buchhaltungs- und ERP-Systeme: Austausch von Belegen, Stammdaten und Buchungen in beide Richtungen.
- CRM- und Marketing-Werkzeuge: Personendaten, Aktivitäten oder Mailing-Empfänger bleiben abgeglichen.
- Logistikdienstleister: Versandaufträge gehen hinaus, Sendungsinformationen kommen zurück.
Automatische Rückmeldungen (WebHooks)
- Rückruf-Adressen für Fremdsysteme: OBS legt für einen Vorgang eine Adresse an, die genau einmal gilt, z.B. für einen Bezahl- oder Versanddienst. Dessen Rückmeldung landet in OBS und wird dort weiterverarbeitet.
- Automatisierungsplattformen stoßen über gewöhnliche Endpunkte Vorgänge in OBS an.
Geschäftspartner (B2B)
- Lieferanten: Bestellungen gehen automatisch hinaus, Auftragsbestätigungen und Lieferavise kommen zurück.
- Großkunden bestellen direkt aus ihrem eigenen System.
- Maschine-zu-Maschine mit mTLS: Nur Partnersysteme mit einem gültigen Client-Zertifikat sprechen mit OBS.
Interne Automatisierungen
- Eigene Hilfswerkzeuge für Sammelaktionen, Berichte oder zeitgesteuerte Abläufe.
- Mehrere Standorte tauschen Daten über definierte Endpunkte aus, ohne offene Datenbankverbindungen.
- Dashboards und BI-Werkzeuge lesen aufbereitete Kennzahlen direkt aus OBS.
Seiten in diesem Bereich
Einrichten und betreiben
| Seite | Wofür |
|---|---|
| Einrichtung | Schritt für Schritt vom Server-Profil bis zum ersten erfolgreichen Aufruf. |
| Öffentliche Freigabe | Portfreigabe, Reverse-Proxy, VPN und eigener Server im Vergleich. |
| Pflege | Server-Profile, Bindungen, Zugänge und Endpunkte in einem Fenster: TLS, Rate-Limits, Zertifikate, API-Key, CORS, mTLS, JWT, Pfad-Templates und Freischaltungen. |
| Zertifikatserneuerung | Zertifikate automatisch beantragen und erneuern lassen. |
| Zugangscode und Zertifikats-Pin | Geräte per QR-Code einrichten und den Server ohne öffentliches Zertifikat absichern. |
| Betrieb und Fehlersuche | Protokoll, Statistik, Konsole, Reverse-Proxy und Wartung der Tabellen. |
Entwickeln
| Seite | Wofür |
|---|---|
| HTTP-Schnittstelle | Header, Ablauf einer Anfrage, Fehlerformat, Fehlercodes, Rate-Limit und Idempotenz. |
| Anmeldung mit JWT | Anmelden, Token erneuern, Abmelden und das Anmeldeskript. |
| Scripting | Aufbau der Endpunkt-Skripte mit Reader und Writer. |
| Datei-Upload | Dateien entgegennehmen, auch fortsetzbar in Teilstücken. |
| Datei-Download | Dateien ausliefern, auch in Teilen. |
Beispiele
Vollständige, lauffähige Anbindungen zum Nachbauen. Übersicht: Beispiele.
| Seite | Wofür |
|---|---|
| Daten-Abruf mit JWT-Anmeldung | Daten aus OBS auf einer Webseite anzeigen, mit Anmeldung. |
| Datensatz anlegen mit JSON-Körper | Datensätze eines Fremdsystems anlegen, abrufen und ändern. |
| Pfad-Parameter | Einzelne Datensätze über Platzhalter im Pfad ansprechen. |
| Schreibzugriff mit Statuscodes, ETag und Idempotenz | Sicher schreiben aus einer mobilen App. |
| Datei-Upload und Ablage | Fotos und Dokumente zu einem Vorgang hochladen und ablegen. |
Grundlagen
Bausteine
Alle Bausteine pflegen Sie in OBS. Jeder Baustein hat eine eigene Tabelle.
| Baustein | Tabelle | Zweck |
|---|---|---|
| Server-Profil | RESTSRV_SERVER |
TLS-Einstellungen und Grenzen eines eigenen HTTP-Servers. Mehrere Profile sind möglich. |
| Bindung | RESTSRV_BINDINGS |
IP-Adresse und Port, auf denen ein Server-Profil lauscht. |
| Zugang | RESTSRV_ACCOUNT |
API-Key, optionale Host- und CORS-Beschränkung, mTLS und JWT-Anmeldung. Einem Server-Profil fest zugeordnet. |
| Endpunkt | RESTSRV_ENDPOINTS |
Pfad-Template und Skript. Einem Server-Profil fest zugeordnet. |
| Berechtigung | RESTSRV_ACCESS |
Verbindet Zugang und Endpunkt. |
| Idempotenz | RESTSRV_IDEMPOTENCY |
Speichert die Antwort zu jedem Idempotency-Key. |
| Sitzung | RESTSRV_TOKEN |
Sitzungen der JWT-Anmeldung. Grundlage für das sofortige Abmelden. |
| Protokoll | RESTSRV_PROTO |
Auffälligkeiten: abgewiesene und fehlerhafte Anfragen, Start, Bindungen, Zertifikate, Skriptfehler. |
| Statistik | RESTSRV_STATS |
Eine Zeile je verarbeiteter Anfrage mit Zugang, Endpunkt, Status und Laufzeit. |
So läuft eine Anfrage
- Der Client verbindet sich per HTTPS mit einer Bindung eines Server-Profils.
- Der Server prüft Rate-Limit und Auslastung des Profils.
- Er ordnet die Anfrage über den API-Key einem Zugang zu und prüft Host, Origin und gegebenenfalls das Client-Zertifikat.
- Verlangt der Zugang JWT, prüft er Token und Sitzung.
- Er findet den Endpunkt über das Pfad-Template und prüft die Berechtigung des Zugangs.
- Bei schreibenden Anfragen prüft er den Idempotency-Key.
- Das Skript des Endpunkts läuft. Schreibende Anfragen laufen in einer Datenbanktransaktion.
- Der Server sendet die Antwort mit einer Korrelations-ID und schreibt die Statistik.
Die vollständige Reihenfolge mit allen Statuscodes beschreibt HTTP-Schnittstelle.
Sicherheit
Der REST-Server ist für den Betrieb im Internet gebaut:
- Verschlüsselung ist Pflicht. Server-Profile sprechen ausschließlich TLS 1.2 mit Forward Secrecy. Klartext gibt es nur mit dem Haken kein SSL (Plain-HTTP - nur für Debug!). Zertifikate erneuert der Dienst auf Wunsch selbst. Siehe Pflege und Zertifikatserneuerung.
- Ein API-Key je Zugang. Jeder Zugang sieht nur die Endpunkte, für die er freigeschaltet ist. Zusätzlich beschränken Sie ihn auf einen Host, auf erlaubte Browser-Origins oder per mTLS auf ein Client-Zertifikat. Siehe Pflege.
- JWT-Anmeldung mit Sitzungen. Benutzer melden sich einzeln an. Ein Abmelden wirkt sofort. Siehe Anmeldung mit JWT.
- Rate-Limit und Andrangsgrenze bremsen Missbrauch und Lastspitzen. Gezählt wird je API-Key, ohne Key je IP-Adresse.
- Keine Doppelbuchungen. Schreibende Anfragen tragen einen Idempotency-Key. Eine Wiederholung wirkt nur einmal. Siehe HTTP-Schnittstelle.
- Keine internen Details nach außen. Fehlerantworten sind allgemein gehalten. Den Grund findet der Betreiber über die Korrelations-ID im Protokoll. Siehe Betrieb und Fehlersuche.