2
0
mirror of https://github.com/fhem/fhem-mirror.git synced 2025-04-22 08:11:44 +00:00

98_telnet.pm: more precise SSL documentation

git-svn-id: https://svn.fhem.de/fhem/trunk@25729 2b470e98-0d58-463d-a4d8-8e2adae1ed80
This commit is contained in:
rudolfkoenig 2022-02-22 08:26:00 +00:00
parent 9040283e69
commit 369065e928

View File

@ -428,11 +428,11 @@ telnet_ActivateInform($)
=item summary_DE FHEM telnet Server =item summary_DE FHEM telnet Server
=begin html =begin html
<a name="telnet"></a> <a id="telnet"></a>
<h3>telnet</h3> <h3>telnet</h3>
<ul> <ul>
<br> <br>
<a name="telnetdefine"></a> <a id="telnet-define"></a>
<b>Define</b> <b>Define</b>
<ul> <ul>
<code>define &lt;name&gt; telnet &lt;portNumber&gt; <code>define &lt;name&gt; telnet &lt;portNumber&gt;
@ -487,25 +487,26 @@ telnet_ActivateInform($)
<br> <br>
<a name="telnetset"></a> <a id="telnet-set"></a>
<b>Set</b> <ul>N/A</ul><br> <b>Set</b> <ul>N/A</ul><br>
<a name="telnetget"></a> <a id="telnet-get"></a>
<b>Get</b> <ul>N/A</ul><br> <b>Get</b> <ul>N/A</ul><br>
<a name="telnetattr"></a> <a id="telnet-attr"></a>
<b>Attributes:</b> <b>Attributes:</b>
<ul> <ul>
<a name="prompt"></a> <a id="telnet-attr-prompt"></a>
<li>prompt<br> <li>prompt<br>
Sets the string for the telnet prompt, the default is fhem&gt; Sets the string for the telnet prompt, the default is fhem&gt;
</li><br> </li><br>
<a name="SSL"></a> <a id="telnet-attr-SSL"></a>
<li>SSL<br> <li>SSL<br>
Enable SSL encryption of the connection, see the description <a Enable SSL encryption of the connection, see the description <a
href="#HTTPS">here</a> on generating the needed SSL certificates. To href="#HTTPS">here</a> on generating the needed SSL certificates.
connect to such a port use one of the following commands: If the attribute is set, the telnet program wont work as a client
anymore, and a replacement is needed, like one of the following:
<ul> <ul>
socat openssl:fhemhost:fhemport,verify=0 readline<br> socat openssl:fhemhost:fhemport,verify=0 readline<br>
ncat --ssl fhemhost fhemport<br> ncat --ssl fhemhost fhemport<br>
@ -513,7 +514,7 @@ telnet_ActivateInform($)
</ul> </ul>
</li><br> </li><br>
<a name="allowfrom"></a> <a id="telnet-attr-allowfrom"></a>
<li>allowfrom<br> <li>allowfrom<br>
Regexp of allowed ip-addresses or hostnames. If set, only connections Regexp of allowed ip-addresses or hostnames. If set, only connections
from these addresses are allowed.<br> from these addresses are allowed.<br>
@ -527,27 +528,30 @@ telnet_ActivateInform($)
</ul> </ul>
</li><br> </li><br>
<a name="connectTimeout"></a> <a id="telnet-attr-connectTimeout"></a>
<li>connectTimeout<br> <li>connectTimeout<br>
Wait at maximum this many seconds for the connection to be established. Wait at maximum this many seconds for the connection to be established.
Default is 2. Default is 2.
</li><br> </li><br>
<a name="connectInterval"></a> <a id="telnet-attr-connectInterval"></a>
<li>connectInterval<br> <li>connectInterval<br>
After closing a connection, or if a connection cannot be estblished, After closing a connection, or if a connection cannot be estblished,
try to connect again after this many seconds. Default is 60. try to connect again after this many seconds. Default is 60.
</li><br> </li><br>
<a name="encoding"></a> <a id="telnet-attr-encoding"></a>
<li>encoding<br> <li>encoding<br>
Sets the encoding for the data send to the client. Possible values are Sets the encoding for the data send to the client. Possible values are
latin1 and utf8. Default is utf8. latin1 and utf8. Default is utf8.
</li><br> </li><br>
<a id="telnet-attr-sslVersion"></a>
<li>sslVersion<br> <li>sslVersion<br>
See the global attribute sslVersion. See the global attribute sslVersion.
</li><br> </li><br>
<a id="telnet-attr-sslCertPrefix"></a>
<li>sslCertPrefix<br> <li>sslCertPrefix<br>
Set the prefix for the SSL certificate, default is certs/server-, see Set the prefix for the SSL certificate, default is certs/server-, see
also the SSL attribute. also the SSL attribute.
@ -561,11 +565,11 @@ telnet_ActivateInform($)
=begin html_DE =begin html_DE
<a name="telnet"></a> <a id="telnet"></a>
<h3>telnet</h3> <h3>telnet</h3>
<ul> <ul>
<br> <br>
<a name="telnetdefine"></a> <a id="telnet-define"></a>
<b>Define</b> <b>Define</b>
<ul> <ul>
<code>define &lt;name&gt; telnet &lt;portNumber&gt; <code>define &lt;name&gt; telnet &lt;portNumber&gt;
@ -625,27 +629,28 @@ telnet_ActivateInform($)
<br> <br>
<a name="telnetset"></a> <a id="telnet-set"></a>
<b>Set</b> <ul>N/A</ul><br> <b>Set</b> <ul>N/A</ul><br>
<a name="telnetget"></a> <a id="telnet-get"></a>
<b>Get</b> <ul>N/A</ul><br> <b>Get</b> <ul>N/A</ul><br>
<a name="telnetattr"></a> <a id="telnet-attr"></a>
<b>Attribute</b> <b>Attribute</b>
<ul> <ul>
<a name="prompt"></a> <a id="telnet-attr-prompt"></a>
<li>prompt<br> <li>prompt<br>
Gibt die Zeichenkette an, welche in der Telnet-Sitzung als Gibt die Zeichenkette an, welche in der Telnet-Sitzung als
Kommandoprompt ausgegeben wird. Die Voreinstellung ist fhem&gt; Kommandoprompt ausgegeben wird. Die Voreinstellung ist fhem&gt;
</li><br> </li><br>
<a name="SSL"></a> <a id="telnet-attr-SSL"></a>
<li>SSL<br> <li>SSL<br>
SSL-Verschl&uuml;sselung f&uuml;r eine Verbindung aktivieren. <a SSL-Verschl&uuml;sselung f&uuml;r eine Verbindung aktivieren. <a
href="#HTTPS">Hier</a> gibt es eine Beschreibung, wie das erforderliche href="#HTTPS">Hier</a> gibt es eine Beschreibung, wie das erforderliche
SSL-Zertifikat generiert werden kann. Um eine Verbindung mit solch SSL-Zertifikat generiert werden kann. Beim gesetzten Attribut kann man
einem Port herzustellen, sind folgende Befehle m&ouml;glich: den telnet Befehl nicht mehr zum Verbinden werwenden, m&ouml;gliche
Alternetiven sind folgende Programme:
<ul> <ul>
<code> <code>
socat openssl:fhemhost:fhemport,verify=0 readline<br> socat openssl:fhemhost:fhemport,verify=0 readline<br>
@ -655,7 +660,7 @@ telnet_ActivateInform($)
</ul> </ul>
</li><br> </li><br>
<a name="allowfrom"></a> <a id="telnet-attr-allowfrom"></a>
<li>allowfrom<br> <li>allowfrom<br>
Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut Regexp der erlaubten IP-Adressen oder Hostnamen. Wenn dieses Attribut
gesetzt wurde, werden ausschlie&szlig;lich Verbindungen von diesen gesetzt wurde, werden ausschlie&szlig;lich Verbindungen von diesen
@ -670,13 +675,13 @@ telnet_ActivateInform($)
</ul> </ul>
</li><br> </li><br>
<a name="connectTimeout"></a> <a id="telnet-attr-connectTimeout"></a>
<li>connectTimeout<br> <li>connectTimeout<br>
Gibt die maximale Wartezeit in Sekunden an, in der die Verbindung Gibt die maximale Wartezeit in Sekunden an, in der die Verbindung
aufgebaut sein muss. Standardwert ist 2. aufgebaut sein muss. Standardwert ist 2.
</li><br> </li><br>
<a name="connectInterval"></a> <a id="telnet-attr-connectInterval"></a>
<li>connectInterval<br> <li>connectInterval<br>
Gibt die Dauer an, die entweder nach Schlie&szlig;en einer Verbindung Gibt die Dauer an, die entweder nach Schlie&szlig;en einer Verbindung
oder f&uuml;r den Fall, dass die Verbindung nicht zustande kommt, oder f&uuml;r den Fall, dass die Verbindung nicht zustande kommt,
@ -684,7 +689,7 @@ telnet_ActivateInform($)
werden soll. Standardwert ist 60. werden soll. Standardwert ist 60.
</li><br> </li><br>
<a name="encoding"></a> <a id="telnet-attr-encoding"></a>
<li>encoding<br> <li>encoding<br>
Bezeichnet die Zeichentabelle f&uuml;r die zum Client gesendeten Daten. Bezeichnet die Zeichentabelle f&uuml;r die zum Client gesendeten Daten.
M&ouml;gliche Werte sind utf8 und latin1. Standardwert ist utf8. M&ouml;gliche Werte sind utf8 und latin1. Standardwert ist utf8.