An email sandbox for local dev, CI and staging.

import nodemailer from 'nodemailer';

// One environment variable separates local dev, CI and staging from
// production: point SMTP_HOST at the sandbox and nothing leaves it.
export const mailer = nodemailer.createTransport({
  host: process.env.SMTP_HOST, // smtp.mailqa.io
  port: Number(process.env.SMTP_PORT ?? 587),
  secure: false, // STARTTLS is negotiated on 587
  auth: {
    user: process.env.SMTP_USER, // your organization's SMTP username
    pass: process.env.SMTP_PASS,
  },
});

await mailer.sendMail({
  from: 'Acme <noreply@acme.dev>',
  to: 'signup+run-4187@your-org.mailqa.io',
  subject: 'Verify your email address',
  html: '<a href="https://acme.dev/verify?t=9f2c">Confirm email</a>',
});

# The same block works in development.rb and test.rb — only the
# environment the credentials come from changes.
config.action_mailer.delivery_method = :smtp
config.action_mailer.perform_deliveries = true
config.action_mailer.smtp_settings = {
  address:              "smtp.mailqa.io",
  port:                 587,
  user_name:            ENV.fetch("MAILQA_SMTP_USER"),
  password:             ENV.fetch("MAILQA_SMTP_PASS"),
  authentication:       :plain,
  enable_starttls_auto: true,
}

import os

# The staging / CI settings module. The console backend shows you the
# mail once; the sandbox keeps it, renders it and lets a test wait on it.
EMAIL_BACKEND = "django.core.mail.backends.smtp.EmailBackend"
EMAIL_HOST = "smtp.mailqa.io"
EMAIL_PORT = 587
EMAIL_USE_TLS = True  # STARTTLS
EMAIL_HOST_USER = os.environ["MAILQA_SMTP_USER"]
EMAIL_HOST_PASSWORD = os.environ["MAILQA_SMTP_PASS"]
DEFAULT_FROM_EMAIL = "Acme <noreply@acme.dev>"

# Laravel's mail config reads straight from the environment, so the
# sandbox is a different .env, not different code.
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailqa.io
MAIL_PORT=587
MAIL_USERNAME=your-org
MAIL_PASSWORD=
MAIL_FROM_ADDRESS=noreply@acme.dev
MAIL_FROM_NAME="Acme"

# Activate with SPRING_PROFILES_ACTIVE=staging; JavaMailSender picks
# these up with no code change.
spring:
  mail:
    host: smtp.mailqa.io
    port: 587
    username: ${MAILQA_SMTP_USER}
    password: ${MAILQA_SMTP_PASS}
    properties:
      mail.smtp.auth: true
      mail.smtp.starttls.enable: true
      mail.smtp.starttls.required: true

using MailKit.Net.Smtp;
using MailKit.Security;

// MailKit is the client Microsoft points to now that
// System.Net.Mail.SmtpClient is obsolete.
using var client = new SmtpClient();
await client.ConnectAsync("smtp.mailqa.io", 587, SecureSocketOptions.StartTls);
await client.AuthenticateAsync(
    Environment.GetEnvironmentVariable("MAILQA_SMTP_USER"),
    Environment.GetEnvironmentVariable("MAILQA_SMTP_PASS"));
await client.SendAsync(message);
await client.DisconnectAsync(quit: true);

// net/smtp upgrades to STARTTLS on its own when the server offers it,
// and PlainAuth refuses to send the password over plaintext otherwise.
auth := smtp.PlainAuth(
	"",
	os.Getenv("MAILQA_SMTP_USER"),
	os.Getenv("MAILQA_SMTP_PASS"),
	"smtp.mailqa.io",
)

err := smtp.SendMail(
	"smtp.mailqa.io:587",
	auth,
	"noreply@acme.dev",
	[]string{"signup+run-4187@your-org.mailqa.io"},
	msg,
)

# A one-line smoke test from any machine with swaks on it —
# no application, no framework, just SMTP.
swaks --server smtp.mailqa.io:587 --tls \
  --auth-user "$MAILQA_SMTP_USER" --auth-password "$MAILQA_SMTP_PASS" \
  --from noreply@acme.dev \
  --to signup+run-4187@your-org.mailqa.io \
  --header "Subject: Your login code is 481330" \
  --body "Your login code is 481330."