mirror of
https://github.com/documize/community.git
synced 2025-07-19 13:19:43 +02:00
138 lines
3.2 KiB
Go
138 lines
3.2 KiB
Go
// Copyright 2016 Documize Inc. <legal@documize.com>. All rights reserved.
|
|
//
|
|
// This software (Documize Community Edition) is licensed under
|
|
// GNU AGPL v3 http://www.gnu.org/licenses/agpl-3.0.en.html
|
|
//
|
|
// You can operate outside the AGPL restrictions by purchasing
|
|
// Documize Enterprise Edition and obtaining a commercial license
|
|
// by contacting <sales@documize.com>.
|
|
//
|
|
// https://documize.com
|
|
|
|
// Package smtp provides access to SMTP server for sending email.
|
|
package smtp
|
|
|
|
import (
|
|
"crypto/tls"
|
|
"encoding/base64"
|
|
"strings"
|
|
|
|
"github.com/documize/community/core/mail"
|
|
)
|
|
|
|
// Config is used to create SMTP server connection
|
|
type Config struct {
|
|
// IP/hostname of SMTP server
|
|
Host string
|
|
|
|
// Port number of SMTP server
|
|
Port int
|
|
|
|
// Username for authentication with SMTP server
|
|
Username string
|
|
|
|
// Password for authentication with SMTP server
|
|
Password string
|
|
|
|
// SenderEmail is FROM address
|
|
SenderEmail string
|
|
|
|
// SenderName is FROM display name
|
|
SenderName string
|
|
|
|
// AnonymousAuth does not send username/password to server
|
|
AnonymousAuth bool
|
|
|
|
// Base64EncodeCredentials encodes User and Password as base64 before sending to SMTP server
|
|
Base64EncodeCredentials bool
|
|
|
|
// UseSSL uses SMTP SSL connection with SMTP server
|
|
UseSSL bool
|
|
|
|
// SkipSSLVerify allows unverified certificates
|
|
SkipSSLVerify bool
|
|
|
|
// SenderFQDN is the sending servers fully qualified domain name
|
|
// as some SMTP servers require a value other than localhost.
|
|
// e.g. docs.example.org
|
|
SenderFQDN string
|
|
}
|
|
|
|
// Connect returns open connection to server for sending email
|
|
func Connect(c Config) (d *mail.Dialer, err error) {
|
|
// prepare credentials
|
|
u := strings.TrimSpace(c.Username)
|
|
p := strings.TrimSpace(c.Password)
|
|
|
|
// anonymous, no credentials
|
|
if c.AnonymousAuth {
|
|
u = ""
|
|
p = ""
|
|
}
|
|
|
|
// base64 encode if required
|
|
if c.Base64EncodeCredentials {
|
|
u = base64.StdEncoding.EncodeToString([]byte(u))
|
|
p = base64.StdEncoding.EncodeToString([]byte(p))
|
|
}
|
|
|
|
// Basic server
|
|
d = mail.NewDialer(c.Host, c.Port, u, p)
|
|
|
|
// Use SSL
|
|
d.SSL = c.UseSSL
|
|
|
|
// verify SSL cert chain
|
|
d.TLSConfig = &tls.Config{InsecureSkipVerify: c.SkipSSLVerify}
|
|
|
|
// TLS mode
|
|
d.StartTLSPolicy = mail.OpportunisticStartTLS
|
|
|
|
// Use FQDN of sending server if we have one.
|
|
c.SenderFQDN = strings.TrimSpace(c.SenderFQDN)
|
|
if len(c.SenderFQDN) > 0 {
|
|
d.LocalName = c.SenderFQDN
|
|
}
|
|
|
|
return d, nil
|
|
}
|
|
|
|
// EmailMessage represents email to be sent.
|
|
type EmailMessage struct {
|
|
ToEmail string
|
|
ToName string
|
|
Subject string
|
|
BodyHTML string
|
|
ReplyTo string
|
|
ReplyName string
|
|
}
|
|
|
|
// SendMessage sends email using specified SMTP connection
|
|
func SendMessage(d *mail.Dialer, c Config, em EmailMessage) (b bool, err error) {
|
|
m := mail.NewMessage()
|
|
|
|
// participants
|
|
m.SetHeader("From", m.FormatAddress(c.SenderEmail, c.SenderName))
|
|
m.SetHeader("To", m.FormatAddress(em.ToEmail, em.ToName))
|
|
|
|
// Where do replies go?
|
|
reply := c.SenderEmail
|
|
replyName := c.SenderName
|
|
if len(em.ReplyTo) > 0 {
|
|
reply = em.ReplyTo
|
|
}
|
|
if len(em.ReplyName) > 0 {
|
|
replyName = em.ReplyName
|
|
}
|
|
m.SetAddressHeader("Reply-To", reply, replyName)
|
|
|
|
// content
|
|
m.SetHeader("Subject", em.Subject)
|
|
m.SetBody("text/html", em.BodyHTML)
|
|
|
|
// send email
|
|
if err = d.DialAndSend(m); err != nil {
|
|
return false, err
|
|
}
|
|
return true, nil
|
|
}
|