You are viewing a plain text version of this content. The canonical link for it is here.
Posted to server-dev@james.apache.org by "Jason Kania (Jira)" <se...@james.apache.org> on 2021/10/20 17:56:00 UTC

[jira] [Created] (JAMES-3664) Documentation Limitations Regarding DKIM Setup

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: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org