Tag: dkim

How to include Gmail’s Feedback-ID header in DKIM signature

Feedback-ID is an additional header required by Gmail Feedback Loop to see aggregated data in Google Postmaster tools. Gmail requires it to include in DKIM-Signature. The following guide explains how it can be configured in OpenDKIM :

Edit opendkim.conf

vim /etc/opendkim.conf

Add the following line :

SignHeaders Feedback-ID

Reload openkdim :

systemctl reload opendkim.service

Reload postfix :

systemctl reload postfix.service

Send a test email with swaks to gmail :

swaks --from postmaster@postfix.io --to xxxx@gmail.com --h-Feedback-ID 123:asd:123 --server 127.0.0.1:25

My test mail results :

Authentication-Results: mx.google.com;
dkim=pass header.i=@postfix.io header.s=key1 header.b=oY1NVInb;
spf=pass (google.com: domain of postmaster@postfix.io designates 45.55.57.182 as permitted sender) smtp.mailfrom=postmaster@postfix.io;
dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=postfix.io
Date: Sun, 12 Nov 2017 11:04:42 +0000
DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=postfix.io; s=key1; t=1510484682;       
bh=ecGWgWCJeWxJFeM0urOVWP+KOlqqvsQYKOpYUP8nk7I=; h=From:Feedback-ID:From;     
b=oY1NVInbieJq4f6IWDjHVT25S5zvazNDtWuso2TYAEEa80kuh/KpR9Z2T+NxRuiV8
FODtj02rXnAUD1eaGFlzaUq7+HP/2teVi2lZo4DJYxr5eePOsY2GOIFpy35VtNAmBv
BL+lxdRiNDqbSwipwZDFMTja+SKk5+0eUOyqaDcg=
To: xxxx@gmail.com
From: postmaster@postfix.io
Subject: test Sun, 12 Nov 2017 11:04:42 +0000
Message-Id: <20171112110442.017500@console.postfix.io>
X-Mailer: swaks v20170101.0 jetmore.org/john/code/swaks/
Feedback-ID: 123:asd:123

This is a test mailing

How to configure OpenDKIM with Postfix

In this HowTo, you will find out how we configured OpenDKIM and Postfix(3.1.0) to sign our @postfix.io emails with DKIM. I will not talk about what is DKIM and settings like hash algorithms, DKIM Identity, Selectors etc.

Install OpenDKIM and tools.

apt-get install opendkim opendkim-tools

Add the following settings to /etc/opendkim.conf after “UserID” directive.

Map AuthorDomains to RSA keys.
KeyTable /etc/dkimkeys/rsakeys.table
SigningTable refile:/etc/dkimkeys/signingdomains.table

# "simple" recommended by DKIMCore
Canonicalization simple

Mode sv
SubDomains no
AutoRestart yes
AutoRestartRate 10/1M
Background yes
DNSTimeout 5
SignatureAlgorithm rsa-sha256
OversignHeaders From

Generate RSA key for @postfix.io

cd /etc/dkimkeys/
opendkim-genkey --bits=1024 --selector=key1 --domain=postfix.io --append-domain

It will create two files. “key1.private” which is for server side and “key1.txt” which contain the following DNS record that needs to be created in @postfix.io zone. You can lookup my existing record with dig key1._domainkey.postfix.io TXT +short

key1._domainkey.postfix.io. IN TXT ( "v=DKIM1;k=rsa;p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDVgaYb2qaO92yF1DuoSIWybPgiwQ3dfjN1XhzstnEqfi/GroqtN87BrjEr9BGTTiisocbMZOtfErgfCSq+sCjHohEySdngfnxPUqLYqco+Xe3RlESYngKFU9YUUKXE9OcT3dt3v921h1pZ9BJwQ2RyJ+xANYR5DivfRT2gPCdIWwIDAQAB" )  ; ----- DKIM key key1 for postfix.io

mv key1.private key1.postfix.io.rsa

Add RSAkey reference to KeyTable file in /etc/dkimkeys/rsakeys.table

postfixdkim postfix.io:key1:/etc/dkimkeys/key1.postfix.io.rsa

Add AuthorDomain and RSAKey reference in /etc/dkimkeys/signingdomains.table

*@postfix.io postfixdkim

“*@postfix.io” says domain with any local-part should be signed with this key. “postfixdkim” is reference to RSA key in KeyTable.

Connect OpenDKIM to Postfix. Since Postfix runs in jail environment so its better to keep OpenDKIM also inside Postfix spool directory.

mkdir /var/spool/postfix/opendkim

Update opendkim.sock path to new location in /etc/default/opendkim

SOCKET="local:/var/spool/postfix/opendkim/opendkim.sock"

Configure opendkim in /etc/postfix/main.cf

# Connect OpenDKIM
milter_default_action = accept
milter_protocol = 6
smtpd_milters = local:/opendkim/opendkim.sock
non_smtpd_milters = local:/opendkim/opendkim.sock

Setup proper permissions.

chown -R opendkim:opendkim /etc/opendkim.conf /etc/dkimkeys
chown opendkim:postfix /var/spool/postfix/opendkim

Restart opendkim and postfix

systemctl restart opendkim.service
systemctl restart postfix.service