OBS/Kostenpflichtige Module/RESTServer - Versionsgeschichte

MINERVA-Rademacker: Sicherheitsmerkmale um die automatische Zertifikatserneuerung ergaenzt [Volltext ersetzt]

2026-10-05T06:34:37Z

Sicherheitsmerkmale um die automatische Zertifikatserneuerung ergaenzt [Volltext ersetzt]

← Nächstältere Version		Version vom 5. Oktober 2026, 07:34 Uhr
Zeile 323:		Zeile 323:
	* '''mTLS''' (Mutual TLS): erzwingt, dass jeder Client ein gültiges Client-Zertifikat vorlegt. Optional kann pro Zugang ein erwarteter Subject-DN hinterlegt werden.		* '''mTLS''' (Mutual TLS): erzwingt, dass jeder Client ein gültiges Client-Zertifikat vorlegt. Optional kann pro Zugang ein erwarteter Subject-DN hinterlegt werden.
	* '''DNS-Cache:''' Host-zu-IP-Auflösungen für die Zugangs-Host-Prüfung werden 5 Minuten gecached.		* '''DNS-Cache:''' Host-zu-IP-Auflösungen für die Zugangs-Host-Prüfung werden 5 Minuten gecached.
			* '''Automatische Zertifikatserneuerung:''' Ein TLS-Profil kann sein Zertifikat selbst bei einer Zertifizierungsstelle beantragen und vor Ablauf erneuern. Der Dienst prüft wöchentlich, ob der Server dafür von aussen erreichbar ist, und tauscht das Zertifikat anschliessend ohne Neustart des Dienstes - nur das betroffene Profil startet neu. Siehe [[OBS/Kostenpflichtige Module/RESTServer/Server-Profile\|Server-Profile]].

	==Protokoll==		==Protokoll==

MINERVA-Rademacker: Idempotency-Key als Pflicht, Abschnitt Keep-alive, HSTS, vollstaendige Konsolenbefehle; Ablaufliste und Protokollverhalten berichtigt [Volltext ersetzt]

2026-09-25T09:28:32Z

Idempotency-Key als Pflicht, Abschnitt Keep-alive, HSTS, vollstaendige Konsolenbefehle; Ablaufliste und Protokollverhalten berichtigt [Volltext ersetzt]

Änderungen zeigen

Rademacker am 15. September 2026 um 10:00 Uhr

2026-09-15T10:00:17Z

