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
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
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>オブジェクトを指定できます。このオブジェクトには、fromやtoを指定します。</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>