====== POP3, IMAP and SMTP AUTH for Popular Mail Clients ======
==== Introduction ====
SDF uses SMTP Authentication to allow remote network clients such as desktop, tablet and phone mail applications to use its SMTP server for the purpose of sending (relaying) e-mail messages. SDF users with the VPM, VHOST and MetaARPA memberships have access to the SMTP server.
==== Quick Starter Notes ====
=== Receiving Email ===
* SDF's POP3 server address is **mx.sdf.org** port 110
* SDF's IMAP server address is **mx.sdf.org** port 143 (993 for TLS/SSL)
=== Sending Email ===
* SDF's SMTP server is **mx.sdf.org**
* SDF's SMTP server listens on **port 25** as well as **ports 23, 53, 587 and 8080**. Some ISPs throttle or block activity on port 25.
* Set your SMTP AUTH secret with **mkvpm set //secret//** at the shell. The auth secret is not your SDF password; plese do not set //secret// to your SDF password.
* Your SMTP AUTH username is your **domain name@sdf.org** (ex. alan8r.sdf.org@sdf.org)
* SMTP via **STARTTLS** is recommended. Some email clients may refer to STARTTLS as TLS. TLS/SSL is not STARTTLS.
Please note: the SMTP AUTH secret is set on the command line via mkvpm. The command history of the shell may keep the secret in the history file.
==== The Mail Client Configurations ====
* [[#k-9mail|K-9 Mail for Android]]
* [[#outlookexpress|Outlook Express under Windows]]
* [[#macosx|Mail.App under MacOS X]]
* [[#thunderbird|Mozilla Thunderbird under Windows]]
* [[#heirloommailx|Heirloom Mailx under Linux/BSD]]
* [[#postfix-netbsd6|Postfix MTA on NetBSD 6.x]]
* [[#iphone-mail-application|iPhone Mail Application]]Please note that BlueMail on Android does not support the correct password encryption algorithm, and therefore you cannot set up your SDF email account under BlueMail. The devs have been notified of this bug; if they do fix it, the instructions here will be updated.
----
==== K-9 Mail for Android ====//retrieve//
| imap server | mx.sdf.org |
| Security | SSL/TLS |
| Port | 993 |
| Username | //sdf user name (eg, alan8r)// |
| Authentication | Normal password |
| Password | //password associated with sdf user above// |\\ //send//
| SMTP server | "mx.sdf.org" |
| Security | "STARTTLS" |
| Port | "587" |
| Username | //Your domain name//* |
| Authentication | "Encrypted password" |
| Password | //string set via "mkvpm set YOUR_PASSWORD_HERE"// |//not//
* Email address: your email address (ex. amrowsell@sdf.org)
* Password: your normal shell login password
* Click Continue and then click Manual Config
* Incoming IMAP
* Incoming Server Hostname: mx.sdf.org
* Security: STARTTLS
* Port: 143
* Authentication: Normal password
* Outgoing SMTP (only works if you are MetaARPA or pay for dialup)
* Outgoing Server Hostname: mx.sdf.org
* Port 587
* Security: STARTTLS
* Authentication: Encrypted password
* Username: Your domain name, @sdf.org ... for example, amrowsell.sdf.org@sdf.org
* Click Re-Test and Create Account
* You will be prompted for your SMTP password the first time you go to send mail. This is the password generated by mkvpm on the command line.
----
==== Heirloom Mailx under Linux/BSD ====Add the following to ~homeuser/.nailrc to set the default SMTP relay:
# Remote SDF SMTP relaying (use SDF 'mkvpm' tool to set auth user:pw):
set ssl-verify="ignore"
set smtp-use-starttls
set smtp=mx.sdf.org:587
set smtp-auth=cram-md5
set smtp-auth-user="sdf_user.sdf.org@sdf.org"
set smtp-auth-password="my_password"
The SDF CA is self-signed but can still be used if desired. Retrieve and store\\ somewhere (ie. under ~/.openssl/) as pem file, then edit ~homeuser/.nailrc like so:
set ssl-ca-file="/home/home_user/.openssl/sdf_self-signed_ca.pem"
set ssl-verify="warn" # will issue "self-signed CA" warning
...
Account-specific smtp settings are possible; see the Heirloom Mailx documentation.
----
==== Postfix MTA using libsaslc(3) on NetBSD 6.x: ====
* first, verify that //postfix(1)// knows about //libsaslc// :
% sudo postconf -A
saslc
* create (as superuser) the following postfix config files: ///etc/postfix/main.cf//
(250 2.0.0 s3RFrfvZ010436 Message accepted for delivery)
----
You should now be set up to use SDF's SMTP server. Enjoy!===== iPhone Mail Application =====//This tutorial was written on iOS version 13.3. The exact prompts on other versions may vary.//
- Under **Incoming Settings**, tap to enable **Use SSL**, and for **Server Port**, put "993".
- Tap **SMTP** (Under **Outgoing Mail Server**), to view outgoing mail options, then tap the **Primary Server** (should be **mx.sdf.org**. Change **Authentication** to "MD5 Challenge-Response". Click **Done** at the top.
- Tap **<Account** at the top to go back, then tap **Done**. You should be sending and receiving your SDF mail on your iPhone! $Id: smtpauth.html,v 1.20 2020/01/19 02:03:26 mrguilt Exp $