- 论坛徽章:
- 1
|
Sendmail Domain Key 教學
歡迎轉載 ,但不得作為商業用途
作者: abelyang <abelyang{at}twnic{dot}net{dot}tw>
最後修正時間: 2006/07/24 00:10
轉載時請保持此一宣告
Sendmail + DomainKey 實作分享
前言
Domain Key (DKIM) 目前尚無標準(RFC) 文件,目前 IETF Draft 只到 04 版(最終到 -06),估計還要一年多才會形成 RFC,
相關訊息可參考 IETF DKIM Working Group (http://www.ietf.org/html.charters/dkim-charter.html), 及
Domain Key 網站 ( http://mipassoc.org/dkim/ ), 這個網站可以找到各種 MTA 如何 support DKIM 的文件及 Source
Domain Key 主要是由 Yahoo 所推的網域名稱和郵件伺服器間認證方式, Server 所發出來的信件使用 private key
加密必要的表頭(Ex: From:Subject ate),目的 MTA 在收到信件時取出這些表頭,以 public key (從 DNS 中取出,
後述)進行表頭驗證,從驗證的結果中得到一個 return 值,並針對這些值由目的 MTA 決定動作 (Accept/Reject/Discare..),
所以, MTA 要支援 Domain Key, 不同的 MTA 做法稍有不同,僅以個人較熟悉之 sendmail 進行介紹,以供大家參考.
(據聞 postfix 也支援 Milter , 但個人未用過 postfix,故留待有緣人自己研究了,或上述專門介紹 DKIM 的網站中,
也有各種 MTA 的做法).
最後,值得一提的是, Yahoo 目前使用的 DKIM 版本是 02 版,而目前最新的 Draft 到 04 版,最近的 DKIM Milter 則支援
0.3 版,所以,我們的介紹是配合 Yahoo 使用 DKIM 能支援 02 版的 dk-filter 0.4.1
1. sendmail 準備工作
1.1 sendmail 需支援 Milter
不論 DKIM 也好, SPF 也罷,在 Sendmail 中實現都是以 Milter (Mail Fitler) 來做, Milter 的功能是在 SMTP 協商
的過程式去連接一個外部程式進行檢驗,例如 ehlo/mail from/rcpt to/data 等,每個步驟的過程都可以連接一個外部程
式進行檢驗及行為處理,所以,若 user 有需要可以修改 Envelpe To, Header 等,而 DKIM 的 filter 主要的工作是進行
加 Header 及取 Header 驗證的工作,故只有在 Data 上做文章. 所以您的 sendmail 有沒有支援 Milter 決定了你可否
直接使用 DKIM filter (dk-filter),或是必需重新安裝 sendmail
- # 檢驗 sendmail 是否支援 Milter (-d0 表示要看 Complier 參數,不同的 -dX.Y 各有不同意義)
- [root@eai1 mail]# sendmail -d0 </dev/null
- Version 8.13.7
- Compiled with: DNSMAP LOG MAP_REGEX MATCHGECOS MILTER MIME7TO8 MIME8TO7
- NAMED_BIND NETINET NETUNIX NEWDB PIPELINING SASLv2 SCANF
- STARTTLS USERDB XDEBUG
复制代码
若上面的 Compiled with 有出現 MILTER 即代表了您的 sendmail 巳支援 Milter, 那是最好不過的了,讓您少掉了不少
預備工作,
1.2 我的 sendmail 目前不支援 Milter
此時建議您依自己的情況找一個支援 Milter 的 RPM 或是以 Source RPM 自己重做 RPM (rpmbuild),另外您也可以選擇
以 tarball 的方式做, tarball 的方式做會複雜許多,建議您多參考 Sendmail Compiling 一節說明
http://www.sendmail.org/tips/compiling.html
以我個人的例子來做介紹
- $>cd sendmail-8.13.7
- # 以下您也可以自己用 editor 編輯,若不了解請多參考上述 compiling link 的說明,篇幅所限(其實是我想偷懶),無法
- # 一一說明
- $>cat <<EOF >devtools/Site/site.config.m4
- dnl # 可以在 cf 檔中使用 regexp
- APPENDDEF(`confMAPDEF',`-DMAP_REGEX')
- dnl # BDB , 這個是一定要的
- APPENDDEF(`confENVDEF',`-DNEWDB')
- dnl # MILTER 支援
- APPENDDEF(`conf_sendmail_ENVDEF', `-DMILTER')
- dnl # MILTER 不以 root 啟動
- APPENDDEF(`conf_libmilter_ENVDEF', `-D_FFR_MILTER_ROOT_UNSAFE')
- dnl # DNS 的一些函數
- APPENDDEF(`confENVDEF',`-DDNSMAP')
- dnl # MILTER,這個可以不用,但個人習慣除了 sendmail_ENVDEF 外,還會再加一次 ENVDEF
- APPENDDEF(`confENVDEF',`-DMILTER')
- dnl # STARTTLS, SMTPS 的東西
- APPENDDEF(`confENVDEF',`-DSTARTTLS')
- APPENDDEF(`conf_sendmail_ENVDEF', `-DSTARTTLS')
- dnl # Complier 時所需的一些 include/lib 相關位置
- APPENDDEF(`conf_sendmail_LIBS', `-lssl -lcrypto')
- APPENDDEF(`confLIBDIRS',`-L/usr/local/ssl/lib -L/usr/lib -L/usr/local/lib')
- APPENDDEF(`confINCDIRS',`-L/usr/local/ssl/include -I/usr/include/sasl')
- APPENDDEF(`confINCDIRS',` -I/usr/include -I/usr/local/include')
- APPENDDEF(`confLIBS',`-lsasl2 -lcrypt -lssl -lcrypto -lmilter')
- dnl # SASL , SMTP AUTH 的東西
- APPENDDEF(`confENVDEF',`-DSASL2')
- define(`confAUTH_OPTIONS',`p')
- dnl # TCP WRAPPER , 以便可以使用 /etc/hosts.{allow,deny} 的一些功能
- APPENDDEF(`confENVNEF',`-DTCPWRAPPERS')
- APPENDDEF(`conf_sendmail_LIBS', `-lwrap')
- EOF
- $>sh Build -c
- #這裏會進行 Compiling,理論上不會有什麼 Error , 如果有 Error 需視狀況處理
- $>service sendmail stop
- $>service sendmail stop
- $>service sendmail stop
- $>killall -9 sendmail
- $>sh Build install
- # 下面路徑 sendmail-cf 視您的環境而定,主要是看您的 sendmail.mc 中的 include 位置為何
- $>cp -Rf cf/* /usr/share/sendmail-cf
- $>cd /etc/mail
- # 直接使用原來的 sendmail.mc 即可
- $>m4 sendmail.mc > sendmail.cf
- $>service sendmail start
- # 檢查 sendmail Compiling 的項目,是否出現 MILTER
- $>sendmail -d0 </dev/null
复制代码
以上只是做 sendmail 的昇級,安裝,支援 Milter, 重新啟動等等動作,目的是要讓您的 sendmail 可以加載其他的 Mail Filter,
如果您的 sendmail 巳經支援 MILTER 那重做 SENDMAIL 是不需要的,不過 dk-filter 要求 sendmail 最低版本需 8.13.X,
所以若您不是使用 8.13.X ,您必需找 rpm 來裝或是自己用 tarball 來裝(用 Source RPM 也很簡單的),如果您的 Sendmail 巳是
8.13.X 且支援 MILTER,那第一節部份您是可以不用管的.
2. 安裝 Domain Key Filter (dk-filter)
2.1 下載與安裝
project 網址為 https://sourceforge.net/projects/dkim-milter/ , 撰寫本文時版本為 0.5.1,因為 DKIM 的標準尚
在討論中,但基本鶵形巳經有共識,相信未來只是 wording 的工作,但是內容並不會有太大的改變
(註:我用 0.5.1 無法通過 Yahoo 的 DKIM 認證, 0.4.1 是最多人用的)
- $>wget http://superb-west.dl.sourceforge.net/sourceforge/dkim-milter/dkim-milter-0.4.1.tar.gz
- $>tar -zxvf dkim-milter-0.4.1.tar.gz
- $>cd dkim-milter-0.4.1
- $>sh Build -c
- # 如果 compiling 時有 SSL 相關的函數出錯,請修改 dk-filter/Makefile.m4 中的
- # APPENDDEF(`confINCDIRS', `-I/usr/local/ssl/include ')
- # APPENDDEF(`confLIBDIRS', `-L/usr/local/ssl/lib ')
- # 到對應的路徑
- $>sh Build install
复制代码
2.2 了解 dk-filter 參數的涵意
- $>dk-filter -h
- -a peerlist file containing list of hosts to ignore # 那些 host 不做 DKIM check
- -A auto-restart # dk-filter 死掉時自動重啟
- -b modes select operating modes # s (singer) / v (verify) 預設為 sv
- -c canon canonicalization to use when signing # 預設是 simple (表頭不改變),
- # 另外為 relaxed (表頭可能修正,去除空白,不換行等等)
- -C config configuration info (see man page) # 設定檔,詳見下述
- -d domlist domains to sign # 要 sign 的 domain 列表,以逗號區隔
- -D also sign subdomains # 一併 sign -d 之下 domain 的 sub-domain
- -f don't fork-and-exit # 前景執行
- -h append identifying header # 會在 Mail Header 中加入 X-DomainKeys 資訊
- -H sign with explicit header lists # DomainKey-Signature 中說明 sign 的 header 資訊
- -i ilist file containing list of internal (signing) hosts # 只做 sign, 不做 verify,預設為 127.0.0.1
- -I elist file containing list of external domain clients # 透過此主機轉信之來源做 sign,不做 verify
- -l log activity to system log # log 必要訊息到 maillog
- -m mtalist MTA daemon names for which to sign # MTA 名字,也就是 DaemonPortOptions 中的 Name,預設是全部
- -M macrolist MTA macros which enable signing # 不詳,沒用過
- -o hdrlist list of headers to omit from signing # 那些 Header 不 sign,Ex: -o to,subject,date , From 一定要 sign
- -P pidfile file to which to write pid # pid file 路徑
- -s keyfile location of secret key file # private key
- -S selector selector to use when signing # selector,會以 selector._domainkey.Domain 進行 type=TXT 查詢
- -u userid change to specified userid # 以什麼身份執行
- -V print version number and terminate # 版本資訊
复制代码
上述參數的 hosts 格式可以是 IP,Domain 例如:
- # hosts format for dk-filter
- 1.2.3.4
- 100.100/16
- eai1.twnic.tw
- .twnic.net.tw
复制代码
上述參數 -C config 檔中的設定方法,
- #result=action,result=action,...,括號內為簡寫
- #Results:
- # 依序為認證失敗,DNS 錯誤,Milter 內部錯誤,沒有 DKIM 欄位,沒有簽章欄位(b=)
- badsignature(bad)
- dnserror(dns)
- internal(int)
- nosignature(no)
- signature-missing(miss)
- #action:
- # 依序為 同意,丟棄,臨時失敗,拒絕
- accept(a)
- discard(d)
- tempfail(t)
- reject(r)
复制代码
所以若要拒絕沒有 DKIM 的信件,對於內部錯誤回應臨時失敗,拒絕認證失敗的信件即為 -C bad=r,no=r,int=t
2.3 建立 dk-filter running script
建立 /etc/sysconfig/dk-filter 檔
- #!/bin/bash
- #以下請自行調整,主要為對應啟動時的參數
- SOCKET="inet:8891@localhost"
- CANON="simple"
- DOMAIN=$(hostname)
- PRIVATE_KEY="/etc/mail/abelyang.private"
- USER=smmsp
- HEADER_IGNORE="subject,date,message-id,to"
- SELECTOR=$(date +%Y)
- FILTER_RULE="bad=r,dns=r,int=r,no=a,miss=r"
复制代码
建立 /etc/rc.d/init.d/dk-filter 啟動程式
(這裏有點隨便寫,能夠 start/stop 而以,但不能對應到 chkconfig 使用 =.=)
- #!/bin/bash
- RETVAL=0
- prog="dk-filter"
- if [ -x /usr/bin/$prog ] ; then
- PROGDIR=/usr/bin
- elif [ -x /usr/local/bin/$prog ] ; then
- PROGDIR=/usr/local/bin
- else
- exit 0
- fi
- SOCKET="inet:8891@localhost"
- # Source configuration
- if [ -f /etc/sysconfig/$prog ] ; then
- . /etc/sysconfig/$prog
- fi
- start() {
- ulimit -s 2048
- $PROGDIR/$prog -H -h -l -P /var/run/dk-filter.pid \
- $([ -n "$FILTER_RULE" ] && echo "-C $FILTER_RULE") \
- $([ -n "$DOMAIN" ] && echo "-d $DOMAIN") \
- $([ -n "$SELECTOR" ] && echo "-S $SELECTOR") \
- $([ -n "$PRIVATE_KEY" ] && echo "-s $PRIVATE_KEY") \
- $([ -n "$CANON" ] && echo "-c $CANON") \
- $([ -n "$USER" ] && echo "-u $USER") \
- $([ -n "$HEADER_IGNORE" ] && echo "-o $HEADER_IGNORE") \
- -p $SOCKET
- echo $cmd
- echo
- # Start daemon
- echo "Starting $prog: [OK]"
- [ -e $SOCKET ] && rm -f $SOCKET
- return $RETVAL
- }
- stop() {
- # Stop daemon
- echo -n "Shutting down $prog: [OK]"
- killall -9 $prog
- RETVAL=$?
- echo
- [ -e $SOCKET ] && rm -f $SOCKET
- # Stop daemon
- echo -n "Shutting down $prog: "
- killproc $prog
- echo
- [ -e $MX_SOCKET ] && rm -f $MX_SOCKET
- }
- # See how we were called.
- case "$1" in
- start)
- start
- ;;
- stop)
- stop $2
- ;;
- restart)
- stop
- start
- RETVAL=$?
- ;;
- *)
- echo "Usage: $0 {start|stop|restart}"
- exit 1
- esac
- exit $RETVAL
复制代码
以上都只是軟體的準備動作,接下來我們要做的就是實際的簽章部份了
3. 設定 DKIM 的 private/public key 及建立 DNS 資訊
DKIM 的 key 使用 rsa 加密,不需要經過 CA 認證,所以 key 值都是由自己建立的,而一般會建議 key 長度小於 1024,主要
是因為最後要把 public key 放到 DNS 資訊記錄中,若 key 太長會造成 DNS 封包放不下,容易發生一些副作用,所以這是做
key 時要注意的地方 (一般 DNS query 稱為 basic query, udp 最大只能 512 bytes, 若要超過 512 bytes, 則 DNS query
需轉為 53/TCP,並設立模式為 truncate , 或是使用 EDNS0,讓 DNS 的回應可以大於 512 個 bytes) |
|