<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="de">
	<id>https://wiki.bergau.de/index.php?action=history&amp;feed=atom&amp;title=OBS%2FKostenpflichtige_Module%2FREST-Server%2FBetrieb_und_Fehlersuche</id>
	<title>OBS/Kostenpflichtige Module/REST-Server/Betrieb und Fehlersuche - Versionsgeschichte</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.bergau.de/index.php?action=history&amp;feed=atom&amp;title=OBS%2FKostenpflichtige_Module%2FREST-Server%2FBetrieb_und_Fehlersuche"/>
	<link rel="alternate" type="text/html" href="https://wiki.bergau.de/index.php?title=OBS/Kostenpflichtige_Module/REST-Server/Betrieb_und_Fehlersuche&amp;action=history"/>
	<updated>2026-11-18T20:14:32Z</updated>
	<subtitle>Versionsgeschichte dieser Seite in OBS Wiki</subtitle>
	<generator>MediaWiki 1.43.11</generator>
	<entry>
		<id>https://wiki.bergau.de/index.php?title=OBS/Kostenpflichtige_Module/REST-Server/Betrieb_und_Fehlersuche&amp;diff=67479&amp;oldid=prev</id>
		<title>MINERVA-Rademacker: Protokoll und Statistik über F10/F8 in der Pflege, API_KEY_INVALID bei fremdem Server-Profil; Link auf Pflege [Volltext ersetzt]</title>
		<link rel="alternate" type="text/html" href="https://wiki.bergau.de/index.php?title=OBS/Kostenpflichtige_Module/REST-Server/Betrieb_und_Fehlersuche&amp;diff=67479&amp;oldid=prev"/>
		<updated>2026-11-17T10:53:42Z</updated>

		<summary type="html">&lt;p&gt;Protokoll und Statistik über F10/F8 in der Pflege, API_KEY_INVALID bei fremdem Server-Profil; Link auf Pflege [Volltext ersetzt]&lt;/p&gt;
&lt;table style=&quot;background-color: #fff; color: #202122;&quot; data-mw=&quot;interface&quot;&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;tr class=&quot;diff-title&quot; lang=&quot;de&quot;&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;← Nächstältere Version&lt;/td&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;Version vom 17. November 2026, 11:53 Uhr&lt;/td&gt;
				&lt;/tr&gt;&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot; id=&quot;mw-diff-left-l7&quot;&gt;Zeile 7:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Zeile 7:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;== Protokoll ==&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;== Protokoll ==&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;−&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;Die Tabelle &amp;lt;code&amp;gt;RESTSRV_PROTO&amp;lt;/code&amp;gt; enthält die &#039;&#039;&#039;Auffälligkeiten&#039;&#039;&#039; des Betriebs. Erfolgreiche Anfragen stehen dort nicht, sie stehen in der [[#Statistik|Statistik]]. Ausgenommen sind einzelne Ereignisse wie Anmeldungen am JWT-Endpunkt, siehe [[#Typische Meldungen|Typische Meldungen]].&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;Die Tabelle &amp;lt;code&amp;gt;RESTSRV_PROTO&amp;lt;/code&amp;gt; enthält die &#039;&#039;&#039;Auffälligkeiten&#039;&#039;&#039; des Betriebs&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;. Das Protokoll öffnen Sie in OBS in der Liste der Server-Profile der [[OBS/Kostenpflichtige Module/REST-Server/Pflege|Pflege]] mit {{F10}} und &#039;&#039;A Protokoll&#039;&#039;&lt;/ins&gt;. Erfolgreiche Anfragen stehen dort nicht, sie stehen in der [[#Statistik|Statistik]]. Ausgenommen sind einzelne Ereignisse wie Anmeldungen am JWT-Endpunkt, siehe [[#Typische Meldungen|Typische Meldungen]].&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;Ins Protokoll gehen:&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;Ins Protokoll gehen:&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot; id=&quot;mw-diff-left-l147&quot;&gt;Zeile 147:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Zeile 147:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;== Statistik ==&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;== Statistik ==&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;−&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;Die Tabelle &amp;lt;code&amp;gt;RESTSRV_STATS&amp;lt;/code&amp;gt; enthält eine Zeile je Anfrage, die bis zur Verarbeitung kommt. Dazu gehören auch Anfragen, die bei der Authentifizierung abgewiesen werden. Die Statistik zeigt damit alle verarbeiteten Anfragen, das Protokoll die Auffälligkeiten. In OBS öffnet {{F8}} in der &lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;Liste der [[OBS/Kostenpflichtige Module/REST&lt;/del&gt;-&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;Server/&lt;/del&gt;Zugänge&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;|Zugänge]] bzw. &lt;/del&gt;der [[OBS/Kostenpflichtige Module/REST-Server/&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;Endpunkte&lt;/del&gt;|&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;Endpunkte&lt;/del&gt;]] die Statistik des markierten Eintrags.&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;Die Tabelle &amp;lt;code&amp;gt;RESTSRV_STATS&amp;lt;/code&amp;gt; enthält eine Zeile je Anfrage, die bis zur Verarbeitung kommt. Dazu gehören auch Anfragen, die bei der Authentifizierung abgewiesen werden. Die Statistik zeigt damit alle verarbeiteten Anfragen, das Protokoll die Auffälligkeiten. In OBS öffnet {{F8}} in &lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;den Listen &lt;/ins&gt;der &lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;Server&lt;/ins&gt;-&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;Profile, &lt;/ins&gt;Zugänge &lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;und Endpunkte &lt;/ins&gt;der [[OBS/Kostenpflichtige Module/REST-Server/&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;Pflege&lt;/ins&gt;|&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;Pflege&lt;/ins&gt;]] die Statistik des markierten Eintrags&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;. Die Statistik aller Anfragen öffnet {{F10}} in der Liste der Server-Profile mit &#039;&#039;B Statistik&#039;&#039;&lt;/ins&gt;.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;{| class=&amp;quot;wikitable&amp;quot;&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;{| class=&amp;quot;wikitable&amp;quot;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot; id=&quot;mw-diff-left-l241&quot;&gt;Zeile 241:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Zeile 241:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;| 401 &amp;lt;code&amp;gt;CLIENT_CERT_INVALID&amp;lt;/code&amp;gt; || Das Client-Zertifikat passt nicht zum &amp;#039;&amp;#039;&amp;#039;mTLS-Subject&amp;#039;&amp;#039;&amp;#039; des Zugangs || &amp;#039;&amp;#039;&amp;#039;mTLS-Subject&amp;#039;&amp;#039;&amp;#039; oder Client-Zertifikat korrigieren&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;| 401 &amp;lt;code&amp;gt;CLIENT_CERT_INVALID&amp;lt;/code&amp;gt; || Das Client-Zertifikat passt nicht zum &amp;#039;&amp;#039;&amp;#039;mTLS-Subject&amp;#039;&amp;#039;&amp;#039; des Zugangs || &amp;#039;&amp;#039;&amp;#039;mTLS-Subject&amp;#039;&amp;#039;&amp;#039; oder Client-Zertifikat korrigieren&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;|-&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;|-&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;−&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;| 401 &amp;lt;code&amp;gt;API_KEY_INVALID&amp;lt;/code&amp;gt; || API-Key unbekannt, oder nach einem Schlüsseltausch ist die Frist des vorherigen Keys abgelaufen || &#039;&#039;&#039;API-Key&#039;&#039;&#039; im Zugang prüfen. Neuen Zugangscode ausgeben&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;| 401 &amp;lt;code&amp;gt;API_KEY_INVALID&amp;lt;/code&amp;gt; || API-Key unbekannt&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;, Zugang gehört zu einem anderen Server-Profil&lt;/ins&gt;, oder nach einem Schlüsseltausch ist die Frist des vorherigen Keys abgelaufen || &#039;&#039;&#039;API-Key&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&#039;&#039;&#039; und &#039;&#039;&#039;Server&lt;/ins&gt;&#039;&#039;&#039; im Zugang prüfen. Neuen Zugangscode ausgeben&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;|-&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;|-&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;| 403 &amp;lt;code&amp;gt;FORBIDDEN_ROLE&amp;lt;/code&amp;gt; „Zugriff verweigert“ || Zugang nicht &amp;#039;&amp;#039;&amp;#039;Aktiv&amp;#039;&amp;#039;&amp;#039;, Anfrage nicht vom eingetragenen &amp;#039;&amp;#039;&amp;#039;Host&amp;#039;&amp;#039;&amp;#039;, &amp;#039;&amp;#039;&amp;#039;CORS-Origin&amp;#039;&amp;#039;&amp;#039; nicht erlaubt oder Zugang für den Endpunkt nicht freigeschaltet || Grund im Protokoll nachlesen, dann Zugang bzw. Freischaltung korrigieren&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;| 403 &amp;lt;code&amp;gt;FORBIDDEN_ROLE&amp;lt;/code&amp;gt; „Zugriff verweigert“ || Zugang nicht &amp;#039;&amp;#039;&amp;#039;Aktiv&amp;#039;&amp;#039;&amp;#039;, Anfrage nicht vom eingetragenen &amp;#039;&amp;#039;&amp;#039;Host&amp;#039;&amp;#039;&amp;#039;, &amp;#039;&amp;#039;&amp;#039;CORS-Origin&amp;#039;&amp;#039;&amp;#039; nicht erlaubt oder Zugang für den Endpunkt nicht freigeschaltet || Grund im Protokoll nachlesen, dann Zugang bzw. Freischaltung korrigieren&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot; id=&quot;mw-diff-left-l348&quot;&gt;Zeile 348:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Zeile 348:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* [[OBS/Kostenpflichtige Module/REST-Server/HTTP-Schnittstelle|HTTP-Schnittstelle]]&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* [[OBS/Kostenpflichtige Module/REST-Server/HTTP-Schnittstelle|HTTP-Schnittstelle]]&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* [[OBS/Kostenpflichtige Module/REST-Server/Anmeldung mit JWT|Anmeldung mit JWT]]&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* [[OBS/Kostenpflichtige Module/REST-Server/Anmeldung mit JWT|Anmeldung mit JWT]]&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;−&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* [[OBS/Kostenpflichtige Module/REST-Server/&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;Server-Profile&lt;/del&gt;|&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;Server-Profile&lt;/del&gt;]]&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* [[OBS/Kostenpflichtige Module/REST-Server/&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;Pflege&lt;/ins&gt;|&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;Pflege&lt;/ins&gt;]]&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* [[OBS/Kostenpflichtige Module/REST-Server/Zertifikatserneuerung|Zertifikatserneuerung]]&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* [[OBS/Kostenpflichtige Module/REST-Server/Zertifikatserneuerung|Zertifikatserneuerung]]&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* [[OBS/Kostenpflichtige Module/REST-Server/Öffentliche Freigabe|Öffentliche Freigabe]]&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;* [[OBS/Kostenpflichtige Module/REST-Server/Öffentliche Freigabe|Öffentliche Freigabe]]&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;</summary>
		<author><name>MINERVA-Rademacker</name></author>
	</entry>
	<entry>
		<id>https://wiki.bergau.de/index.php?title=OBS/Kostenpflichtige_Module/REST-Server/Betrieb_und_Fehlersuche&amp;diff=67467&amp;oldid=prev</id>
		<title>MINERVA-Rademacker: Statistik: Aufruf über F8 in den Listen Zugänge und Endpunkte ergänzt [Volltext ersetzt]</title>
		<link rel="alternate" type="text/html" href="https://wiki.bergau.de/index.php?title=OBS/Kostenpflichtige_Module/REST-Server/Betrieb_und_Fehlersuche&amp;diff=67467&amp;oldid=prev"/>
		<updated>2026-11-17T06:36:10Z</updated>

		<summary type="html">&lt;p&gt;Statistik: Aufruf über F8 in den Listen Zugänge und Endpunkte ergänzt [Volltext ersetzt]&lt;/p&gt;