← Nächstältere Version		Version vom 15. September 2026, 11:00 Uhr
Zeile 123:		Zeile 123:

	Der Server akzeptiert die Methoden '''GET''', '''POST''', '''PUT''', '''DELETE''' und '''PATCH''' sowie '''OPTIONS''' (CORS-Preflight, ohne Skript-Aufruf). Jede Methode wird im Endpunkt-Skript als gleichnamige Funktion implementiert. Siehe [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]].		Der Server akzeptiert die Methoden '''GET''', '''POST''', '''PUT''', '''DELETE''' und '''PATCH''' sowie '''OPTIONS''' (CORS-Preflight, ohne Skript-Aufruf). Jede Methode wird im Endpunkt-Skript als gleichnamige Funktion implementiert. Siehe [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]].

			==Kompression==

			Der Server packt Antworten mit '''gzip''', wenn der Client sie annimmt. Ausgehandelt wird über den Anfrage-Header <code>Accept-Encoding</code>; die Antwort trägt dann <code>Content-Encoding: gzip</code> und <code>Vary: Accept-Encoding</code> - bei einer CORS-Anfrage steht dort <code>Vary: Origin, Accept-Encoding</code>, also '''eine''' Zeile mit beiden Bedingungen. Browser, <code>curl --compressed</code> und die gängigen HTTP-Bibliotheken entpacken selbstständig - für den Konsumenten ändert sich nichts ausser der übertragenen Datenmenge.

			Gepackt wird nur, wo es etwas bringt:

			* Nur JSON, XML, Text, CSV und SVG. Bereits komprimierte Typen - PDF, Bild, ZIP, Video - werden durch gzip '''grösser''', nicht kleiner.
			* Erst ab '''1024 Byte'''. Darunter kostet der gzip-Rahmen mehr, als der Inhalt einspart.
			* '''Nicht''' bei Dateiantworten, nicht bei Teilauslieferungen (206) und nicht bei Antworten ohne Körper (204, 304).
			* Nicht, wenn das Endpunkt-Skript den Header <code>Content-Encoding</code> selbst gesetzt hat - dann gehört die Antwort dem Skript.

			'''deflate''' wird in '''keiner''' Richtung unterstützt. Der Wert ist historisch uneindeutig - die einen senden RFC-1950-gerahmt, die anderen roh -, und wer ihn nennt, beherrscht ohnehin gzip. Eine Anfrage mit <code>Content-Encoding: deflate</code> wird mit 415 abgewiesen.

			Abschalten lässt sich das Packen je Server-Profil über den Haken ''Keine Kompression'' (siehe [[OBS/Kostenpflichtige Module/RESTServer/Server-Profile\|Server-Profile]]). Der Haken betrifft ausschliesslich die Antwortrichtung.

			===Komprimierte Anfragen===

			In der Gegenrichtung nimmt der Server '''gzip''' entgegen: Trägt eine Anfrage den Header <code>Content-Encoding: gzip</code>, wird der Körper entpackt, bevor ihn jemand liest. Das Endpunkt-Skript merkt davon nichts.

			{\| class="wikitable"
			! Anfrage !! Antwort
			\|-
			\| <code>Content-Encoding</code> fehlt oder <code>identity</code> \|\| normale Verarbeitung; ab 10 MB Körpergrösse '''413'''
			\|-
			\| <code>gzip</code> \|\| Körper wird entpackt
			\|-
			\| <code>deflate</code>, anderer Wert (z.B. <code>br</code>) oder mehrere Werte \|\| '''415''' <code>UNSUPPORTED_MEDIA_TYPE</code>
			\|-
			\| Gepackter Körper bei einem Datei-Upload \|\| '''415''' - siehe [[OBS/Kostenpflichtige Module/RESTServer/Datei-Upload\|Datei-Upload]]
			\|-
			\| Entpackter Körper über '''10 MB''' \|\| '''413''' <code>PAYLOAD_TOO_LARGE</code>
			\|-
			\| Entpackter Körper über dem '''400fachen''' der gesendeten Grösse \|\| '''413''' <code>PAYLOAD_TOO_LARGE</code>
			\|}

			{{Hinweis\|Für einen gepackten Anfragekörper gelten '''zwei''' Grenzen. Beide zählen den '''entpackten''' Inhalt, und beide greifen bereits '''während''' des Entpackens - ein Körper, der sie reisst, belegt den Speicher gar nicht erst:

			* '''10 MB''' absolut. Dieselbe Grenze, die auch für einen ungepackten Körper gilt.
			* '''das 400fache''' der gesendeten Grösse. Damit wird eine ''Dekompressionsbombe'' - wenige Kilobyte, die sich auf Hunderte Megabyte aufblähen - schon nach wenigen Prozent abgebrochen.

			Die zweite Grenze trifft normale Nutzlasten nicht. Gemessen erreichen echte JSON-Körper Verhältnisse von 24:1 bis 40:1, und selbst eine Liste aus zehntausenden identischen Zeilen kommt nur auf rund 340:1 - mehr gibt das Verfahren für wiederholte Datensätze nicht her. Über 400:1 kommt nur, wer sehr lange Läufe desselben Zeichens sendet.

			Für Datei-Uploads gilt keine der beiden Grenzen - dort zählt allein die je Endpunkt eingestellte Maximalgrösse.}}

	==Datei-Uploads==		==Datei-Uploads==

Rademacker am 14. September 2026 um 08:06 Uhr

2026-09-14T08:06:51Z

← Nächstältere Version		Version vom 14. September 2026, 09:06 Uhr
Zeile 251:		Zeile 251:
	* [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]] - Aufbau der Endpunkt-Skripte		* [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]] - Aufbau der Endpunkt-Skripte
	* [[OBS/Kostenpflichtige Module/RESTServer/Datei-Upload\|Datei-Upload]] - Übertragungsprotokoll für Dateien (Multipart, resumable)		* [[OBS/Kostenpflichtige Module/RESTServer/Datei-Upload\|Datei-Upload]] - Übertragungsprotokoll für Dateien (Multipart, resumable)
			* [[OBS/Kostenpflichtige Module/RESTServer/Datei-Download\|Datei-Download]] - Dateien ausliefern, Range/Resume, öffentliche Artefakte
	* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel1\|Beispiel 1: Daten-Abruf mit JWT]]		* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel1\|Beispiel 1: Daten-Abruf mit JWT]]
	* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel2\|Beispiel 2: Zeiterfassung als komplette Webanwendung]]		* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel2\|Beispiel 2: Zeiterfassung als komplette Webanwendung]]

