node-red-node-email: Added documentation use of: Use secure connection & update Readme documentation (#824)

Updated README,md to better reflect the updated documentation found in the node
This commit is contained in:
meeki007
2021-07-31 04:33:41 -04:00
committed by GitHub
parent e990b47c65
commit b12571527f
4 changed files with 20 additions and 7 deletions

View File

@@ -46,8 +46,8 @@ Additionally `msg.header` contains the complete header object including
Sends the `msg.payload` as an email, with a subject of `msg.topic`.
The default message recipient can be configured in the node, if it is left
blank it should be set using the `msg.to` property of the incoming message.
The default message recipient can be configured in the node, if it is left blank it should be set using the `msg.to` property of the incoming message. You can also specify any or all of: `msg.cc`, `msg.bcc`, `msg.replyTo`, `msg.inReplyTo`, `msg.references`, `msg.headers`, or `msg.priority` properties.
The email *from* can be set using `msg.from` but not all mail services allow
this unless `msg.from` is also a valid userid or email address associated with
@@ -64,4 +64,10 @@ The filename should be set using `msg.filename`. Optionally
Alternatively you may provide `msg.attachments` which should contain an array of one or
more attachments in <a href="https://nodemailer.com/message/attachments/" target="_new">nodemailer</a> format.
Uses the *nodemailer* npm module.
If required by your recipient you may also pass in a `msg.envelope` object, typically containing extra from and to properties.
If you have own signed certificates, Nodemailer can complain about that and refuse sending the message. In this case you can try switching off TLS.
Use secure connection - If enabled the connection will use TLS when connecting to server. If disabled then TLS is used if server supports the STARTTLS extension. In most cases set this to enabled if you are connecting to port 465. For port 587 or 25 keep it disabled.
This node uses the *nodemailer* npm module.

View File

@@ -22,6 +22,8 @@
<p>Wenn ein selbstausgestelltes Zertifikates vorliegt, kann sich Nodemailer darüber beschweren und das Senden der Nachricht ablehnen.
In diesem Fall kann versucht werden TLS abzuschalten.</p>
<p><b>Hinweis</b>: Verwendet SMTP mit SSL über Port 465.</p>
<h3>Sichere Verbindung verwenden</h3>
<p>Wenn diese Option aktiviert ist, verwendet die Verbindung TLS, wenn eine Verbindung zum Server hergestellt wird. Wenn deaktiviert, wird TLS verwendet, wenn der Server die STARTTLS-Erweiterung unterstützt. In den meisten Fällen setzen Sie dies auf aktiviert, wenn Sie eine Verbindung zu Port 465 herstellen. Lassen Sie es für Port 587 oder 25 deaktiviert.</p>
</script>
<script type="text/html" data-help-name="e-mail in">
@@ -32,7 +34,7 @@
<p>Zusätzlich enthält <code>msg.header</code> den kompletten Mailkopf (Header) als Objekt mit
<i>to</i>, <i>cc</i> und anderen eventuell nützlichen Eigenschaften.</p>
<p>Der Node kann optional die Nachricht als gelesen markieren (Standard-Einstellung), sie löschen oder sie als unmarkiert belassen.</p>
<p>Verwendet wird das <a href="https://github.com/mscdex/node-imap/blob/master/README.md" target="_new">node-imap-Modul</a> -
<p>Verwendet wird das <a href="https://github.com/mscdex/node-imap/blob/master/README.md" target="_new">node-imap-Modul</a> -
siehe dort für Informationen über das <code>msg.criteria</code>-Format, falls benötigt.</p>
<p>Alle Dateianhänge mitgeliefert in eingehenden E-Mails können in der <code>msg.attachments</code>-Eigenschaft gefunden werden.
Es wird dann ein Datenfeld (Array) von Objekten übergeben, wo jedes Objekt ein einzelner Dateianhang (attachment) darstellt.
@@ -67,4 +69,4 @@
<pre>sudo setcap 'cap_net_bind_service=+eip' $(which node)</pre>
und Neustart von Node-RED.
Es ist zu beachten, dass dadurch alle Knotenanwendungen auf alle Ports zugreifen können.</p>
</script>
</script>

View File

@@ -20,6 +20,9 @@
<p>If required by your recipient you may also pass in a <code>msg.envelope</code> object, typically containing extra from and to properties.</p>
<p>If you have own signed certificates, Nodemailer can complain about that and refuse sending the message. In this case you can try switching off TLS.</p>
<p><b>Note</b>: uses SMTP with SSL to port 465.</p>
<h3>Use secure connection</h3>
<p>If enabled the connection will use TLS when connecting to server. If disabled then TLS is used if server supports the STARTTLS extension. In most cases set this to enabled if you are connecting to port 465. For port 587 or 25 keep it disabled.</p>
</script>
<script type="text/html" data-help-name="e-mail in">
@@ -62,4 +65,4 @@
On linux systems this can be done by running
<pre>sudo setcap 'cap_net_bind_service=+eip' $(which node)</pre>
and restarting Node-RED. Be aware - this gives all node applications access to all ports.</p>
</script>
</script>

View File

@@ -10,6 +10,8 @@
<p>受信側で必要な場合には<code>msg.envelope</code>fromto</p>
<p>自己署名証明書を用いる場合Nodemailerはメッセージ送信を拒否することがありますその際はTLSを無効にしてみてください</p>
<p>: SMTP over SSLを465番ポートで利用</p>
<h3>安全な接続を使用</h3>
<p>有効にするとサーバーへの接続時に接続でTLSが使用されますサーバーがSTARTTLS拡張機能をサポートしている場合無効にするとTLSが使用されますほとんどの場合ポート465に接続している場合はこれを有効に設定しますポート587または25の場合は無効のままにします</p>
</script>
<script type="text/html" data-help-name="e-mail in">
@@ -47,4 +49,4 @@
Linuxシステムでは以下のコマンドを実行しNode-REDを再起動することで達成できます
<pre>sudo setcap cap_net_bind_service=+eip $(which node)</pre>
これによって全てのnodeアプリケーションが全ポートにアクセスできる様になることに注意してください.</p>
</script>
</script>