&lt;table style=&quot;background-color: #fff; color: #202122;&quot; data-mw=&quot;interface&quot;&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;tr class=&quot;diff-title&quot; lang=&quot;de&quot;&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;← Nächstältere Version&lt;/td&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;Version vom 17. November 2026, 07:36 Uhr&lt;/td&gt;
				&lt;/tr&gt;&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot; id=&quot;mw-diff-left-l147&quot;&gt;Zeile 147:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Zeile 147:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;== Statistik ==&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;== Statistik ==&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;−&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;Die Tabelle &amp;lt;code&amp;gt;RESTSRV_STATS&amp;lt;/code&amp;gt; enthält eine Zeile je Anfrage, die bis zur Verarbeitung kommt. Dazu gehören auch Anfragen, die bei der Authentifizierung abgewiesen werden. Die Statistik zeigt damit alle verarbeiteten Anfragen, das Protokoll die Auffälligkeiten.&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;Die Tabelle &amp;lt;code&amp;gt;RESTSRV_STATS&amp;lt;/code&amp;gt; enthält eine Zeile je Anfrage, die bis zur Verarbeitung kommt. Dazu gehören auch Anfragen, die bei der Authentifizierung abgewiesen werden. Die Statistik zeigt damit alle verarbeiteten Anfragen, das Protokoll die Auffälligkeiten&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;. In OBS öffnet {{F8}} in der Liste der [[OBS/Kostenpflichtige Module/REST-Server/Zugänge|Zugänge]] bzw. der [[OBS/Kostenpflichtige Module/REST-Server/Endpunkte|Endpunkte]] die Statistik des markierten Eintrags&lt;/ins&gt;.&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;{| class=&amp;quot;wikitable&amp;quot;&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;{| class=&amp;quot;wikitable&amp;quot;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;</summary>
		<author><name>MINERVA-Rademacker</name></author>
	</entry>
	<entry>
		<id>https://wiki.bergau.de/index.php?title=OBS/Kostenpflichtige_Module/REST-Server/Betrieb_und_Fehlersuche&amp;diff=67457&amp;oldid=prev</id>
		<title>MINERVA-Rademacker: Links auf die neuen Titel (REST-Server, Zugänge, Beispiele) umgestellt, zitierte Meldungen mit Umlauten wie im Programm [Volltext ersetzt]</title>
		<link rel="alternate" type="text/html" href="https://wiki.bergau.de/index.php?title=OBS/Kostenpflichtige_Module/REST-Server/Betrieb_und_Fehlersuche&amp;diff=67457&amp;oldid=prev"/>
		<updated>2026-11-17T06:23:52Z</updated>

		<summary type="html">&lt;p&gt;Links auf die neuen Titel (REST-Server, Zugänge, Beispiele) umgestellt, zitierte Meldungen mit Umlauten wie im Programm [Volltext ersetzt]&lt;/p&gt;
&lt;a href=&quot;https://wiki.bergau.de/index.php?title=OBS/Kostenpflichtige_Module/REST-Server/Betrieb_und_Fehlersuche&amp;amp;diff=67457&amp;amp;oldid=67418&quot;&gt;Änderungen zeigen&lt;/a&gt;</summary>
		<author><name>MINERVA-Rademacker</name></author>
	</entry>
	<entry>
		<id>https://wiki.bergau.de/index.php?title=OBS/Kostenpflichtige_Module/REST-Server/Betrieb_und_Fehlersuche&amp;diff=67418&amp;oldid=prev</id>
		<title>MINERVA-Rademacker: MINERVA-Rademacker verschob die Seite OBS/Kostenpflichtige Module/RESTServer/Betrieb und Fehlersuche nach OBS/Kostenpflichtige Module/REST-Server/Betrieb und Fehlersuche: Titel an Überschrift angeglichen (REST-Server, Umlaute, sprechende Beispieltitel)</title>
		<link rel="alternate" type="text/html" href="https://wiki.bergau.de/index.php?title=OBS/Kostenpflichtige_Module/REST-Server/Betrieb_und_Fehlersuche&amp;diff=67418&amp;oldid=prev"/>
		<updated>2026-11-17T06:14:13Z</updated>

		<summary type="html">&lt;p&gt;MINERVA-Rademacker verschob die Seite &lt;a href=&quot;/OBS/Kostenpflichtige_Module/RESTServer/Betrieb_und_Fehlersuche&quot; class=&quot;mw-redirect&quot; title=&quot;OBS/Kostenpflichtige Module/RESTServer/Betrieb und Fehlersuche&quot;&gt;OBS/Kostenpflichtige Module/RESTServer/Betrieb und Fehlersuche&lt;/a&gt; nach &lt;a href=&quot;/OBS/Kostenpflichtige_Module/REST-Server/Betrieb_und_Fehlersuche&quot; title=&quot;OBS/Kostenpflichtige Module/REST-Server/Betrieb und Fehlersuche&quot;&gt;OBS/Kostenpflichtige Module/REST-Server/Betrieb und Fehlersuche&lt;/a&gt;: Titel an Überschrift angeglichen (REST-Server, Umlaute, sprechende Beispieltitel)&lt;/p&gt;
&lt;table style=&quot;background-color: #fff; color: #202122;&quot; data-mw=&quot;interface&quot;&gt;
				&lt;tr class=&quot;diff-title&quot; lang=&quot;de&quot;&gt;
				&lt;td colspan=&quot;1&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;← Nächstältere Version&lt;/td&gt;
				&lt;td colspan=&quot;1&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;Version vom 17. November 2026, 07:14 Uhr&lt;/td&gt;
				&lt;/tr&gt;&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-notice&quot; lang=&quot;de&quot;&gt;&lt;div class=&quot;mw-diff-empty&quot;&gt;(kein Unterschied)&lt;/div&gt;
&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;</summary>
		<author><name>MINERVA-Rademacker</name></author>
	</entry>
	<entry>
		<id>https://wiki.bergau.de/index.php?title=OBS/Kostenpflichtige_Module/REST-Server/Betrieb_und_Fehlersuche&amp;diff=67384&amp;oldid=prev</id>
		<title>MINERVA-Rademacker: Neue Seite: Protokoll, Statistik, Aufbewahrung, Fehlersuche mit Trace-ID, Konsole, Reverse-Proxy, Wartung [Styleguide-Abweichung: Linkziele folgen in derselben Welle]</title>
		<link rel="alternate" type="text/html" href="https://wiki.bergau.de/index.php?title=OBS/Kostenpflichtige_Module/REST-Server/Betrieb_und_Fehlersuche&amp;diff=67384&amp;oldid=prev"/>
		<updated>2026-11-17T05:37:38Z</updated>

		<summary type="html">&lt;p&gt;Neue Seite: Protokoll, Statistik, Aufbewahrung, Fehlersuche mit Trace-ID, Konsole, Reverse-Proxy, Wartung [Styleguide-Abweichung: Linkziele folgen in derselben Welle]&lt;/p&gt;
&lt;p&gt;&lt;b&gt;Neue Seite&lt;/b&gt;&lt;/p&gt;&lt;div&gt;{{Vorlage:Kostenpflichtige Module}}&lt;br /&gt;
{{Seitentyp|Übersicht}}&lt;br /&gt;
= Betrieb und Fehlersuche =&lt;br /&gt;
&lt;br /&gt;
Diese Seite beschreibt, was der REST-Server im laufenden Betrieb aufzeichnet und wie Sie damit Störungen eingrenzen. Sie richtet sich an Administratoren und Betreuer der OBS-Installation sowie an Entwickler, die eine eigene Anbindung testen. Jede Antwort trägt eine Korrelations-ID. Mit ihr finden Sie zu jeder Anfrage Statistik und Protokoll, ohne dass interne Details nach außen gehen.&lt;br /&gt;
&lt;br /&gt;
== Protokoll ==&lt;br /&gt;
&lt;br /&gt;
Die Tabelle &amp;lt;code&amp;gt;RESTSRV_PROTO&amp;lt;/code&amp;gt; enthält die &amp;#039;&amp;#039;&amp;#039;Auffälligkeiten&amp;#039;&amp;#039;&amp;#039; des Betriebs. Erfolgreiche Anfragen stehen dort nicht, sie stehen in der [[#Statistik|Statistik]]. Ausgenommen sind einzelne Ereignisse wie Anmeldungen am JWT-Endpunkt, siehe [[#Typische Meldungen|Typische Meldungen]].&lt;br /&gt;
&lt;br /&gt;
Ins Protokoll gehen:&lt;br /&gt;
* abgewiesene und fehlerhafte Anfragen, auch fachliche Ablehnungen durch das Endpunkt-Skript&lt;br /&gt;
* Verbindungs- und TLS-Fehler&lt;br /&gt;
* Fehler und ausgewählte Ereignisse rund um JWT und Sitzungen&lt;br /&gt;
* Start des Servers, Bindungen, Zertifikat und Zertifikats-Pin&lt;br /&gt;
* Skriptfehler&lt;br /&gt;
* die Nutzung des vorherigen API-Keys nach einem Schlüsseltausch&lt;br /&gt;
* Abweisungen durch Rate-Limit und Andrangsgrenze&lt;br /&gt;
&lt;br /&gt;
=== Spalten ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Feld !! Inhalt&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rp_date&amp;lt;/code&amp;gt; || Datum&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rp_time&amp;lt;/code&amp;gt; || Uhrzeit&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rp_host&amp;lt;/code&amp;gt; || Quelle der Zeile, siehe unten&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rp_text&amp;lt;/code&amp;gt; || Meldung&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rp_trace&amp;lt;/code&amp;gt; || Korrelations-ID der Anfrage, gleich dem Header &amp;#039;&amp;#039;X-Trace-Id&amp;#039;&amp;#039; der Antwort. Leer bei Meldungen ohne Anfragebezug&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Mögliche Werte in &amp;lt;code&amp;gt;rp_host&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Wert !! Bedeutung&lt;br /&gt;
|-&lt;br /&gt;
| Name des Zugangs || Die Anfrage war einem Zugang zugeordnet&lt;br /&gt;
|-&lt;br /&gt;
| IP-Adresse || Die Anfrage war keinem Zugang zugeordnet, z.B. bei unbekanntem API-Key, Rate-Limit oder Andrangsgrenze&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;System&amp;lt;/code&amp;gt; || Start, Bindungen, Zertifikat, Aufräumläufe&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;TLS:&amp;lt;Profil&amp;gt;&amp;lt;/code&amp;gt; || Verbindungs- und TLS-Fehler eines Server-Profils, Klartext auf einem TLS-Port&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;TLS&amp;lt;/code&amp;gt; || Abgelehntes Client-Zertifikat bei mTLS&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;JWTAuthentication&amp;lt;/code&amp;gt; || Token konnte nicht geprüft werden&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;ACME&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;ACME-WARNUNG&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;ACME-FEHLER&amp;lt;/code&amp;gt; || Automatische Zertifikatserneuerung, siehe [[OBS/Kostenpflichtige Module/RESTServer/Zertifikatserneuerung|Zertifikatserneuerung]]&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Fehlerzeile einer Anfrage ===&lt;br /&gt;
&lt;br /&gt;
Je fehlgeschlagener Anfrage schreibt der Server genau eine Fehlerzeile:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;Fehler &amp;lt;Kennung&amp;gt; [&amp;lt;Status&amp;gt; &amp;lt;HTTP-Verb&amp;gt; &amp;lt;Pfad&amp;gt;] [trace=&amp;lt;Korrelations-ID&amp;gt;]: &amp;lt;Meldung&amp;gt;&amp;lt;/code&amp;gt;&lt;br /&gt;
&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Kennung:&amp;#039;&amp;#039;&amp;#039; Bei Fehlern, die der Server selbst feststellt, eine interne Kennung, z.B. &amp;lt;code&amp;gt;Y00C71CSDV&amp;lt;/code&amp;gt;. Sie steht auch als &amp;lt;code&amp;gt;uid&amp;lt;/code&amp;gt; in der Fehlerantwort. Setzt das Endpunkt-Skript eine Fehlerantwort (Status ab 400), steht hier dessen &amp;lt;code&amp;gt;error.code&amp;lt;/code&amp;gt;. Fehlt das &amp;lt;code&amp;gt;error&amp;lt;/code&amp;gt;-Objekt, steht hier der Code zum Status und als Meldung „Antwort ohne error-Objekt“.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Meldung:&amp;#039;&amp;#039;&amp;#039; die ausführliche Begründung. Der Client erhält nur eine allgemeine Meldung, z.B. „Zugriff verweigert“.&lt;br /&gt;
&lt;br /&gt;
Beispiel für einen unbekannten API-Key. Host ist hier die IP-Adresse:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;text&amp;quot;&amp;gt;&lt;br /&gt;
Fehler Y00C71CSDV [401 GET /service/app/settings] [trace=20261117T091512345-00002A]: Kein Account mit diesem API-Key gefunden&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Maskierung ===&lt;br /&gt;
&lt;br /&gt;
Werte aus der Anfrage stammen vom Absender. Der Server schreibt sie deshalb nur bereinigt in Protokoll und Statistik:&lt;br /&gt;
* Steuerzeichen erscheinen als &amp;lt;code&amp;gt;\xNN&amp;lt;/code&amp;gt;, ungültiges UTF-8 als &amp;lt;code&amp;gt;\uFFFD&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Der Pfad wird nach 200 Zeichen gekürzt und endet dann mit &amp;lt;code&amp;gt;...&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Parameter im Query-String mit den Namen &amp;lt;code&amp;gt;password&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;pass&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;token&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;secret&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;apikey&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;api_key&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;authorization&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;cookie&amp;lt;/code&amp;gt; und &amp;lt;code&amp;gt;proxy-authorization&amp;lt;/code&amp;gt; erscheinen als &amp;lt;code&amp;gt;***&amp;lt;/code&amp;gt;.&lt;br /&gt;
* Schickt der Client den Header &amp;#039;&amp;#039;X-Forwarded-For&amp;#039;&amp;#039;, hängt der Server dessen Wert als &amp;lt;code&amp;gt;[xff=…]&amp;lt;/code&amp;gt; an die Meldung an, siehe [[#Betrieb hinter einem Reverse-Proxy|Betrieb hinter einem Reverse-Proxy]].&lt;br /&gt;
&lt;br /&gt;
=== Typische Meldungen ===&lt;br /&gt;
&lt;br /&gt;
Platzhalter in spitzen Klammern stehen für die Werte im Einzelfall.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Meldung !! Bedeutung&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;REST-Server [&amp;lt;Profil&amp;gt;] gestartet&amp;lt;/code&amp;gt; || Das Server-Profil nimmt Anfragen an&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Bindung fuer &amp;lt;IP-Adresse&amp;gt;:&amp;lt;Port&amp;gt; auf Server [&amp;lt;Profil&amp;gt;] angelegt&amp;lt;/code&amp;gt; || Eine Bindung ist aktiv&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Fehler: Bindung fuer &amp;lt;IP-Adresse&amp;gt; auf Server [&amp;lt;Profil&amp;gt;] konnte nicht angelegt werden&amp;lt;/code&amp;gt; || Die Bindung ist nicht aktiv&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Fehler: Server [&amp;lt;Profil&amp;gt;] konnte nicht gestartet werden (&amp;lt;Grund&amp;gt;)&amp;lt;/code&amp;gt; || Das Server-Profil läuft nicht. Den Grund nennt die Klammer&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Warnung: Kein aktiver Server in RESTSRV_SERVER konfiguriert&amp;lt;/code&amp;gt; || Kein Server-Profil ist &amp;#039;&amp;#039;&amp;#039;Aktiv&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Fehler: Modul nicht aktiv&amp;lt;/code&amp;gt; || Das Modul REST-Server ist nicht freigeschaltet. Der Dienst startet keinen Server&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Server [&amp;lt;Profil&amp;gt;]: SSL-TLS aktiv (Standard-TLS ohne Client-Cert)&amp;lt;/code&amp;gt; || TLS ist eingerichtet, ohne mTLS&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Server [&amp;lt;Profil&amp;gt;]: SSL-TLS aktiv (mTLS - alle Clients muessen Cert vorlegen)&amp;lt;/code&amp;gt; || TLS mit mTLS ist eingerichtet&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Server [&amp;lt;Profil&amp;gt;]: Plain-HTTP aktiv (no_ssl=1, Debug-Modus)&amp;lt;/code&amp;gt; || Das Profil läuft mit &amp;#039;&amp;#039;&amp;#039;kein SSL (Plain-HTTP - nur für Debug!)&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Fehler: Server [&amp;lt;Profil&amp;gt;]: SSL/TLS-Konfiguration fehlt (rsv_cert/rsv_key) - Server kann nicht starten&amp;lt;/code&amp;gt; || &amp;#039;&amp;#039;&amp;#039;Zertifikat (cert)&amp;#039;&amp;#039;&amp;#039; oder &amp;#039;&amp;#039;&amp;#039;Schlüssel (key)&amp;#039;&amp;#039;&amp;#039; fehlt am Server-Profil&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Fehler: Server [&amp;lt;Profil&amp;gt;]: rsv_root_cert fehlt - mTLS aktiv erfordert CA-Zertifikat&amp;lt;/code&amp;gt; || &amp;#039;&amp;#039;&amp;#039;mTLS-Modus aktiv&amp;#039;&amp;#039;&amp;#039; ist gesetzt, &amp;#039;&amp;#039;&amp;#039;Root-Zertifikat (ca)&amp;#039;&amp;#039;&amp;#039; ist aber leer&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Warnung: Server [&amp;lt;Profil&amp;gt;]: rsv_cert traegt NUR das Server-Zertifikat, kein Zwischenzertifikat. …&amp;lt;/code&amp;gt; || Die Zertifikatskette ist unvollständig. Hängen Sie das Zwischenzertifikat hinter das Server-Zertifikat an&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Server [&amp;lt;Profil&amp;gt;]: ACHTUNG, Zertifikats-Pin hat sich geändert: &amp;lt;neu&amp;gt; statt &amp;lt;alt&amp;gt;. Alle bisher ausgegebenen Zugangscodes sind damit ungültig.&amp;lt;/code&amp;gt; || Der Schlüssel des Serverzertifikats hat sich geändert. Geräte mit dem alten Pin verbinden sich nicht mehr&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Klartext-HTTP-Anfrage auf TLS-Port von &amp;lt;IP-Adresse&amp;gt; (&amp;lt;Verb&amp;gt; &amp;lt;Pfad&amp;gt;) - mit 400 abgewiesen&amp;lt;/code&amp;gt; || Ein Client hat &amp;lt;code&amp;gt;http://&amp;lt;/code&amp;gt; statt &amp;lt;code&amp;gt;https://&amp;lt;/code&amp;gt; verwendet&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Plain-HTTP-Profil: TLS-Handshake-Versuch von &amp;lt;IP-Adresse&amp;gt;&amp;lt;/code&amp;gt; || Ein Client hat &amp;lt;code&amp;gt;https://&amp;lt;/code&amp;gt; auf einem Profil ohne TLS verwendet. Die Verbindung wurde getrennt&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;TLS-Handshake erst nach Verbindungsaufbau von &amp;lt;IP-Adresse&amp;gt; (Methode …) - mit 400 abgewiesen&amp;lt;/code&amp;gt; || Wie vorher, der Client hat aber erst später gesendet&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Ungueltige Anfragezeile von &amp;lt;IP-Adresse&amp;gt; (Methode …) - mit 400 abgewiesen&amp;lt;/code&amp;gt; || Die Anfrage war kein gültiges HTTP&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Verbindungs-Fehler von &amp;lt;IP-Adresse&amp;gt;: &amp;lt;Klasse&amp;gt; (&amp;lt;Grund&amp;gt;)&amp;lt;/code&amp;gt; || Die Verbindung ist vor oder während des TLS-Handshakes gescheitert, z.B. fehlendes Client-Zertifikat bei mTLS&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Peer-Cert-Verifikation fehlgeschlagen: depth=…, err=… (…), subject=…&amp;lt;/code&amp;gt; || Das Client-Zertifikat ließ sich nicht gegen das &amp;#039;&amp;#039;&amp;#039;Root-Zertifikat (ca)&amp;#039;&amp;#039;&amp;#039; prüfen&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Rate-Limit ueberschritten [&amp;lt;Profil&amp;gt;] &amp;lt;Verb&amp;gt; &amp;lt;Pfad&amp;gt; (…, key=…, retry=&amp;lt;n&amp;gt;s) [trace=…]&amp;lt;/code&amp;gt; || Die Anfrage wurde mit 429 abgewiesen&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Andrangsgrenze erreicht [&amp;lt;Profil&amp;gt;] &amp;lt;Verb&amp;gt; &amp;lt;Pfad&amp;gt; (&amp;lt;n&amp;gt; von &amp;lt;max&amp;gt;) [trace=…]&amp;lt;/code&amp;gt; || &amp;#039;&amp;#039;&amp;#039;max. Anfragen&amp;#039;&amp;#039;&amp;#039; war erreicht, Antwort 503&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Unbehandelter Fehler [&amp;lt;Verb&amp;gt; &amp;lt;Pfad&amp;gt;] [trace=…]: &amp;lt;Grund&amp;gt;&amp;lt;/code&amp;gt; || Unerwarteter Fehler, Antwort 500. Für diese Anfrage gibt es keine Statistikzeile&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Vorheriger API-Key benutzt von &amp;lt;IP-Adresse&amp;gt; (gueltig bis &amp;lt;Zeitpunkt&amp;gt;)&amp;lt;/code&amp;gt; || Ein Gerät verwendet nach einem Schlüsseltausch noch den alten API-Key. So sehen Sie, welche Geräte den neuen Zugangscode noch nicht eingelesen haben&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;JWT-Token erstellt&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;JWT-Token rotiert (Refresh)&amp;lt;/code&amp;gt; || Anmeldung bzw. Erneuerung am JWT-Endpunkt war erfolgreich&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;JWT-Logout: Sitzung gesperrt (&amp;lt;n&amp;gt; Zeilen)&amp;lt;/code&amp;gt; || Die Abmeldung war erfolgreich&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;TokenStore: WIEDERVORLAGE eines verbrauchten Refresh-Token (…) - Sitzung wird gesperrt&amp;lt;/code&amp;gt; || Ein bereits verbrauchtes Refresh-Token wurde erneut vorgelegt. Der Server sperrt die ganze Sitzung, siehe [[OBS/Kostenpflichtige Module/RESTServer/Anmeldung mit JWT|Anmeldung mit JWT]]&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;TokenStore: Sitzung konnte nicht hinterlegt werden: &amp;lt;Grund&amp;gt;&amp;lt;/code&amp;gt; || Die Sitzung ließ sich nicht in &amp;lt;code&amp;gt;RESTSRV_TOKEN&amp;lt;/code&amp;gt; schreiben. Die Anmeldung scheitert mit 503&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Idempotenz: gespeicherte Antwort zurueckgespielt (…)&amp;lt;/code&amp;gt; || Eine Wiederholung mit demselben &amp;#039;&amp;#039;Idempotency-Key&amp;#039;&amp;#039; hat die gespeicherte Antwort erhalten&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;Idempotenz: offene Reservierung seit &amp;lt;Zeitpunkt&amp;gt; - … manuelle Klaerung noetig&amp;lt;/code&amp;gt; || Ein Schreibvorgang wurde hart abgebrochen. Ob er gewirkt hat, ist offen, siehe [[#Wartung der Server-Tabellen|Wartung der Server-Tabellen]]&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;WebHook: &amp;lt;Kennung&amp;gt;&amp;lt;/code&amp;gt; || Ein WebHook-Endpunkt wurde aufgerufen&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Statistik ==&lt;br /&gt;
&lt;br /&gt;
Die Tabelle &amp;lt;code&amp;gt;RESTSRV_STATS&amp;lt;/code&amp;gt; enthält eine Zeile je Anfrage, die bis zur Verarbeitung kommt. Dazu gehören auch Anfragen, die bei der Authentifizierung abgewiesen werden. Die Statistik zeigt damit alle verarbeiteten Anfragen, das Protokoll die Auffälligkeiten.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Feld !! Inhalt&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rs_date&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;rs_time&amp;lt;/code&amp;gt; || Datum und Uhrzeit&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rs_host&amp;lt;/code&amp;gt; || IP-Adresse der Verbindung&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rs_account&amp;lt;/code&amp;gt; || Kennung des Zugangs. Leer, wenn die Anfrage keinem Zugang zugeordnet werden konnte&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rs_endpoint&amp;lt;/code&amp;gt; || Kennung des Endpunkts. Leer, wenn kein Endpunkt gefunden wurde&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rs_cmd&amp;lt;/code&amp;gt; || HTTP-Verb. Am JWT-Endpunkt &amp;#039;&amp;#039;Authenticate&amp;#039;&amp;#039; für die Anmeldung bzw. &amp;#039;&amp;#039;Refresh&amp;#039;&amp;#039; für die Erneuerung&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rs_request&amp;lt;/code&amp;gt; || Angefragter Pfad, maskiert wie im Protokoll, höchstens 200 Zeichen&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rs_response&amp;lt;/code&amp;gt; || HTTP-Status der Antwort, bei Dateien auch 206 und 416&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rs_runtime&amp;lt;/code&amp;gt; || Laufzeit in Millisekunden&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rs_trace&amp;lt;/code&amp;gt; || Korrelations-ID, gleich &amp;#039;&amp;#039;X-Trace-Id&amp;#039;&amp;#039; und &amp;lt;code&amp;gt;rp_trace&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;rs_server&amp;lt;/code&amp;gt; || Server-Profil, über das die Anfrage hereinkam&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Keine Statistikzeile erhalten:&lt;br /&gt;
* CORS-Preflight-Anfragen (&amp;#039;&amp;#039;OPTIONS&amp;#039;&amp;#039;)&lt;br /&gt;
* Anfragen, die das Rate-Limit mit 429 abweist&lt;br /&gt;
* Anfragen, die die Andrangsgrenze mit 503 abweist&lt;br /&gt;
* die 400-Abweisungen beim Verbindungsaufbau: Klartext auf einem TLS-Port, ungültige Anfragezeile&lt;br /&gt;
* Anfragen mit unerwartetem Fehler (500, Protokollzeile „Unbehandelter Fehler“)&lt;br /&gt;
&lt;br /&gt;
Bis auf &amp;#039;&amp;#039;OPTIONS&amp;#039;&amp;#039; stehen diese Fälle im Protokoll.&lt;br /&gt;
&lt;br /&gt;
== Aufbewahrung ==&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Tabelle !! Aufbewahrung&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;RESTSRV_PROTO&amp;lt;/code&amp;gt; || Gekappt bei 40.000 Sätzen&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;RESTSRV_STATS&amp;lt;/code&amp;gt; || Gekappt bei 100.000 Sätzen&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;RESTSRV_IDEMPOTENCY&amp;lt;/code&amp;gt; || Gespeicherte Antworten 30 Tage&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;RESTSRV_TOKEN&amp;lt;/code&amp;gt; || Bis Access- &amp;#039;&amp;#039;&amp;#039;und&amp;#039;&amp;#039;&amp;#039; Refresh-Token abgelaufen sind&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Brauchen Sie Protokoll oder Statistik länger, sichern Sie die Tabellen rechtzeitig.&lt;br /&gt;
&lt;br /&gt;
== Fehlersuche mit der Trace-ID ==&lt;br /&gt;
&lt;br /&gt;
Jede Antwort des REST-Servers trägt den Header &amp;#039;&amp;#039;X-Trace-Id&amp;#039;&amp;#039;. Fehlerantworten enthalten denselben Wert zusätzlich als &amp;lt;code&amp;gt;traceId&amp;lt;/code&amp;gt; im &amp;lt;code&amp;gt;error&amp;lt;/code&amp;gt;-Objekt. Aufbau der Fehlerantwort und Bedeutung der Codes beschreibt [[OBS/Kostenpflichtige Module/RESTServer/HTTP-Schnittstelle|HTTP-Schnittstelle]].&lt;br /&gt;
&lt;br /&gt;
# Lassen Sie sich die Trace-ID vom Client geben, z.B. aus dem Log der App oder aus den Entwicklerwerkzeugen des Browsers.&lt;br /&gt;
# Suchen Sie die Statistikzeile. Sie zeigt Zugang, Endpunkt, Status, Laufzeit und Server-Profil.&lt;br /&gt;
# Suchen Sie die Protokollzeilen. Sie nennen den Grund, den der Client nicht erhält.&lt;br /&gt;
# Gibt es keine Statistikzeile, suchen Sie im Protokoll nach der Trace-ID oder nach Uhrzeit und IP-Adresse, z.B. bei Rate-Limit, Andrangsgrenze oder TLS-Fehlern.&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;sql&amp;quot;&amp;gt;&lt;br /&gt;
SELECT rs_date, rs_time, rs_host, rs_cmd, rs_request, rs_response, rs_runtime, rs_server&lt;br /&gt;
FROM RESTSRV_STATS&lt;br /&gt;
WHERE rs_trace = &amp;#039;20261117T091512345-00002A&amp;#039;;&lt;br /&gt;
&lt;br /&gt;
SELECT rp_date, rp_time, rp_host, rp_text&lt;br /&gt;
FROM RESTSRV_PROTO&lt;br /&gt;
WHERE rp_trace = &amp;#039;20261117T091512345-00002A&amp;#039;;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
Meldungen ohne Anfragebezug haben keine Trace-ID, z.B. Start, Bindungen, Zertifikat oder TLS-Fehler beim Verbindungsaufbau. Sie finden diese über &amp;lt;code&amp;gt;rp_host&amp;lt;/code&amp;gt;:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;sql&amp;quot;&amp;gt;&lt;br /&gt;
SELECT rp_date, rp_time, rp_host, rp_text&lt;br /&gt;
FROM RESTSRV_PROTO&lt;br /&gt;
WHERE rp_host IN (&amp;#039;System&amp;#039;, &amp;#039;TLS&amp;#039;) OR rp_host LIKE &amp;#039;TLS:%&amp;#039;&lt;br /&gt;
ORDER BY rp_date DESC, rp_time DESC;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== Häufige Fehlerbilder ==&lt;br /&gt;
&lt;br /&gt;
Die Meldung an den Client ist bewusst allgemein. Den Grund finden Sie jeweils über die Trace-ID im Protokoll.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Erscheinung !! Ursache !! Abhilfe&lt;br /&gt;
|-&lt;br /&gt;
| Verbindung bricht ab oder 400 mit dem Text „Ungueltige Anfragezeile.“ || Der Client verwendet &amp;lt;code&amp;gt;https://&amp;lt;/code&amp;gt;, das Profil läuft mit &amp;#039;&amp;#039;&amp;#039;kein SSL (Plain-HTTP - nur für Debug!)&amp;#039;&amp;#039;&amp;#039; || &amp;lt;code&amp;gt;http://&amp;lt;/code&amp;gt; verwenden oder das Profil auf TLS umstellen. Im Betrieb nur TLS-Profile verwenden&lt;br /&gt;
|-&lt;br /&gt;
| 400 mit dem Text „Dieser Port erwartet eine TLS-Verbindung. …“ || Der Client verwendet &amp;lt;code&amp;gt;http://&amp;lt;/code&amp;gt; auf einem TLS-Profil || &amp;lt;code&amp;gt;https://&amp;lt;/code&amp;gt; verwenden&lt;br /&gt;
|-&lt;br /&gt;
| Verbindung bricht beim Aufbau ab, im Protokoll &amp;lt;code&amp;gt;Verbindungs-Fehler&amp;lt;/code&amp;gt; oder &amp;lt;code&amp;gt;Peer-Cert-Verifikation fehlgeschlagen&amp;lt;/code&amp;gt; || &amp;#039;&amp;#039;&amp;#039;mTLS-Modus aktiv&amp;#039;&amp;#039;&amp;#039; ist gesetzt, der Client legt kein oder kein vertrauenswürdiges Client-Zertifikat vor || Client-Zertifikat installieren. &amp;#039;&amp;#039;&amp;#039;Root-Zertifikat (ca)&amp;#039;&amp;#039;&amp;#039; am Server-Profil prüfen&lt;br /&gt;
|-&lt;br /&gt;
| 401 &amp;lt;code&amp;gt;CLIENT_CERT_INVALID&amp;lt;/code&amp;gt; || Das Client-Zertifikat passt nicht zum &amp;#039;&amp;#039;&amp;#039;mTLS-Subject&amp;#039;&amp;#039;&amp;#039; des Zugangs || &amp;#039;&amp;#039;&amp;#039;mTLS-Subject&amp;#039;&amp;#039;&amp;#039; oder Client-Zertifikat korrigieren&lt;br /&gt;
|-&lt;br /&gt;
| 401 &amp;lt;code&amp;gt;API_KEY_INVALID&amp;lt;/code&amp;gt; || API-Key unbekannt, oder nach einem Schlüsseltausch ist die Frist des vorherigen Keys abgelaufen || &amp;#039;&amp;#039;&amp;#039;API-Key&amp;#039;&amp;#039;&amp;#039; im Zugang prüfen. Neuen Zugangscode ausgeben&lt;br /&gt;
|-&lt;br /&gt;
| 403 &amp;lt;code&amp;gt;FORBIDDEN_ROLE&amp;lt;/code&amp;gt; „Zugriff verweigert“ || Zugang nicht &amp;#039;&amp;#039;&amp;#039;Aktiv&amp;#039;&amp;#039;&amp;#039;, Anfrage nicht vom eingetragenen &amp;#039;&amp;#039;&amp;#039;Host&amp;#039;&amp;#039;&amp;#039;, &amp;#039;&amp;#039;&amp;#039;CORS-Origin&amp;#039;&amp;#039;&amp;#039; nicht erlaubt oder Zugang für den Endpunkt nicht freigeschaltet || Grund im Protokoll nachlesen, dann Zugang bzw. Freischaltung korrigieren&lt;br /&gt;
|-&lt;br /&gt;
| 404 &amp;lt;code&amp;gt;NOT_FOUND&amp;lt;/code&amp;gt; || Kein &amp;#039;&amp;#039;&amp;#039;Pfad-Template&amp;#039;&amp;#039;&amp;#039; passt, die Segmentzahl stimmt nicht, der Endpunkt ist nicht &amp;#039;&amp;#039;&amp;#039;Aktiv&amp;#039;&amp;#039;&amp;#039; oder einem anderen &amp;#039;&amp;#039;&amp;#039;Server&amp;#039;&amp;#039;&amp;#039; zugeordnet || Endpunkt prüfen. Änderungen an Endpunkten wirken nach spätestens 60 Sekunden&lt;br /&gt;
|-&lt;br /&gt;
| 405 &amp;lt;code&amp;gt;METHOD_NOT_ALLOWED&amp;lt;/code&amp;gt; || Das Endpunkt-Skript hat keine Methode für dieses HTTP-Verb || Methode im Skript ergänzen. Der Header &amp;#039;&amp;#039;Allow&amp;#039;&amp;#039; nennt die vorhandenen&lt;br /&gt;
|-&lt;br /&gt;
| 415 &amp;lt;code&amp;gt;UNSUPPORTED_MEDIA_TYPE&amp;lt;/code&amp;gt; bei einem Upload || &amp;#039;&amp;#039;&amp;#039;Datei-Upload&amp;#039;&amp;#039;&amp;#039; ist am Endpunkt nicht gesetzt || &amp;#039;&amp;#039;&amp;#039;Datei-Upload&amp;#039;&amp;#039;&amp;#039; setzen&lt;br /&gt;
|-&lt;br /&gt;
| 429 &amp;lt;code&amp;gt;RATE_LIMITED&amp;lt;/code&amp;gt; || Zu viele Anfragen oder Fehlanfragen im Rate-Limit-Fenster. Alle Geräte mit demselben API-Key teilen sich einen Zähler || &amp;#039;&amp;#039;Retry-After&amp;#039;&amp;#039; abwarten. Bei vielen Fehlanfragen den API-Key prüfen. Grenzen am [[OBS/Kostenpflichtige Module/RESTServer/Server-Profile|Server-Profil]] anpassen&lt;br /&gt;
|-&lt;br /&gt;
| 503 &amp;lt;code&amp;gt;SERVICE_UNAVAILABLE&amp;lt;/code&amp;gt; mit &amp;#039;&amp;#039;Retry-After: 2&amp;#039;&amp;#039; || &amp;#039;&amp;#039;&amp;#039;max. Anfragen&amp;#039;&amp;#039;&amp;#039; am Server-Profil ist erreicht || Anfrage wiederholen. Bei Dauerlast die Grenze am Server-Profil prüfen&lt;br /&gt;
|-&lt;br /&gt;
| 400 &amp;lt;code&amp;gt;IDEMPOTENCY_KEY_MISSING&amp;lt;/code&amp;gt; || Schreibende Anfrage ohne Header &amp;#039;&amp;#039;Idempotency-Key&amp;#039;&amp;#039; || Der Client sendet je Vorgang einen &amp;#039;&amp;#039;Idempotency-Key&amp;#039;&amp;#039;&lt;br /&gt;
|-&lt;br /&gt;
| 409 &amp;lt;code&amp;gt;IDEMPOTENCY_UNRESOLVED&amp;lt;/code&amp;gt; || Ein früherer Versuch mit demselben Key wurde hart abgebrochen || Fachdaten prüfen, siehe [[#Wartung der Server-Tabellen|Wartung der Server-Tabellen]]&lt;br /&gt;
|-&lt;br /&gt;
| 503 bei Anmeldung oder Abmeldung am JWT-Endpunkt || Die Sitzung ließ sich in &amp;lt;code&amp;gt;RESTSRV_TOKEN&amp;lt;/code&amp;gt; nicht schreiben bzw. nicht sperren || Protokoll unter &amp;lt;code&amp;gt;TokenStore:&amp;lt;/code&amp;gt; prüfen. Fehlt die Tabelle, Datenbankabgleich durchführen. Eine gescheiterte Abmeldung muss der Client wiederholen&lt;br /&gt;
|-&lt;br /&gt;
| Gerät wird unerwartet abgemeldet || Ein Refresh-Token wurde doppelt verwendet, die Sitzung ist gesperrt || Im Protokoll nach &amp;lt;code&amp;gt;WIEDERVORLAGE&amp;lt;/code&amp;gt; suchen&lt;br /&gt;
|-&lt;br /&gt;
| Neue Bindung antwortet nicht || Bindungen liest der Dienst beim Start || REST-Dienst neu starten&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Konsole ==&lt;br /&gt;
&lt;br /&gt;
Startet der REST-Server ohne den Parameter &amp;lt;code&amp;gt;/service&amp;lt;/code&amp;gt;, zeigt er eine Konsole. Sie enthält ein Live-Log und einen festen Kopfbereich mit den gerade laufenden Anfragen. Als Windows-Dienst gestartet gibt es keine Konsole. Die Meldungen stehen dann nur in &amp;lt;code&amp;gt;RESTSRV_PROTO&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Befehl !! Wirkung&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;show &amp;lt;handle&amp;gt;&amp;lt;/code&amp;gt; || Details einer Anfrage: Anfrage, Protokollzeilen, Antwort. Das Handle steht in der Abschlusszeile der Anfrage, z.B. &amp;lt;code&amp;gt;7F&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;1&amp;lt;/code&amp;gt; … &amp;lt;code&amp;gt;9&amp;lt;/code&amp;gt; || Auswahl einer Anfrage im Kopfbereich, mit &amp;lt;code&amp;gt;mouse on&amp;lt;/code&amp;gt; auch per Klick&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;ps&amp;lt;/code&amp;gt; || Laufende Anfragen auflisten&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;level &amp;lt;stufe&amp;gt;&amp;lt;/code&amp;gt; || Anzeigestufe: &amp;lt;code&amp;gt;quiet&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;normal&amp;lt;/code&amp;gt; oder &amp;lt;code&amp;gt;debug&amp;lt;/code&amp;gt;. Ohne Angabe nennt die Konsole die aktuelle Stufe&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;filter &amp;lt;ausdruck&amp;gt;&amp;lt;/code&amp;gt; || Anzeige einschränken: &amp;lt;code&amp;gt;path=&amp;lt;text&amp;gt;&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;account=&amp;lt;name&amp;gt;&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;status&amp;gt;=&amp;amp;lt;code&amp;amp;gt;&amp;lt;/code&amp;gt;. &amp;lt;code&amp;gt;filter aus&amp;lt;/code&amp;gt; hebt die Einschränkung auf&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;panel on&amp;lt;/code&amp;gt; / &amp;lt;code&amp;gt;panel off&amp;lt;/code&amp;gt; || Kopfbereich ein- bzw. ausschalten. Ausgeschaltet lässt sich das Konsolenfenster wieder zurückblättern&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;mouse on&amp;lt;/code&amp;gt; / &amp;lt;code&amp;gt;mouse off&amp;lt;/code&amp;gt; || Auswahl per Klick. Eingeschaltet lässt sich Text nicht mehr mit der Maus markieren&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;cert&amp;lt;/code&amp;gt; || Zustand der automatischen Zertifikatserneuerung&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;cert renew&amp;lt;/code&amp;gt; || Erneuerung sofort anstoßen. Der Verlauf steht im Protokoll&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;cert test&amp;lt;/code&amp;gt; || Selbsttest gegen die Staging-Umgebung der Zertifizierungsstelle&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;help&amp;lt;/code&amp;gt; / &amp;lt;code&amp;gt;?&amp;lt;/code&amp;gt; || Befehlsliste anzeigen&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;exit&amp;lt;/code&amp;gt; / &amp;lt;code&amp;gt;quit&amp;lt;/code&amp;gt; || Server geordnet beenden&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Zu den &amp;lt;code&amp;gt;cert&amp;lt;/code&amp;gt;-Befehlen siehe [[OBS/Kostenpflichtige Module/RESTServer/Zertifikatserneuerung|Zertifikatserneuerung]].&lt;br /&gt;
&lt;br /&gt;
{{Hinweis|Filter und Anzeigestufe wirken nur auf die Anzeige. Wiederholt sich dieselbe Meldung aus derselben Quelle, zeigt die Konsole sie höchstens einmal in 15 Minuten und nennt die Zahl der unterdrückten Wiederholungen. &amp;lt;code&amp;gt;RESTSRV_PROTO&amp;lt;/code&amp;gt; enthält trotzdem jede Zeile.}}&lt;br /&gt;
&lt;br /&gt;
== Betrieb hinter einem Reverse-Proxy ==&lt;br /&gt;
&lt;br /&gt;
Ein Reverse-Proxy nimmt die Anfragen von außen an und reicht sie an den REST-Dienst weiter. Wann sich das lohnt, beschreibt [[OBS/Kostenpflichtige Module/RESTServer/Öffentliche Freigabe|Öffentliche Freigabe]].&lt;br /&gt;
&lt;br /&gt;
Am Proxy richten Sie ein:&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Zertifikat:&amp;#039;&amp;#039;&amp;#039; Das öffentlich gültige Zertifikat liegt am Proxy. Für die Strecke zum REST-Server genügt dort ein Zertifikat Ihrer internen Zertifizierungsstelle oder ein selbst signiertes, dem der Proxy vertraut. Auch dieses läuft ab und muss rechtzeitig getauscht werden.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Weiterleitung:&amp;#039;&amp;#039;&amp;#039; per HTTPS an &amp;lt;code&amp;gt;https://&amp;lt;Server des REST-Dienstes&amp;gt;:&amp;lt;Port&amp;gt;&amp;lt;/code&amp;gt;. Eine Weiterleitung per &amp;lt;code&amp;gt;http://&amp;lt;/code&amp;gt; an ein TLS-Profil weist der REST-Server mit 400 ab.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Header:&amp;#039;&amp;#039;&amp;#039; alle HTTP-Methoden und Header unverändert durchreichen, insbesondere &amp;#039;&amp;#039;apikey&amp;#039;&amp;#039;, &amp;#039;&amp;#039;Authorization&amp;#039;&amp;#039; und &amp;#039;&amp;#039;Idempotency-Key&amp;#039;&amp;#039;. &amp;#039;&amp;#039;X-Trace-Id&amp;#039;&amp;#039; in der Antwort nicht entfernen. Den Header &amp;#039;&amp;#039;X-Forwarded-For&amp;#039;&amp;#039; mit der IP-Adresse des Clients setzen.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Anfragegröße:&amp;#039;&amp;#039;&amp;#039; nicht kleiner als die &amp;#039;&amp;#039;&amp;#039;maximale Dateigröße (MB)&amp;#039;&amp;#039;&amp;#039; der Upload-Endpunkte.&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Firewall:&amp;#039;&amp;#039;&amp;#039; den Port des REST-Servers intern nur für den Proxy öffnen.&lt;br /&gt;
&lt;br /&gt;
Hinter dem Proxy sieht der REST-Server als Absender nur den Proxy. Das wirkt sich so aus:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Bereich !! Auswirkung&lt;br /&gt;
|-&lt;br /&gt;
| Protokoll || &amp;lt;code&amp;gt;rp_host&amp;lt;/code&amp;gt; bzw. die IP-Adresse in der Meldung ist die des Proxys. Den Wert von &amp;#039;&amp;#039;X-Forwarded-For&amp;#039;&amp;#039; hängt der Server als &amp;lt;code&amp;gt;[xff=…]&amp;lt;/code&amp;gt; an Meldungen zu einer Anfrage an, höchstens 100 Zeichen. Meldungen beim Verbindungsaufbau tragen ihn nicht&lt;br /&gt;
|-&lt;br /&gt;
| Statistik || &amp;lt;code&amp;gt;rs_host&amp;lt;/code&amp;gt; ist die IP-Adresse des Proxys. &amp;#039;&amp;#039;X-Forwarded-For&amp;#039;&amp;#039; steht dort nicht&lt;br /&gt;
|-&lt;br /&gt;
| Host-Beschränkung || Der &amp;#039;&amp;#039;&amp;#039;Host&amp;#039;&amp;#039;&amp;#039; eines Zugangs wird mit der IP-Adresse des Proxys verglichen. Einzelne Clients lassen sich nicht unterscheiden&lt;br /&gt;
|-&lt;br /&gt;
| Rate-Limit || Anfragen mit API-Key zählen wie gewohnt je Key. Alle Anfragen ohne API-Key teilen sich den Zähler der Proxy-Adresse&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
{{Achtung|&amp;#039;&amp;#039;X-Forwarded-For&amp;#039;&amp;#039; ist eine Angabe des Absenders. Der REST-Server protokolliert den Wert nur. Für Host-Beschränkung und Rate-Limit verwendet er ihn nicht.}}&lt;br /&gt;
&lt;br /&gt;
== Wartung der Server-Tabellen ==&lt;br /&gt;
&lt;br /&gt;
Die Tabellen des REST-Servers räumen sich selbst auf. Ein regelmäßiger Eingriff ist nicht nötig.&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Tabelle !! Aufräumen&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;RESTSRV_PROTO&amp;lt;/code&amp;gt;, &amp;lt;code&amp;gt;RESTSRV_STATS&amp;lt;/code&amp;gt; || Gekappt, siehe [[#Aufbewahrung|Aufbewahrung]]&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;RESTSRV_IDEMPOTENCY&amp;lt;/code&amp;gt; || Abgeschlossene Einträge werden nach 30 Tagen gelöscht. Offene Reservierungen, die älter als 24 Stunden sind, meldet der Server im Protokoll und löscht sie dann. Der Aufräumlauf läuft beim Start und danach höchstens stündlich&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;RESTSRV_TOKEN&amp;lt;/code&amp;gt; || Zeilen werden gelöscht, wenn Access- und Refresh-Token abgelaufen sind. Gesperrte Sitzungen bleiben bis dahin stehen. Der Aufräumlauf läuft beim Start und danach höchstens stündlich&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
Eine offene Reservierung entsteht nur, wenn ein Schreibvorgang hart abgebrochen wurde, z.B. weil der Dienst beendet wurde. Ob der Vorgang gewirkt hat, ist dann offen. Wiederholt der Client ihn, erhält er 409 &amp;lt;code&amp;gt;IDEMPOTENCY_UNRESOLVED&amp;lt;/code&amp;gt;. Prüfen Sie anhand der Protokollzeile die Fachdaten. Soll der Client vor Ablauf der 24 Stunden weitermachen, löschen Sie den Eintrag nach der Prüfung in &amp;lt;code&amp;gt;RESTSRV_IDEMPOTENCY&amp;lt;/code&amp;gt;.&lt;br /&gt;
&lt;br /&gt;
== Siehe auch ==&lt;br /&gt;
* [[OBS/Kostenpflichtige Module/RESTServer/HTTP-Schnittstelle|HTTP-Schnittstelle]]&lt;br /&gt;
* [[OBS/Kostenpflichtige Module/RESTServer/Anmeldung mit JWT|Anmeldung mit JWT]]&lt;br /&gt;
* [[OBS/Kostenpflichtige Module/RESTServer/Server-Profile|Server-Profile]]&lt;br /&gt;
* [[OBS/Kostenpflichtige Module/RESTServer/Zertifikatserneuerung|Zertifikatserneuerung]]&lt;br /&gt;
* [[OBS/Kostenpflichtige Module/RESTServer/Öffentliche Freigabe|Öffentliche Freigabe]]&lt;/div&gt;</summary>
		<author><name>MINERVA-Rademacker</name></author>
	</entry>
</feed>