You are viewing a plain text version of this content. The canonical link for it is here.
Posted to server-user@james.apache.org by Jerry M <te...@malcolms.com> on 2010/08/14 19:27:41 UTC
jDKIM Download?
Is there a way to just download the jDKIM package with a jar file,
documentation, etc? Or do I have to set up a build environment and
download the source from the trunk, etc? I looked on the jDKIM pages on
the web site. There is minimal information that I can find, and even
though the sidebar links to the downloads page, I don't see in jDKIM
downloads. Is there any documentation on how to install, configure, set
up keys, etc. to make this work?
Thx
Jerry
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: jDKIM Download?
Posted by Stefano Bagnara <ap...@bago.org>.
2010/8/14 Jerry M <te...@malcolms.com>:
> Is there a way to just download the jDKIM package with a jar file,
> documentation, etc? Or do I have to set up a build environment and download
> the source from the trunk, etc? I looked on the jDKIM pages on the web
> site. There is minimal information that I can find, and even though the
> sidebar links to the downloads page, I don't see in jDKIM downloads. Is
> there any documentation on how to install, configure, set up keys, etc. to
> make this work?
There are some comments in the javadocs for the Mailets (if you are
using James Server), otherwise you could look at the DKIMSign code to
understand how to use the jdkim library.
You can find nighly builds here:
http://hudson.zones.apache.org/hudson/view/James/job/jdkim-trunk/
and maybe you also need the nightly for mime4j (depending on how you
use the library):
http://hudson.zones.apache.org/hudson/view/James/job/mime4j-trunk/
Stefano
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: jDKIM Download?
Posted by Jerry M <te...@malcolms.com>.
Stephano,
Thanks for the response. I looked at the javadoc for the mailets.
Still pretty thin on telling me what I need to do.
On the hudson site, it lists 2 zip files and 7 jar files (including a
javadoc "jar"???). Some of the jar files are contained in the bin zip,
but not all (??). I know I don't need the src zip. But how many of the
other ones do I need to get? And where do I put them in my JAMES
installation (what path)? I know I could guess at all of this. But
that's just going to waste time.
Then on the mime4j site, there are all kinds of downloads, assembly,
DOM, Core, etc. How many of them do I need? (Sorry... I'm a seasoned
java programmer, but as far as JAMES goes, I'm just a user. I just want
to get the jar files I need, configure the mailets in my config.xml and
be up and running. I'm not up to date on the specific terminology for
JAMES builds. And I just don't have the bandwidth to jump in blind with
trial and error.
I see the example config block for signing. But there are two other
mailets. You said in a response earlier today that the 7bit thing had
to be in the chain. But in what order and what is the syntax? And what
about the 3rd mailet? Where does it go, and what is the syntax?
It appears that this is designed for signing mail. Is there a way to
verify DKIM for received mail?
As far as keys, I know my DNS server has a utility to generate
private/public key pairs. Is that good enough? (Any key pair?) Or are
there restrictions on the types of keys (and if so, where do I go to
generate them?)
And the last question deals specifically with DKIM specs. But I don't
know where to find info on DKIM... specific question... I believe I need
to put my public key in my DNS record, correct? But what is the precise
syntax? Or where can I go to find documentation on that?
Sorry for all the questions... But I just need the complete set of steps
to get this thing running.
Thanks.
Jerry
On 8/14/2010 12:43 PM, Stefano Bagnara wrote:
> 2010/8/14 Jerry M<te...@malcolms.com>:
>> Is there a way to just download the jDKIM package with a jar file,
>> documentation, etc? Or do I have to set up a build environment and download
>> the source from the trunk, etc? I looked on the jDKIM pages on the web
>> site. There is minimal information that I can find, and even though the
>> sidebar links to the downloads page, I don't see in jDKIM downloads. Is
>> there any documentation on how to install, configure, set up keys, etc. to
>> make this work?
> There are some comments in the javadocs for the Mailets (if you are
> using James Server), otherwise you could look at the DKIMSign code to
> understand how to use the jdkim library.
>
> You can find nighly builds here:
> http://hudson.zones.apache.org/hudson/view/James/job/jdkim-trunk/
> and maybe you also need the nightly for mime4j (depending on how you
> use the library):
> http://hudson.zones.apache.org/hudson/view/James/job/mime4j-trunk/
>
> Stefano
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: jDKIM Download?
Posted by Stefano Bagnara <ap...@bago.org>.
> 1) Where do I put all of the jar files?
jamesfolder/apps/james/SAR-INF/lib
> 2) How do I configure James to tell it how to find DKIMSign and the other
> classes that are in the org.apache.james.jdkim packages?
in your config.xml
either you use the fully qualified name for mailet:
org.apache.james.jdkim.mailets.DKIMSign or you add
"org.apache.james.jdkim.mailets" to the "mailetpackages" config.
> 3) What is a complete config.xml block for all three of the mailets for both
> signing and verifying?
jdkim doesn't include a mailet for verification yet. You can see the
DKIMSign configuration sample in the javadoc. You have to understand
how DKIM works in order to put appropriate content in the
"signatureTemplate". It's called "template" because you have to put
there every dkim TAG and leave empty "b" and "bh" tags that will be
filled by the mailet while signing.
Just search the internet for some guide about DKIM (how to generate
key pairs, how to decide dkim flags, and so on).
> I really want to use this package. But I am lost and can find no
> documentation to help. Am I overlooking something obvious here?
I'm on vacation but I'll try to help.. just try with the hints above
and let me know...
Stefano
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: jDKIM Download?
Posted by Jerry M <te...@malcolms.com>.
Thank you so much. Sorry to interrupt your vacation. I made the
changes and got james to load. But if you don't mind, just a couple of
more questions. Basically, the port25.com tester is failing DKIM.
I understand DKIM and private key / public key digital signing at least
in concept. But not down to the details of the individual parameters
and values. But I'm not sure how the algorithms match up. In the
sample you have a=rsa-sha256. I found port25.com that will generate key
pairs. No options on algorithms on the generator. But as part of the
public key dns record it has k=rsa. Do I need to change one or the
other of these to match up? If so, is it acceptable to change a= on the
mailet template to "rsa"? Or do I leave the a= as is on the signer tag
and change the k= in the DNS record? Any other obvious things that might
cause signature verification to fail?
I added the ConvertTo7Bit mailet ahead of DKIMSign. Couldn't find any
info on parameters. So I assume no parms (??)
Finally, what about HeaderSkippingOutputStream mailet? No references to
that. Is that internal? Or do I need to add it to the processor chain
in config.xml?
Thanks again.
Jerry
On 8/15/2010 4:50 PM, Stefano Bagnara wrote:
>> 1) Where do I put all of the jar files?
> jamesfolder/apps/james/SAR-INF/lib
>
>> 2) How do I configure James to tell it how to find DKIMSign and the other
>> classes that are in the org.apache.james.jdkim packages?
> in your config.xml
>
> either you use the fully qualified name for mailet:
> org.apache.james.jdkim.mailets.DKIMSign or you add
> "org.apache.james.jdkim.mailets" to the "mailetpackages" config.
>
>> 3) What is a complete config.xml block for all three of the mailets for both
>> signing and verifying?
> jdkim doesn't include a mailet for verification yet. You can see the
> DKIMSign configuration sample in the javadoc. You have to understand
> how DKIM works in order to put appropriate content in the
> "signatureTemplate". It's called "template" because you have to put
> there every dkim TAG and leave empty "b" and "bh" tags that will be
> filled by the mailet while signing.
>
> Just search the internet for some guide about DKIM (how to generate
> key pairs, how to decide dkim flags, and so on).
>
>> I really want to use this package. But I am lost and can find no
>> documentation to help. Am I overlooking something obvious here?
> I'm on vacation but I'll try to help.. just try with the hints above
> and let me know...
>
> Stefano
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org
Re: jDKIM Download?
Posted by Jerry M <te...@malcolms.com>.
I'm very confused. Since I can't seem to find any documentation other
than a mailet tag sample in one of the javadocs, I'm completely guessing
at what I need to do to get jDKIM installed and running
So I downloaded all the jars and zips as Stephano referenced. I merged
all the dups into one subdirectory. For lack of knowledge of anywhere
to put them, I unloaded them all to SAR-INF\lib. I copied the mailet
tag and still have no clue what all the parameters mean and what I need
to change to make them real for my installation. But I started up james
and it immediately died saying it couldn't find DKIMSign. The error
message listed several paths that it looked in (e.g
org.apache.james.mailet., etc.) But it didn't say it was looking in
org.apache.james.jdkim.mailets, which is where the class lives. But I
don't know how James would have known to look for it by that name.
Where was I supposed to tell it that?
I'm not a dummy. I teach java. But I feel like I'm having to be a
hacker and reverse engineer this and ultimately just guess at how to
install it. Basically, I don't feel like a single sample mailet tag in
one javadoc file is anywhere near adequate to instruct me as to how to
correctly install, configure and get this package up and running.
1) Where do I put all of the jar files?
2) How do I configure James to tell it how to find DKIMSign and the
other classes that are in the org.apache.james.jdkim packages?
3) What is a complete config.xml block for all three of the mailets for
both signing and verifying?
I really want to use this package. But I am lost and can find no
documentation to help. Am I overlooking something obvious here?
BTW... I'm running james 2.3.1
Thanks.
Jerry
On 8/14/2010 1:18 PM, Jerry M wrote:
> Stephano,
>
> Thanks for the response. I looked at the javadoc for the mailets.
> Still pretty thin on telling me what I need to do.
>
> On the hudson site, it lists 2 zip files and 7 jar files (including a
> javadoc "jar"???). Some of the jar files are contained in the bin
> zip, but not all (??). I know I don't need the src zip. But how many
> of the other ones do I need to get? And where do I put them in my
> JAMES installation (what path)? I know I could guess at all of this.
> But that's just going to waste time.
>
> Then on the mime4j site, there are all kinds of downloads, assembly,
> DOM, Core, etc. How many of them do I need? (Sorry... I'm a seasoned
> java programmer, but as far as JAMES goes, I'm just a user. I just
> want to get the jar files I need, configure the mailets in my
> config.xml and be up and running. I'm not up to date on the specific
> terminology for JAMES builds. And I just don't have the bandwidth to
> jump in blind with trial and error.
>
> I see the example config block for signing. But there are two other
> mailets. You said in a response earlier today that the 7bit thing had
> to be in the chain. But in what order and what is the syntax? And
> what about the 3rd mailet? Where does it go, and what is the syntax?
>
> It appears that this is designed for signing mail. Is there a way to
> verify DKIM for received mail?
>
> As far as keys, I know my DNS server has a utility to generate
> private/public key pairs. Is that good enough? (Any key pair?) Or
> are there restrictions on the types of keys (and if so, where do I go
> to generate them?)
>
> And the last question deals specifically with DKIM specs. But I don't
> know where to find info on DKIM... specific question... I believe I
> need to put my public key in my DNS record, correct? But what is the
> precise syntax? Or where can I go to find documentation on that?
>
> Sorry for all the questions... But I just need the complete set of
> steps to get this thing running.
>
> Thanks.
>
> Jerry
>
>
> On 8/14/2010 12:43 PM, Stefano Bagnara wrote:
>> 2010/8/14 Jerry M<te...@malcolms.com>:
>>> Is there a way to just download the jDKIM package with a jar file,
>>> documentation, etc? Or do I have to set up a build environment and
>>> download
>>> the source from the trunk, etc? I looked on the jDKIM pages on the web
>>> site. There is minimal information that I can find, and even though
>>> the
>>> sidebar links to the downloads page, I don't see in jDKIM
>>> downloads. Is
>>> there any documentation on how to install, configure, set up keys,
>>> etc. to
>>> make this work?
>> There are some comments in the javadocs for the Mailets (if you are
>> using James Server), otherwise you could look at the DKIMSign code to
>> understand how to use the jdkim library.
>>
>> You can find nighly builds here:
>> http://hudson.zones.apache.org/hudson/view/James/job/jdkim-trunk/
>> and maybe you also need the nightly for mime4j (depending on how you
>> use the library):
>> http://hudson.zones.apache.org/hudson/view/James/job/mime4j-trunk/
>>
>> Stefano
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
>> For additional commands, e-mail: server-user-help@james.apache.org
>>
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
> For additional commands, e-mail: server-user-help@james.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-user-unsubscribe@james.apache.org
For additional commands, e-mail: server-user-help@james.apache.org