Skip to content

Commit b125715

Browse files
authored
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
1 parent e990b47 commit b125715

File tree

4 files changed

+20
-7
lines changed

4 files changed

+20
-7
lines changed

social/email/README.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -46,8 +46,8 @@ Additionally `msg.header` contains the complete header object including
4646

4747
Sends the `msg.payload` as an email, with a subject of `msg.topic`.
4848

49-
The default message recipient can be configured in the node, if it is left
50-
blank it should be set using the `msg.to` property of the incoming message.
49+
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.
50+
5151

5252
The email *from* can be set using `msg.from` but not all mail services allow
5353
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
6464
Alternatively you may provide `msg.attachments` which should contain an array of one or
6565
more attachments in <a href="https://nodemailer.com/message/attachments/" target="_new">nodemailer</a> format.
6666

67-
Uses the *nodemailer* npm module.
67+
If required by your recipient you may also pass in a `msg.envelope` object, typically containing extra from and to properties.
68+
69+
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.
70+
71+
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.
72+
73+
This node uses the *nodemailer* npm module.

social/email/locales/de/61-email.html

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ <h3>Details</h3>
2222
<p>Wenn ein selbstausgestelltes Zertifikates vorliegt, kann sich Nodemailer darüber beschweren und das Senden der Nachricht ablehnen.
2323
In diesem Fall kann versucht werden TLS abzuschalten.</p>
2424
<p><b>Hinweis</b>: Verwendet SMTP mit SSL über Port 465.</p>
25+
<h3>Sichere Verbindung verwenden</h3>
26+
<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>
2527
</script>
2628

2729
<script type="text/html" data-help-name="e-mail in">
@@ -32,7 +34,7 @@ <h3>Details</h3>
3234
<p>Zusätzlich enthält <code>msg.header</code> den kompletten Mailkopf (Header) als Objekt mit
3335
<i>to</i>, <i>cc</i> und anderen eventuell nützlichen Eigenschaften.</p>
3436
<p>Der Node kann optional die Nachricht als gelesen markieren (Standard-Einstellung), sie löschen oder sie als unmarkiert belassen.</p>
35-
<p>Verwendet wird das <a href="https://github.com/mscdex/node-imap/blob/master/README.md" target="_new">node-imap-Modul</a> -
37+
<p>Verwendet wird das <a href="https://github.com/mscdex/node-imap/blob/master/README.md" target="_new">node-imap-Modul</a> -
3638
siehe dort für Informationen über das <code>msg.criteria</code>-Format, falls benötigt.</p>
3739
<p>Alle Dateianhänge mitgeliefert in eingehenden E-Mails können in der <code>msg.attachments</code>-Eigenschaft gefunden werden.
3840
Es wird dann ein Datenfeld (Array) von Objekten übergeben, wo jedes Objekt ein einzelner Dateianhang (attachment) darstellt.
@@ -67,4 +69,4 @@ <h3>Details</h3>
6769
<pre>sudo setcap 'cap_net_bind_service=+eip' $(which node)</pre>
6870
und Neustart von Node-RED.
6971
Es ist zu beachten, dass dadurch alle Knotenanwendungen auf alle Ports zugreifen können.</p>
70-
</script>
72+
</script>

social/email/locales/en-US/61-email.html

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,9 @@ <h3>Details</h3>
2020
<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>
2121
<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>
2222
<p><b>Note</b>: uses SMTP with SSL to port 465.</p>
23+
<h3>Use secure connection</h3>
24+
<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>
25+
2326
</script>
2427

2528
<script type="text/html" data-help-name="e-mail in">
@@ -62,4 +65,4 @@ <h3>Details</h3>
6265
On linux systems this can be done by running
6366
<pre>sudo setcap 'cap_net_bind_service=+eip' $(which node)</pre>
6467
and restarting Node-RED. Be aware - this gives all node applications access to all ports.</p>
65-
</script>
68+
</script>

social/email/locales/ja/61-email.html

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,8 @@
1010
<p>受信側で必要な場合には、<code>msg.envelope</code>fromto</p>
1111
<p>自己署名証明書を用いる場合、Nodemailerはメッセージ送信を拒否することがあります。その際は、TLSを無効にしてみてください。</p>
1212
<p>: SMTP over SSLを465番ポートで利用。</p>
13+
<h3>安全な接続を使用</h3>
14+
<p>有効にすると、サーバーへの接続時に接続でTLSが使用されます。サーバーがSTARTTLS拡張機能をサポートしている場合、無効にするとTLSが使用されます。ほとんどの場合、ポート465に接続している場合は、これを有効に設定します。ポート587または25の場合は、無効のままにします。</p>
1315
</script>
1416

1517
<script type="text/html" data-help-name="e-mail in">
@@ -47,4 +49,4 @@
4749
Linuxシステムでは以下のコマンドを実行し、Node-REDを再起動することで達成できます。
4850
<pre>sudo setcap ‘cap_net_bind_service=+eip’ $(which node)</pre>
4951
これによって、全てのnodeアプリケーションが全ポートにアクセスできる様になることに注意してください.</p>
50-
</script>
52+
</script>

0 commit comments

Comments
 (0)