Rademacker am 9. September 2026 um 12:30 Uhr

2026-09-09T12:30:07Z

← Nächstältere Version		Version vom 9. September 2026, 13:30 Uhr
Zeile 198:		Zeile 198:
	[[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]].		[[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]].

	{{Achtung\|~~Früher standen~~ ''Fehlercode'', ''Nachricht'' und ''traceId'' ~~zusätzlich~~		{{Achtung\|''Fehlercode'', ''Nachricht'' und ''traceId'' stehen '''nur''' im
	~~flach neben dem~~ ''error''-Objekt~~. Diese Felder sind entfallen~~ - der Wert von		''error''-Objekt, nicht flach daneben - der Wert von
	''Fehlercode'' heisst jetzt ''error.uid'', ''Nachricht'' entspricht		''Fehlercode'' heisst jetzt ''error.uid'', ''Nachricht'' entspricht
	''error.message''. Clients, die die flachen Felder auswerten, müssen angepasst		''error.message''. Clients, die die flachen Felder auswerten, müssen angepasst
Zeile 250:		Zeile 250:
	* [[OBS/Kostenpflichtige Module/RESTServer/Endpunkte\|Endpunkte]] - Verwaltung, Berechtigungen, WebHooks		* [[OBS/Kostenpflichtige Module/RESTServer/Endpunkte\|Endpunkte]] - Verwaltung, Berechtigungen, WebHooks
	* [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]] - Aufbau der Endpunkt-Skripte		* [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]] - Aufbau der Endpunkt-Skripte
			* [[OBS/Kostenpflichtige Module/RESTServer/Datei-Upload\|Datei-Upload]] - Übertragungsprotokoll für Dateien (Multipart, resumable)
	* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel1\|Beispiel 1: Daten-Abruf mit JWT]]		* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel1\|Beispiel 1: Daten-Abruf mit JWT]]
	* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel2\|Beispiel 2: Zeiterfassung als komplette Webanwendung]]		* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel2\|Beispiel 2: Zeiterfassung als komplette Webanwendung]]

Rademacker am 19. August 2026 um 12:00 Uhr

2026-08-19T12:00:36Z

