Generate OpenSSH compatible moduli with IKE DH groups
[ach-master.git] / tools / dhparams / README
1 Tools to convert the RFC-defined IKE DH groups into OpenSSL and OpenSSH
2 compatible PEM and moduli files that we can distribute.
3
4 The files in this directory have been generated (as described below) from the
5 RFCs.  The PEM files have been compared with the ones in Exim's
6 "std-crypto.c".  The OpenSSH moduli files have been checked using `ssh-keygen`
7 with the `-T` option.
8
9 Prerequisite: gen_pkcs3 from the Exim sources, which we don't include
10 here due to duplication and licensing issues (ACH is under CC, Exim
11 under GPLv2).
12
13 Limitations: since gen_pkcs3 only supports MODP DH parameters, we
14 don't process the ECP variation.
15
16 Sources: RFC3526 (Groups 14-18)
17
18 Works as follows:
19
20 - produce an input file for each group named <group>.txt by copying
21   the relevant sections from the RFCs:
22
23 --- cut ---
24       FFFFFFFF FFFFFFFF C90FDAA2 2168C234 C4C6628B 80DC1CD1
25       29024E08 8A67CC74 020BBEA6 3B139B22 514A0879 8E3404DD
26       EF9519B3 CD3A431B 302B0A6D F25F1437 4FE1356D 6D51C245
27       E485B576 625E7EC6 F44C42E9 A637ED6B 0BFF5CB6 F406B7ED
28       EE386BFB 5A899FA5 AE9F2411 7C4B1FE6 49286651 ECE45B3D
29       C2007CB8 A163BF05 98DA4836 1C55D39A 69163FA8 FD24CF5F
30       83655D23 DCA3AD96 1C62F356 208552BB 9ED52907 7096966D
31       670C354E 4ABC9804 F1746C08 CA18217C 32905E46 2E36CE3B
32       E39E772C 180E8603 9B2783A2 EC07A28F B5C55DF0 6F4C52C9
33       DE2BCBF6 95581718 3995497C EA956AE5 15D22618 98FA0510
34       15728E5A 8AACAA68 FFFFFFFF FFFFFFFF
35
36    The generator is: 2.
37 --- cut ---
38
39 - run "make" (and make sure gen_pkcs3 is in $PATH)
40
41 - collect <group>.pem files, moduli.openssh file