Jason Kania created JAMES-3664:
----------------------------------
Summary: Documentation Limitations Regarding DKIM Setup
Key: JAMES-3664
URL: https://issues.apache.org/jira/browse/JAMES-3664
Project: James Server
Issue Type: Bug
Components: Documentation
Affects Versions: 3.6.0
Reporter: Jason Kania
On page [https://james.apache.org/howTo/dkim.html,] the mailet configuration
for DKIM has bad XML in it. It is documented as:
{code:java}
<processors>
<processor state="relay" enableJmx="true">
<mailet match="All" class="org.apache.james.jdkim.mailets.DKIMSign">
<signatureTemplate>v=1; s=james3; d=domain.example.com ; h=from :
reply-to : subject : date : to : cc : resent-date : resent-from : resent-sender
: resent-to : resent-cc : in-reply-to : references : list-id : list-help :
list-unsubscribe : list-subscribe : list-post : list-owner : list-archive;
a=rsa-sha256; bh=; b=;</signatureTemplate>
<privateKey>
-----BEGIN RSA PRIVATE KEY-----
[Your Private Key]
-----END RSA PRIVATE KEY-----
</privateKey>
<mailet>
</processor>
</processor>
{code}
but should be
{code:java}
<processors>
<processor state="relay" enableJmx="true">
<mailet match="All" class="org.apache.james.jdkim.mailets.DKIMSign">
<signatureTemplate>v=1; s=james3; d=domain.example.com ; h=from :
reply-to : subject : date : to : cc : resent-date : resent-from : resent-sender
: resent-to : resent-cc : in-reply-to : references : list-id : list-help :
list-unsubscribe : list-subscribe : list-post : list-owner : list-archive;
a=rsa-sha256; bh=; b=;</signatureTemplate>
<privateKey>
-----BEGIN RSA PRIVATE KEY-----
[Your Private Key]
-----END RSA PRIVATE KEY-----
</privateKey>
</mailet>
</processor>
</processors>
{code}
with the mailet and processors end tags fixed.
It would also help if the james3._domainkey entry in the DNS record and the
s=james3 were replaced with appropriate variable identifiers to better show the
linkages between the two instead of relying only on the statement in the text
above the example.
Lastly, the comments provided on this page
[https://robertmunn.com/blog/configuring-dkim-and-spf-for-apache-james/]
regarding the addition of TWO mailets and their position in the
mailetcontainer.xml file should be added to the how to page mentioned at the
top.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