← Nächstältere Version		Version vom 19. August 2026, 13:00 Uhr
Zeile 162:		Zeile 162:
	Eigenschaften:		Eigenschaften:

	* '''Abmelden wirkt sofort.''' Ein Endpunkt~~-Skript~~ sperrt die ~~laufende~~ Sitzung ~~mit einem einzigen Antwortfeld (''_OBS_JWT_REVOKE'')~~; alle Token dieser Sitzung sind damit unmittelbar ungültig, auch die noch nicht abgelaufenen.		* '''Abmelden wirkt sofort.''' Ein ''DELETE'' auf den JWT-Endpunkt sperrt die Sitzung; alle Token dieser Sitzung sind damit unmittelbar ungültig, auch die noch nicht abgelaufenen. Anmelden, Erneuern und Abmelden laufen also über einen einzigen Endpunkt, und für das Abmelden ist kein Skript nötig.
	* '''Ein Refresh-Token gilt genau einmal.''' Beim Erneuern wird es entwertet. Wird es später erneut vorgelegt, gilt das als Diebstahl oder Fehlfunktion: die betroffene Sitzung wird komplett gesperrt und der Vorfall protokolliert.		* '''Ein Refresh-Token gilt genau einmal.''' Beim Erneuern wird es entwertet. Wird es später erneut vorgelegt, gilt das als Diebstahl oder Fehlfunktion: die betroffene Sitzung wird komplett gesperrt und der Vorfall protokolliert.
	* '''Alle Geräte abmelden.''' ~~Über dasselbe Feld lassen sich~~ auch alle Sitzungen eines Benutzers sperren - der Support-Fall „Gerät verloren".		* '''Alle Geräte abmelden.''' Ein gewöhnlicher Endpunkt kann über das Antwortfeld ''_OBS_JWT_REVOKE'' auch alle Sitzungen eines Benutzers sperren - der Support-Fall „Gerät verloren".

	{{Achtung\|Mit der Einführung dieser Prüfung verlieren '''alle vorher		{{Achtung\|Mit der Einführung dieser Prüfung verlieren '''alle vorher

Rademacker am 19. August 2026 um 10:13 Uhr

2026-08-19T10:13:38Z

@@ Zeile 85: / Zeile 85: @@
 |-
 | Idempotenz   || RESTSRV_IDEMPOTENCY  || Speicher für Idempotency-Keys und die dazu gelieferte Antwort
 |-
 | Protokoll    || RESTSRV_PROTO        || Laufende Ereignisse, Fehler, Audit-Einträge
@@ Zeile 96: / Zeile 98: @@
 # Authentifizierung über den API-Key (Header ''apikey'')
 # CORS-Prüfung (sofern ''Origin''-Header gesetzt)
-# Optional: JWT-Prüfung (sofern für den Zugang aktiviert)
+# Optional: JWT-Prüfung - Signatur, Ablauf und Sitzung (sofern für den Zugang aktiviert)
 # Routing: Auflösung des Pfads über die Pfad-Templates der Endpunkte
 # Prüfung der Berechtigung (Zugang -> Endpunkt)
@@ Zeile 148: / Zeile 150: @@
 Details und die Statuscodes: [[OBS/Kostenpflichtige Module/RESTServer/Scripting|Scripting]].
 ==Fehlerformat==
@@ Zeile 186: / Zeile 211: @@
 * '''Body-Limit:''' max. 10 MB Request-Body (JSON), max. 1024 Zeichen pro Header- oder Query-Parameter. Datei-Uploads laufen über einen separaten Pfad und sind pro Endpunkt auf <code>re_upload_size</code> MB begrenzt (Standard 25&nbsp;MB).
 * '''Sensible Felder''' (''password'', ''token'', ''secret'', ''apikey'', ''authorization'', ''cookie'', ...) werden in Protokoll-Ausgaben automatisch maskiert.
 * '''Reserviertes Präfix:''' Parameter-Namen mit Präfix ''_OBS_'' können von aussen nicht gesetzt werden, sie sind für den Server reserviert (z.B. JWT-Claims).
 * '''Geblockte Header:''' ''authorization'', ''cookie'', ''proxy-authorization'', ''x-forwarded-for'', ''x-real-ip'', ''apikey'', ''api_key'' werden nicht an das Skript durchgereicht.

Rademacker: /* Fehlerformat */

2026-08-18T06:02:45Z

Fehlerformat

← Nächstältere Version		Version vom 18. August 2026, 07:02 Uhr
Zeile 156:		Zeile 156:
	<pre>		<pre>
	{		{



	"error": {		"error": {
	"code": "AUTH_EXPIRED",		"code": "AUTH_EXPIRED",

Rademacker am 18. August 2026 um 06:02 Uhr

2026-08-18T06:02:12Z

← Nächstältere Version		Version vom 18. August 2026, 07:02 Uhr
Zeile 151:		Zeile 151:
	==Fehlerformat==		==Fehlerformat==

	Jede Fehlerantwort des Servers hat dieselbe Form~~. Neben den bisherigen Feldern~~		Jede Fehlerantwort des Servers hat dieselbe Form: ein einziges ''error''-Objekt
	~~steht~~ ein ''error''-Objekt mit maschinenlesbarem Code, Meldung und Korrelations-ID:		mit maschinenlesbarem Code, Support-Kennung, Meldung und Korrelations-ID:

	<pre>		<pre>
	{		{
	~~"Fehlercode": "Y00E2RTPDY",~~
	~~"Nachricht": "Ungültiges oder abgelaufenes Token",~~
	~~"traceId": "20260817T091233123-00001A",~~
	"error": {		"error": {
	"code": "AUTH_EXPIRED",		"code": "AUTH_EXPIRED",
			"uid": "Y00E2RTPDY",
	"message": "Ungültiges oder abgelaufenes Token",		"message": "Ungültiges oder abgelaufenes Token",
	"traceId": "20260817T091233123-00001A"		"traceId": "20260817T091233123-00001A"
Zeile 167:		Zeile 168:
	</pre>		</pre>

	~~Die Felder ''Fehlercode'~~' ~~und ''Nachricht'' bleiben erhalten - bestehende~~		* '''code''' - sprechender Bezeichner (z.B. ''AUTH_EXPIRED'', ''NOT_FOUND'', ''RATE_LIMITED'', ''INTERNAL_ERROR''), an dem ein Client seine Reaktion festmachen kann, ohne Texte auszuwerten.
	~~Konsumenten müssen nicht angepasst werden. Der~~ ''code'~~' im ''error~~''-~~Objekt ist~~		* '''uid''' - OBS-Kennung der Codestelle. Für die Support-Recherche gedacht, nicht zur Auswertung im Client.
	~~ein~~ sprechender Bezeichner (z.B. ''AUTH_EXPIRED'', ''NOT_FOUND'',		* '''message''' - Text für den Client. Interne Fehlerdetails stehen nie darin, sondern ausschliesslich im Protokoll '''RESTSRV_PROTO'''.
	''RATE_LIMITED'', ''INTERNAL_ERROR''), an dem ein Client seine Reaktion		* '''traceId''' - Korrelations-ID. Steht zusätzlich im Header ''X-Trace-Id'' und in jeder zugehörigen Logzeile.
	festmachen kann, ohne Texte auszuwerten. Ein Endpunkt-Skript kann eigene Codes
	setzen; siehe [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]].		Ein Endpunkt-Skript kann eigene Codes setzen; siehe
			[[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]].

			{{Achtung\|Früher standen ''Fehlercode'', ''Nachricht'' und ''traceId'' zusätzlich
			flach neben dem ''error''-Objekt. Diese Felder sind entfallen - der Wert von
			''Fehlercode'' heisst jetzt ''error.uid'', ''Nachricht'' entspricht
			''error.message''. Clients, die die flachen Felder auswerten, müssen angepasst
			werden.}}

	==Sicherheitsmerkmale==		==Sicherheitsmerkmale==

Rademacker am 17. August 2026 um 06:48 Uhr

2026-08-17T06:48:48Z

← Nächstältere Version		Version vom 17. August 2026, 07:48 Uhr
Zeile 83:		Zeile 83:
	\|-		\|-
	\| Berechtigung \|\| RESTSRV_ACCESS \|\| Verbindet Zugang und Endpunkt		\| Berechtigung \|\| RESTSRV_ACCESS \|\| Verbindet Zugang und Endpunkt
			\|-
			\| Idempotenz \|\| RESTSRV_IDEMPOTENCY \|\| Speicher für Idempotency-Keys und die dazu gelieferte Antwort
	\|-		\|-
	\| Protokoll \|\| RESTSRV_PROTO \|\| Laufende Ereignisse, Fehler, Audit-Einträge		\| Protokoll \|\| RESTSRV_PROTO \|\| Laufende Ereignisse, Fehler, Audit-Einträge
Zeile 91:		Zeile 93:
	Eine Anfrage durchläuft folgende Stationen:		Eine Anfrage durchläuft folgende Stationen:

	# Rate-Limit-Prüfung (pro API-Key bzw. IP und global)		# Rate-Limit-Prüfung (pro API-Key bzw. IP und global, Schwellen je Server-Profil)
	# Authentifizierung über den API-Key (Header ''apikey'')		# Authentifizierung über den API-Key (Header ''apikey'')
	# CORS-Prüfung (sofern ''Origin''-Header gesetzt)		# CORS-Prüfung (sofern ''Origin''-Header gesetzt)
Zeile 97:		Zeile 99:
	# Routing: Auflösung des Pfads über die Pfad-Templates der Endpunkte		# Routing: Auflösung des Pfads über die Pfad-Templates der Endpunkte
	# Prüfung der Berechtigung (Zugang -> Endpunkt)		# Prüfung der Berechtigung (Zugang -> Endpunkt)
			# Idempotenz-Prüfung (nur bei POST/PUT/PATCH/DELETE '''mit''' ''Idempotency-Key''-Header)
	# Ausführung des Endpunkt-Skripts (oder WebHook-Antwort)		# Ausführung des Endpunkt-Skripts (oder WebHook-Antwort)
			# Festschreiben des Ergebnisses im Idempotenz-Speicher (sofern in Schritt 7 reserviert)
	# JSON-Antwort, Statistik-Eintrag, Protokoll-Eintrag		# JSON-Antwort, Statistik-Eintrag, Protokoll-Eintrag

Zeile 128:		Zeile 132:
	Verarbeitung (z.B. DMS-Ablage) übernimmt das Skript. Details:		Verarbeitung (z.B. DMS-Ablage) übernimmt das Skript. Details:
	[[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]].		[[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]].

			==Doppelte Sendungen abfangen (Idempotenz)==

			Ein Client, der nach einem Timeout dieselbe Anfrage erneut schickt, darf keine
			Zweitbuchung auslösen. Der Server erledigt das selbst: Sendet ein Aufruf mit
			'''POST''', '''PUT''', '''PATCH''' oder '''DELETE''' den Header
			<code>Idempotency-Key</code>, merkt sich der Server Schlüssel und Ergebnis in
			'''RESTSRV_IDEMPOTENCY'''. Eine Wiederholung mit demselben Schlüssel und demselben
			Inhalt bekommt die '''gespeicherte Antwort''' zurück - das Endpunkt-Skript läuft
			gar nicht erst an.

			* '''Ohne den Header ändert sich nichts.''' Bestehende Endpunkte verhalten sich unverändert.
			* '''Kein Schalter am Endpunkt.''' Die Mechanik greift automatisch, sobald der Header anliegt.
			* '''Das Skript muss nichts tun.''' Eine eigene Idempotenz-Logik im Skript ist nicht mehr nötig.

			Details und die Statuscodes: [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]].

			==Fehlerformat==

			Jede Fehlerantwort des Servers hat dieselbe Form. Neben den bisherigen Feldern
			steht ein ''error''-Objekt mit maschinenlesbarem Code, Meldung und Korrelations-ID:

			<pre>
			{
			"Fehlercode": "Y00E2RTPDY",
			"Nachricht": "Ungültiges oder abgelaufenes Token",
			"traceId": "20260817T091233123-00001A",
			"error": {
			"code": "AUTH_EXPIRED",
			"message": "Ungültiges oder abgelaufenes Token",
			"traceId": "20260817T091233123-00001A"
			}
			}
			</pre>

			Die Felder ''Fehlercode'' und ''Nachricht'' bleiben erhalten - bestehende
			Konsumenten müssen nicht angepasst werden. Der ''code'' im ''error''-Objekt ist
			ein sprechender Bezeichner (z.B. ''AUTH_EXPIRED'', ''NOT_FOUND'',
			''RATE_LIMITED'', ''INTERNAL_ERROR''), an dem ein Client seine Reaktion
			festmachen kann, ohne Texte auszuwerten. Ein Endpunkt-Skript kann eigene Codes
			setzen; siehe [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]].

	==Sicherheitsmerkmale==		==Sicherheitsmerkmale==

	Der REST-Server enthält eine Reihe ~~fest verdrahteter~~ Schutzmechanismen:		Der REST-Server enthält eine Reihe von Schutzmechanismen:

	* '''Rate-Limit:''' max. 10 fehlgeschlagene und 120 erfolgreiche Anfragen pro API-Key (Account) bzw. IP und 60 Sekunden, max. 600 Anfragen global pro 60 Sekunden. Beim Überschreiten wird HTTP 429 mit ''Retry-After''-Header zurückgegeben. Die Schwellen ~~sind serverseitig konfigurierbar~~.		* '''Rate-Limit:''' Standardmässig max. 10 fehlgeschlagene und 120 erfolgreiche Anfragen pro API-Key (Account) bzw. IP und 60 Sekunden, max. 600 Anfragen global pro 60 Sekunden. Beim Überschreiten wird HTTP 429 mit ''Retry-After''-Header zurückgegeben. Die vier Schwellen lassen sich '''pro Server-Profil''' hinterlegen; die Zähler laufen ebenfalls getrennt je Profil, ein überlastetes Profil bremst das andere also nicht mit aus. Siehe [[OBS/Kostenpflichtige Module/RESTServer/Server-Profile\|Server-Profile]].
	* '''Body-Limit:''' max. 10 MB Request-Body (JSON), max. 1024 Zeichen pro Header- oder Query-Parameter. Datei-Uploads laufen über einen separaten Pfad und sind pro Endpunkt auf <code>re_upload_size</code> MB begrenzt (Standard 25 MB).		* '''Body-Limit:''' max. 10 MB Request-Body (JSON), max. 1024 Zeichen pro Header- oder Query-Parameter. Datei-Uploads laufen über einen separaten Pfad und sind pro Endpunkt auf <code>re_upload_size</code> MB begrenzt (Standard 25 MB).
	* '''Sensible Felder''' (''password'', ''token'', ''secret'', ''apikey'', ''authorization'', ''cookie'', ...) werden in Protokoll-Ausgaben automatisch maskiert.		* '''Sensible Felder''' (''password'', ''token'', ''secret'', ''apikey'', ''authorization'', ''cookie'', ...) werden in Protokoll-Ausgaben automatisch maskiert.
Zeile 144:		Zeile 189:
	==Protokoll==		==Protokoll==

	Die Tabelle '''RESTSRV_PROTO''' enthält alle relevanten Ereignisse: erfolgreiche und abgelehnte Anfragen, TLS-/JWT-Fehler, Bindungs-Ereignisse, Skript-Fehler. Einträge sind nach Datum, Uhrzeit und Host (IP oder Account-Name) sortiert. Das Protokoll ist die erste Anlaufstelle bei Störungen. Jede Antwort ~~trÄgt~~ zudem eine Korrelations-ID (Response-Header ''X-Trace-Id''), die in den Protokoll-~~EintrÄgen~~ wiederzufinden ist.		Die Tabelle '''RESTSRV_PROTO''' enthält alle relevanten Ereignisse: erfolgreiche und abgelehnte Anfragen, TLS-/JWT-Fehler, Bindungs-Ereignisse, Skript-Fehler. Einträge sind nach Datum, Uhrzeit und Host (IP oder Account-Name) sortiert. Das Protokoll ist die erste Anlaufstelle bei Störungen. Jede Antwort trägt zudem eine Korrelations-ID (Response-Header ''X-Trace-Id''), die in den Protokoll-Einträgen wiederzufinden ist.

	==Statistik==		==Statistik==
Zeile 174:		Zeile 219:
	* [[OBS/Kostenpflichtige Module/RESTServer/Endpunkte\|Endpunkte]] - Verwaltung, Berechtigungen, WebHooks		* [[OBS/Kostenpflichtige Module/RESTServer/Endpunkte\|Endpunkte]] - Verwaltung, Berechtigungen, WebHooks
	* [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]] - Aufbau der Endpunkt-Skripte		* [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]] - Aufbau der Endpunkt-Skripte
	* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel1\|Beispiel: Daten-Abruf mit JWT]]		* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel1\|Beispiel 1: Daten-Abruf mit JWT]]
	* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel2\|Beispiel: Datensatz anlegen mit JSON-Body]]		* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel2\|Beispiel 2: Zeiterfassung als komplette Webanwendung]]
	* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel4\|Beispiel: Pfad-Parameter im Routing]]		* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel3\|Beispiel 3: Datensatz anlegen mit JSON-Body (CRUD)]]
	* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel5\|Beispiel: Schreibzugriff mit Statuscodes, ETag und Idempotenz]]		* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel4\|Beispiel 4: Pfad-Parameter im Routing]]
			* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel5\|Beispiel 5: Schreibzugriff mit Statuscodes, ETag und Idempotenz]]
			* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel6\|Beispiel 6: Datei-Upload und Ablage im DMS]]

← Nächstältere Version		Version vom 14. September 2026, 09:06 Uhr
Zeile 251:		Zeile 251:
	* [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]] - Aufbau der Endpunkt-Skripte		* [[OBS/Kostenpflichtige Module/RESTServer/Scripting\|Scripting]] - Aufbau der Endpunkt-Skripte
	* [[OBS/Kostenpflichtige Module/RESTServer/Datei-Upload\|Datei-Upload]] - Übertragungsprotokoll für Dateien (Multipart, resumable)		* [[OBS/Kostenpflichtige Module/RESTServer/Datei-Upload\|Datei-Upload]] - Übertragungsprotokoll für Dateien (Multipart, resumable)
			* [[OBS/Kostenpflichtige Module/RESTServer/Datei-Download\|Datei-Download]] - Dateien ausliefern, Range/Resume, öffentliche Artefakte
	* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel1\|Beispiel 1: Daten-Abruf mit JWT]]		* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel1\|Beispiel 1: Daten-Abruf mit JWT]]
	* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel2\|Beispiel 2: Zeiterfassung als komplette Webanwendung]]		* [[OBS/Kostenpflichtige Module/RESTServer/Beispiel2\|Beispiel 2: Zeiterfassung als komplette Webanwendung]]