b2d37156f2001d24c8dec4fecc2b44a4ec547964
[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 *** Issue Tracker
112
113     Roundup [[http://intevation.de/roundup/aegypten/][Ägypten Issue Tracker]]
114
115     (previously we used an [[http://intevation.de/rt/webrt?q_queue=aegypten][RT-based issues tracker for Ägypten]]. Please
116      report new bugs only into the new Roundup-based one.)
117
118 *** Subversion
119
120     First make sure you installed
121
122     -  [[http://www.gnupg.org][GnuPG]] >= 1.2.5
123     -  [[http://www.gnupg.org/related_software/libgpg-error/][libgpg-error]]
124        >= 1.0.0
125     -  [[http://directory.fsf.org/security/libgcrypt.html][libgcrypt]] >=
126        1.2.0
127     -  [[http://www.gnupg.org/(en)/related_software/gpgme/index.html][GpgME]]
128        >= 1.0.0
129     -  [[http://www.kde.org][KDE]] >= 3.3.0
130
131     The full procedure is (you may apply short-cuts for some modules
132     e.g.  via tar-balls. Note also that after installing libraries you
133     may have to issue ldconfig to have the newly installed libraries
134     be found by subsequent configure routines. Note finally that you
135     should read README.SVN if you find one):
136
137     1. Build libassuan
138
139        #+BEGIN_EXAMPLE
140                svn co svn://cvs.gnupg.org/libassuan/trunk libassuan
141                cd libassuan
142                ./autogen.sh
143                ./configure --prefix=/some/where --enable-maintainer-mode
144                make install
145
146        #+END_EXAMPLE
147
148        Alternatively you may use the latest tarball from
149        [[ftp://ftp.gnupg.org/gcrypt/alpha/libassuan/][ftp.gnupg.org/gcrypt/alpha/libassuan/]] and do the usual
150        =./configure && make install=.
151
152     2. Build libksba
153
154        #+BEGIN_EXAMPLE
155                svn co svn://cvs.gnupg.org/libksba/trunk libksba
156                cd libksba
157                ./autogen.sh
158                ./configure --prefix=/some/where --enable-maintainer-mode
159                make install
160
161        #+END_EXAMPLE
162
163        Alternatively you may use the latest tarball from
164        [[ftp://ftp.gnupg.org/gcrypt/alpha/libksba/][ftp.gnupg.org/gcrypt/alpha/libksba/]]
165        and do the usual =./configure && make install=.
166
167     3. Build GnuPG 1.9 (make sure you build with thread support, or else
168        some operations may hang)
169
170        #+BEGIN_EXAMPLE
171                svn co svn://cvs.gnupg.org/gnupg/trunk gnupg
172                cd gnupg
173                ./autogen.sh
174                ./configure --prefix=/some/where --enable-maintainer-mode
175                make install
176
177        #+END_EXAMPLE
178
179        Alternatively you may use the latest tarball from
180        [[ftp://ftp.gnupg.org/gcrypt/alpha/gnupg/][ftp.gnupg.org/gcrypt/alpha/gnupg/]]
181        (take the latest =gnupg-1.9.x=) and do the usual
182        =./configure && make install=.
183
184     4. Build DirMngr
185
186        #+BEGIN_EXAMPLE
187                svn co svn://cvs.gnupg.org/dirmngr/trunk dirmngr
188                cd dirmngr
189                ./autogen.sh
190                ./configure --prefix=/some/where --enable-maintainer-mode
191                make install
192
193        #+END_EXAMPLE
194
195        Alternatively you may use the latest tarball from
196        [[ftp://ftp.gnupg.org/gcrypt/alpha/dirmngr/][ftp.gnupg.org/gcrypt/alpha/dirmngr/]]
197        and do the usual =./configure && make install=.
198
199     5. Build pinentry module
200
201        #+BEGIN_EXAMPLE
202                svn co svn://cvs.gnupg.org/pinentry/trunk pinentry
203                cd pinentry
204                ./autogen.sh
205                ./configure --prefix=/some/where --enable-maintainer-mode
206                make install
207
208        #+END_EXAMPLE
209
210        Alternatively you may use the latest tarball from
211        [[ftp://ftp.gnupg.org/gcrypt/pinentry/][ftp.gnupg.org/gcrypt/pinentry/]]
212        and do the usual =./configure && make install=.
213
214
215  Page last modified: $Date: 2006-08-01 15:45:27 $
216
217  (C) Intevation, Verbatim copying and distribution of this entire page
218  is permitted in any medium, provided this notice is preserved.
219 #+HTML:<!--disable-copyright-footer-->