hewgill.com pydkim Search

pydkim

NOTE: This page describes the last release of pydkim from 2008. The latest version is a fork found at dkimpy in Launchpad and is under active development.

The pydkim module is a Python module that implements DKIM (DomainKeys Identified Mail) email signing and verification.

Download

The pydkim library is provided in source form.

• pydkim-0.3.tar.gz
  MD5 (pydkim-0.3.tar.gz) = 530769b4e79f41341020c4b28f340ea5

Prerequisites

• Python 2.5 (or greater) is required for the hashlib standard module which implements SHA256.
• The dnspython library is required for lookup of TXT records in DNS.

Usage

The pydkim library offers one module called dkim. The sign() function takes an RFC822 formatted message, along with some signing options, and returns a DKIM-Signature header line that can be prepended to the message. The verify() function takes an RFC822 formatted message, and returns True or False depending on whether the signature verifies correctly.

• Full pydkim documentation

Two helper programs are also supplied: dkimsign.py and dkimverify.py.

dkimsign.py is a filter that reads an RFC822 message on standard input, and writes the same message on standard output with a DKIM-Signature line prepended. The signing options are specified on the command line:

The identity is optional and defaults to "@domain".

dkimverify.py reads an RFC822 message on standard input, and returns with exit code 0 if the signature verifies successfully. Otherwise, it returns with exit code 1.