verein: URL fix
[gnupg-doc.git] / web / aegypten2 / index.org
1 #+TITLE: GnuPG - Project Ägypten2
2 #+STARTUP: showall
3 #+SETUPFILE: "../share/setup.inc"
4
5 * Project Ägypten2: Improving Free Software Sphinx-Clients
6
7   Ägypten2 is a successor project of Ägypten1, but with its own technical
8   aims, primarily addressing a better GUI and some more functionality such
9   as OCSP. The Ägypten2 project has the same structural and organisational
10   frame as Ägypten1, started December 1st 2003 and finished in
11   November 2004.
12
13   Please read the [[../aegypten/index.org][Ägypten1 Web-Pages]] to learn about the project that
14   initially estabslished the Sphinx (S/MIME) awareness of the MUAs
15   KMail and Mutt.
16
17 ** Aims
18
19    The rough list of aims and their status (as of 13-January-2005) of
20    the Ägypten2 project are:
21
22    - Certificate Manager/Dirmngr
23
24      - GUI for PSE management (done)
25      - GUI for importating centrally created keys (done)
26      - Manual installation of CRLs (done)
27      - Check validity of all certifiactes (done)
28      - Visual distinction of certificate validity and usage (done)
29      - OCSP support (done)
30      - serial signatures based on the MIME structures (done)
31      - GUI for configuring LDAP servers (done)
32
33    - KMail
34
35      - Better support for handling keys with different key usages (done)
36      - GUI for specifying set and sequence of DN elements to show in
37        KMail (done)
38      - Detection of encrypted messages even if not correctly suffixed
39        ".p7m" (done)
40      - Consistent and correct handling of drafts (done)
41
42    - Support of DINSIG Smartcards (DIN V66291-1:2000-04) (done)
43    - Extend Mutt to support S/MIME based on Ägypten crypto-backend
44      (done)
45    - Interoperability with other Sphinx-Applications (established)
46    - KDE GUI for watching GnuPG log (done)
47    - Complete German translation (almost done)
48    - Merge Ägypten developments into main development branches,
49      especially the KDE parts (done)
50    - Incorporate full functionality into Debian (in progress, only
51      GpgSM missing)
52    - Finish work in summer 2004 (well November was not too bad,
53      considering that the official Sphinx Interoperability Test
54      performed by Atos Origin took place in the last week of October).
55
56 ** Module Overview
57
58    #+caption: [module diagram]
59    [[file:module-overview.png]]
60
61
62 ** Users
63
64    Basically Ägypten2 is ready for use. The technology passed
65    interoperability tests with a number of leading other Sphinx
66    products (in fact most of them being proprietary Outlook
67    plugins). Of course, there could still be some remaining bugs.
68
69    If your are interested in the OpenPGP part, there is a HOWTO
70    provided by kde.org: [[http://kmail.kde.org/kmail-pgpmime-howto.html][Using OpenPGP and PGP/MIME with KMail >= 1.7]]
71    Most of the described stuff is also required for S/MIME.
72
73    Since the release of KDE 3.3 (and therewith KMail 1.7), all KDE
74    elements of Ägypten2 are available with the standard KDE 3.3 (or
75    newer) packages.
76
77    However, the various packages of Ägypten2 did not yet made it into
78    the usual GNU/Linux distributions.
79
80    Please report us if you find a distibution where Ägypten2
81    (especially the S/MIME part) works on your distribution out of the
82    box or at least most parts are available as packages.
83
84 *** Debian Sarge
85
86     Ägypten-2 funtionality is fully integrated in Debian 'Sarge' 3.1.
87
88 #+begin_example
89  apt-get install gnupg libgpg-error0 libgcrypt11 libgpgme11
90  apt-get install dirmngr
91  apt-get install pinentry-curses pinentry-gtk pinentry-qt
92  apt-get install gnupg2
93 #+end_example
94
95     In case you want to compiler newer versions than the Sarge ones
96     you might need some developer packages of which some are available
97     as packages:
98
99     apt-get install libgpg-error-dev libgcrypt11-dev libassuan-dev
100     libgpgme11-dev
101
102     KDE >= 3.3 is also available in Sarge:
103
104     apt-get install kmail kleopatra # the minimum you should install
105     apt-get install kaddressbook # to use contact specific crypto
106     preferences apt-get install kontact # to have various PIM
107     components integrated
108
109 ** Developers
110
111 *** Subversion
112
113     First make sure you installed
114
115     -  [[https://www.gnupg.org][GnuPG]] >= 1.2.5
116     -  [[https://www.gnupg.org/software/libgpg-error/][libgpg-error]]
117        >= 1.0.0
118     -  [[https://directory.fsf.org/security/libgcrypt.html][libgcrypt]] >=
119        1.2.0
120     -  [[https://www.gnupg.org/software/gpgme/index.html][GpgME]]
121        >= 1.0.0
122     -  [[http://www.kde.org][KDE]] >= 3.3.0
123
124     The full procedure is (you may apply short-cuts for some modules
125     e.g.  via tar-balls. Note also that after installing libraries you
126     may have to issue ldconfig to have the newly installed libraries
127     be found by subsequent configure routines. Note finally that you
128     should read README.SVN if you find one):
129
130     1. Build libassuan
131
132        #+BEGIN_EXAMPLE
133                svn co svn://cvs.gnupg.org/libassuan/trunk libassuan
134                cd libassuan
135                ./autogen.sh
136                ./configure --prefix=/some/where --enable-maintainer-mode
137                make install
138
139        #+END_EXAMPLE
140
141        Alternatively you may use the latest tarball from
142        [[ftp://ftp.gnupg.org/gcrypt/alpha/libassuan/][ftp.gnupg.org/gcrypt/alpha/libassuan/]] and do the usual
143        =./configure && make install=.
144
145     2. Build libksba
146
147        #+BEGIN_EXAMPLE
148                svn co svn://cvs.gnupg.org/libksba/trunk libksba
149                cd libksba
150                ./autogen.sh
151                ./configure --prefix=/some/where --enable-maintainer-mode
152                make install
153
154        #+END_EXAMPLE
155
156        Alternatively you may use the latest tarball from
157        [[ftp://ftp.gnupg.org/gcrypt/alpha/libksba/][ftp.gnupg.org/gcrypt/alpha/libksba/]]
158        and do the usual =./configure && make install=.
159
160     3. Build GnuPG 1.9 (make sure you build with thread support, or else
161        some operations may hang)
162
163        #+BEGIN_EXAMPLE
164                svn co svn://cvs.gnupg.org/gnupg/trunk gnupg
165                cd gnupg
166                ./autogen.sh
167                ./configure --prefix=/some/where --enable-maintainer-mode
168                make install
169
170        #+END_EXAMPLE
171
172        Alternatively you may use the latest tarball from
173        [[ftp://ftp.gnupg.org/gcrypt/alpha/gnupg/][ftp.gnupg.org/gcrypt/alpha/gnupg/]]
174        (take the latest =gnupg-1.9.x=) and do the usual
175        =./configure && make install=.
176
177     4. Build DirMngr
178
179        #+BEGIN_EXAMPLE
180                svn co svn://cvs.gnupg.org/dirmngr/trunk dirmngr
181                cd dirmngr
182                ./autogen.sh
183                ./configure --prefix=/some/where --enable-maintainer-mode
184                make install
185
186        #+END_EXAMPLE
187
188        Alternatively you may use the latest tarball from
189        [[ftp://ftp.gnupg.org/gcrypt/alpha/dirmngr/][ftp.gnupg.org/gcrypt/alpha/dirmngr/]]
190        and do the usual =./configure && make install=.
191
192     5. Build pinentry module
193
194        #+BEGIN_EXAMPLE
195                svn co svn://cvs.gnupg.org/pinentry/trunk pinentry
196                cd pinentry
197                ./autogen.sh
198                ./configure --prefix=/some/where --enable-maintainer-mode
199                make install
200
201        #+END_EXAMPLE
202
203        Alternatively you may use the latest tarball from
204        [[ftp://ftp.gnupg.org/gcrypt/pinentry/][ftp.gnupg.org/gcrypt/pinentry/]]
205        and do the usual =./configure && make install=.
206
207
208  Page last modified: $Date: 2006-08-01 15:45:27 $
209
210  (C) Intevation, Verbatim copying and distribution of this entire page
211  is permitted in any medium, provided this notice is preserved.
212 #+HTML:<!--disable-copyright-footer-->