mirror of
https://github.com/node-red/node-red-nodes.git
synced 2023-10-10 13:36:58 +02:00
b12571527f
Updated README,md to better reflect the updated documentation found in the node
73 lines
6.4 KiB
HTML
73 lines
6.4 KiB
HTML
<script type="text/html" data-help-name="e-mail">
|
|
<p>Versand von <code>msg.payload</code> als E-Mail mit <code>msg.topic</code> als Subjekt.</p>
|
|
<p>Der Standard-Nachrichtenempfänger kann im Node vorgegeben werden.
|
|
Wenn nicht angegeben, muss der Nachrichtenempfänger über die <code>msg.to</code>-Eigenschaft
|
|
der eingehenden Nachricht übergeben werden.
|
|
Ebenso können einige oder alle vorgegeben werden von: <code>msg.cc</code>, <code>msg.bcc</code>, <code>msg.replyTo</code>,
|
|
<code>msg.inReplyTo</code>, <code>msg.references</code>, <code>msg.headers</code> oder <code>msg.priority</code>-Eigenschaften.</p>
|
|
<p>Es kann optional auch <code>msg.from</code> in den Nutzdaten (Payload) vorgegeben werden,
|
|
was die eingestellte <code>Benutzer-ID</code> überschreiben würde.</p>
|
|
<h3>Gmail-Benutzer</h3>
|
|
<p>Beim Zugriff auf Gmail kann es nötig sein, entweder <a target="_new" href="https://support.google.com/mail/answer/185833?hl=de">ein App-Passwort</a> zu aktivieren oder den <a target="_new" href="https://support.google.com/accounts/answer/6010255?hl=de">Zugriff aufs Google-Konto durch weniger sichere Apps</a> über die Google-Konto-Einstellungen zu erlauben.</p>
|
|
<h3>Details</h3>
|
|
<p>Die Nachricht in <code>msg.payload</code> kann als HTML formatiert sein.
|
|
Ein separater, davon abweichender Plaintext kann in <code>msg.plaintext</code> angegeben werden. Ansonsten wird auch <code>msg.payload</code> verwendet.
|
|
<code>msg.plaintext</code> wird ignoriert, wenn <code>msg.payload</code> kein HTML enthält.</p>
|
|
<p>Wenn <code>msg.payload</code> ein binärer Buffer ist, so wird sie in einen Nachrichten-Dateianhang (attachment) konvertiert.
|
|
Der Dateiname sollte mittels <code>msg.filename</code> angegeben werden.
|
|
Optional kann <code>msg.description</code> als Nachrichtentext hinzugefügt werden.</p>
|
|
<p>Alternativ kann auch <code>msg.attachments</code> übergeben werden, welches ein Datenfeld (array) mit einen oder mehreren
|
|
Dateianhängen im <a href="https://nodemailer.com/message/attachments/" target="_new">nodemailer</a>-Format enthält.</p>
|
|
<p>Falls vom Empfänger benötigt, kann zusätzlich über <code>msg.envelope</code> ein Objekt übergeben werden, welches typischerweise zusätzliche <code>from</code>- und <code>to</code>-Eigenschaften enthält.</p>
|
|
<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">
|
|
<p>Regelmäßiger Abruf von E-Mails von einem POP3- oder IMAP-Server und Weiterleitung der Nachricht, falls diese noch nicht angezeigt wurde.</p>
|
|
<p>Der Subjekttext wird in <code>msg.topic</code> und der Klartextinhalt in <code>msg.payload</code> abgelegt.
|
|
Wenn text/html vorliegt, dann wird dieser in <code>msg.html</code> abgelegt.
|
|
<code>msg.from</code> und <code>msg.date</code> sind ebenfalls für die weitere Nutzung gesetzt.</p>
|
|
<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> -
|
|
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.
|
|
Das Objektformat ist:</p>
|
|
<pre>
|
|
{
|
|
contentType: // Die MIME-Inhaltsbeschreibung (MIME content description)
|
|
fileName: // Ein vorgeschlagener Dateiname, der diesem Anhang zugeordnet ist
|
|
transferEncoding: // Wie wurde der ursprüngliche E-Mail-Anhang verschlüsselt?
|
|
contentDisposition: // Unbekannt
|
|
generatedFileName: // Ein vorgeschlagener Dateiname, der diesem Anhang zugeordnet ist
|
|
contentId: // Eine eindeutige generierte ID für diesen Anhang
|
|
checksum: // Eine Prüfsumme gegen die Daten
|
|
length: // Datengröße in Bytes
|
|
content: // Der tatsächliche Inhalt der in einem Node.js-Pufferobjekt enthaltenen Daten
|
|
// Wir können dies in eine base64-Datenzeichenfolge mit content.toString('base64') umwandeln
|
|
}
|
|
</pre>
|
|
<p><b>Hinweis</b>: Bei POP3 sind die Standard-Portnummern 110 für ungesichertes TCP und 995 für SSL. Bei IMAP 143 für ungesichertes TCP und 993 für SSL.</p>
|
|
<p><b>Hinweis</b>: Mit der Option 'STARTTLS' kann eine bestehende ungesicherte Verbindung zu einer gesicherten geupgraded werden. Die Einstellung 'immer' versucht dies immer, 'wenn erforderlich' wenn es erforderlich ist, und 'nie' gar nicht.</p>
|
|
<p><b>Hinweis</b>: Das maximale Aktualisierungsintervall ist 2147483 Sekunden (24,8 Tage).</p>
|
|
|
|
</script>
|
|
|
|
<script type="text/html" data-help-name="e-mail mta">
|
|
<p>Mail Transfer Agent - Portüberwachung für eingehende SMTP-Mails.</p>
|
|
<p><b>Hinweis</b>: "NICHT für Produktivbetrieb", da keine Sicherheitsfunktionen eingebaut sind!
|
|
Dies dient hauptsächlich zum lokalen Testen des Versands ausgehender E-Mails,
|
|
kann jedoch bei Bedarf verwendet werden als Mail-Weiterleitung an einen echten E-Mail-Dienst.</p>
|
|
<p>Um Ports unter 1024 (z.B. 25 or 465) zu benutzen, könnten höhere Zugriffsrechte nötig sein.
|
|
Auf Linux-Systemen kann dieses erreicht werden durch Starten von
|
|
<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>
|