1 48c4bdc1 2019-04-04 martijn .\"	$OpenBSD$
 2 48c4bdc1 2019-04-04 martijn .\"
 3 48c4bdc1 2019-04-04 martijn .\" Copyright (c) 2019 Martijn van Duren <martijn@openbsd.org>
 4 48c4bdc1 2019-04-04 martijn .\"
 5 48c4bdc1 2019-04-04 martijn .\" Permission to use, copy, modify, and distribute this software for any
 6 48c4bdc1 2019-04-04 martijn .\" purpose with or without fee is hereby granted, provided that the above
 7 48c4bdc1 2019-04-04 martijn .\" copyright notice and this permission notice appear in all copies.
 8 48c4bdc1 2019-04-04 martijn .\"
 9 48c4bdc1 2019-04-04 martijn .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10 48c4bdc1 2019-04-04 martijn .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11 48c4bdc1 2019-04-04 martijn .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12 48c4bdc1 2019-04-04 martijn .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13 48c4bdc1 2019-04-04 martijn .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14 48c4bdc1 2019-04-04 martijn .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15 48c4bdc1 2019-04-04 martijn .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16 48c4bdc1 2019-04-04 martijn .\"
17 48c4bdc1 2019-04-04 martijn .Dd $Mdocdate$
18 82063561 2019-04-07 martijn .Dt FILTER-DKIM 8
19 48c4bdc1 2019-04-04 martijn .Os
20 48c4bdc1 2019-04-04 martijn .Sh NAME
21 82063561 2019-04-07 martijn .Nm filter-dkim
22 82063561 2019-04-07 martijn .Nd add dkim signature to messages
23 48c4bdc1 2019-04-04 martijn .Sh SYNOPSIS
24 48c4bdc1 2019-04-04 martijn .Nm
25 82063561 2019-04-07 martijn .Op Fl a Ar algorithm
26 82063561 2019-04-07 martijn .Op Fl c Ar canonicalization
27 82063561 2019-04-07 martijn .Op Fl h Ar headers
28 e7076cef 2019-05-02 martijn .Op Fl t
29 e974922c 2019-05-02 martijn .Op Fl x Ar seconds
30 c826412d 2019-05-02 martijn .Op Fl z
31 c826412d 2019-05-02 martijn .Op Fl Z
32 82063561 2019-04-07 martijn .Fl d Ar domain
33 82063561 2019-04-07 martijn .Fl k Ar file
34 82063561 2019-04-07 martijn .Fl s Ar selector
35 48c4bdc1 2019-04-04 martijn .Sh DESCRIPTION
36 48c4bdc1 2019-04-04 martijn .Nm
37 82063561 2019-04-07 martijn adds a dkim signature to the message.
38 82063561 2019-04-07 martijn The following flags are supported:
39 82063561 2019-04-07 martijn .Bl -tag -width Ds
40 82063561 2019-04-07 martijn .It Fl a
41 82063561 2019-04-07 martijn The algorithm to use.
42 82063561 2019-04-07 martijn This implementation only supports rsa cryptography.
43 dba93509 2019-04-07 martijn Only sha256 should be used for hashing, since other algorithms are most likely
44 dba93509 2019-04-07 martijn not supported by verifiers.
45 82063561 2019-04-07 martijn Defaults to
46 82063561 2019-04-07 martijn .Ar rsa-sha256 .
47 82063561 2019-04-07 martijn .It Fl c
48 82063561 2019-04-07 martijn The canonicalization algorithm used to sign the messge.
49 82063561 2019-04-07 martijn Defaults to
50 82063561 2019-04-07 martijn .Ar simple/simple .
51 82063561 2019-04-07 martijn .It Fl d
52 82063561 2019-04-07 martijn The domain where the public key can be found.
53 82063561 2019-04-07 martijn .It Fl h
54 82063561 2019-04-07 martijn The email headers which are included in the mail signature.
55 82063561 2019-04-07 martijn Per RFC this option requires at least the from header to be included.
56 82063561 2019-04-07 martijn The headers are specified by separating them with a colon.
57 82063561 2019-04-07 martijn The default is
58 e974922c 2019-05-02 martijn from:reply-to:subject:date:to:cc:resent-date:resent-from:resent-to:resent-cc:in-reply-to:references:list-id:list-help:list-unsubscribe:list-subscribe:list-post:list-owner:list-archive .
59 82063561 2019-04-07 martijn .It Fl k
60 82063561 2019-04-07 martijn .Ar file
61 82063561 2019-04-07 martijn should point to a file containing the RSA private key to sign the messages.
62 82063561 2019-04-07 martijn .It Fl s
63 82063561 2019-04-07 martijn The selector within the _domainkey subdomain of
64 82063561 2019-04-07 martijn .Ar domain
65 82063561 2019-04-07 martijn where the public key can be found.
66 e7076cef 2019-05-02 martijn .It Fl t
67 e7076cef 2019-05-02 martijn Add the time of signing to the dkim header.
68 e974922c 2019-05-02 martijn .It Fl x
69 e974922c 2019-05-02 martijn Add the amount of
70 e974922c 2019-05-02 martijn .Ar seconds
71 e974922c 2019-05-02 martijn the signature is valid to the dkim header.
72 c826412d 2019-05-02 martijn .It Fl z
73 c826412d 2019-05-02 martijn Add the mail headers used in the dkim signature to the dkim header.
74 c826412d 2019-05-02 martijn Useful for debugging purposes.
75 c826412d 2019-05-02 martijn .It Fl Z
76 c826412d 2019-05-02 martijn Add all the mail headers to the dkim header.
77 c826412d 2019-05-02 martijn Useful for debugging purposes.
78 82063561 2019-04-07 martijn .El
79 48c4bdc1 2019-04-04 martijn .Sh SEE ALSO
80 48c4bdc1 2019-04-04 martijn .Xr smtpd 8