File: README

package info (click to toggle)
libdkim 1%3A1.0.21-3
  • links: PTS
  • area: main
  • in suites: jessie, jessie-kfreebsd, wheezy
  • size: 528 kB
  • ctags: 631
  • sloc: cpp: 3,595; sh: 352; makefile: 143
file content (147 lines) | stat: -rw-r--r-- 4,296 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
Alt-N DKIM Open Source Project
Copyright 2008 Alt-N Technologies, Ltd.

This code incorporates intellectual property owned by Yahoo! and licensed 
pursuant to the Yahoo! DomainKeys Patent License Agreement.

By making, using, selling, offering for sale, importing, and/or sublicensing 
Implementations as permitted, you agree to the terms and conditions of the 
Yahoo! DomainKeys Patent License Agreement or other agreement contained herein.

----------------------
1.0.21 
----------------------
  o updated verifier to latest draft of DKIM ADSP
  o fixed some error codes overlapping success codes
  o added signature and identity domain information to 
    DKIMVerifyDetails structure

-------------------
1.0.20 Aug 26, 2008
-------------------
  o verifier by default requires all From headers in the
    message to be signed

-------------------
1.0.19 May 12, 2008
-------------------
  o fix to trailing lines of whitespace not being ignored
    with relaxed body canonicalization

----------------------
1.0.18 January 9, 2008
----------------------
  o fix to incorrect body hashes for empty bodies
  o fix to verification error for signatures with whitespace
    around the b= value
  o more fixes to verification errors with whitespace between
    the header name and :

-----------------------
1.0.17 October 29, 2007
-----------------------
  o verifier fully supports g= value wildcard matching
  o fix to verifier not canonicalizing message headers that
    had whitespace between the header name and :
  o fix to verifier not validating t= value or comparing it
    to the x= value
  o fix to verifier accepting blank values for l= and x=

----------------------
1.0.16 August 22, 2007
----------------------
  o supports SSP (Sender Signing Practices) draft 00
  o added verifier option to save canonicalized message data

-------------------
1.0.15 May 30, 2007
-------------------
  o fix to DKIM_FAIL being returned for messages with
    invalid signatures

---------------------
1.0.14 April 24, 2007
---------------------
  o updated to final publication of DKIM (version 1)
  o fix to buffer overflow parsing malformed From headers

------------------------
1.0.13 February 22, 2007
------------------------
  o by default, verifier requires subject header to be signed
  o added visual studio 2005 project files
  o changed q=dns to q=dns/txt in signer
  o fixed hash for empty body

----------------------
1.0.12 August 31, 2006
----------------------
  o added verification option to not check the sender's policy
    (the default is to not check)

--------------------
1.0.11 July 25, 2006
--------------------
  o updated to 04 draft

------------------------
1.0.10 February 21, 2006
------------------------
  o added sha-256 hashing capability. Can sign with either
    sha-1, sha-256, or both. Either type can be verified.
    This version requires OpenSSL 0.9.8a

-----------------------
1.0.9 November 22, 2005
-----------------------
  o update to 01 draft

-------------------
1.0.8 July 28, 2005
-------------------
  o fix to verifier requesting policy records from the wrong
    location
  o the policy is no longer checked if the From domain is a 
    subdomain of any of the successful signing domains

-------------------
1.0.7 July 21, 2005
-------------------
  o added option to honor/ignore body length tags when verifying
    default is to ignore

-------------------
1.0.6 July 14, 2005
-------------------
  o initial release


This library implements DKIM (DomainKeys Identified Mail).  The
internet drafts are available here:

http://www.ietf.org/internet-drafts/draft-allman-dkim-base-01.txt
http://www.ietf.org/internet-drafts/draft-allman-dkim-ssp-01.txt
http://www.ietf.org/internet-drafts/draft-fenton-dkim-threats-01.txt


Build Instructions
------------------

You must have OpenSSL installed and built.

http://www.openssl.org/

For Win32,
  - Edit the make file Makefile.vc and set the OpenSSL include and lib
    paths (OPENSSL_INC and OPENSSL_LIB)
  - Run "nmake /f Makefile.vc"

For Unix,
  - Run "make"


Usage
-------

See libdkimtest.cpp for an example of how to call the library.