mirror of
https://github.com/mjl-/mox.git
synced 2024-12-27 08:53:48 +03:00
58 lines
1.9 KiB
Go
58 lines
1.9 KiB
Go
package smtpclient_test
|
|
|
|
import (
|
|
"context"
|
|
"log"
|
|
"net"
|
|
"strings"
|
|
|
|
"golang.org/x/exp/slog"
|
|
|
|
"github.com/mjl-/mox/dns"
|
|
"github.com/mjl-/mox/sasl"
|
|
"github.com/mjl-/mox/smtpclient"
|
|
)
|
|
|
|
func ExampleClient() {
|
|
// Submit a message to an SMTP server, with authentication. The SMTP server is
|
|
// responsible for getting the message delivered.
|
|
|
|
// Make TCP connection to submission server.
|
|
conn, err := net.Dial("tcp", "submit.example.org:465")
|
|
if err != nil {
|
|
log.Fatalf("dial submission server: %v", err)
|
|
}
|
|
defer conn.Close()
|
|
|
|
// Initialize the SMTP session, with a EHLO, STARTTLS and authentication.
|
|
// Verify the server TLS certificate with PKIX/WebPKI.
|
|
ctx := context.Background()
|
|
tlsVerifyPKIX := true
|
|
opts := smtpclient.Opts{
|
|
Auth: []sasl.Client{
|
|
// Prefer strongest authentication mechanism, allow up to older CRAM-MD5.
|
|
sasl.NewClientSCRAMSHA256("mjl", "test1234"),
|
|
sasl.NewClientSCRAMSHA1("mjl", "test1234"),
|
|
sasl.NewClientCRAMMD5("mjl", "test1234"),
|
|
},
|
|
}
|
|
localname := dns.Domain{ASCII: "localhost"}
|
|
remotename := dns.Domain{ASCII: "submit.example.org"}
|
|
client, err := smtpclient.New(ctx, slog.Default(), conn, smtpclient.TLSImmediate, tlsVerifyPKIX, localname, remotename, opts)
|
|
if err != nil {
|
|
log.Fatalf("initialize smtp to submission server: %v", err)
|
|
}
|
|
defer client.Close()
|
|
|
|
// Send the message to the server, which will add it to its queue.
|
|
req8bitmime := false // ASCII-only, so 8bitmime not required.
|
|
reqSMTPUTF8 := false // No UTF-8 headers, so smtputf8 not required.
|
|
requireTLS := false // Not supported by most servers at the time of writing.
|
|
msg := "From: <mjl@example.org>\r\nTo: <other@example.org>\r\nSubject: hi\r\n\r\nnice to test you.\r\n"
|
|
err = client.Deliver(ctx, "mjl@example.org", "other@example.com", int64(len(msg)), strings.NewReader(msg), req8bitmime, reqSMTPUTF8, requireTLS)
|
|
if err != nil {
|
|
log.Fatalf("submit message to smtp server: %v", err)
|
|
}
|
|
|
|
// Message has been submitted.
|
|
}
|