README

   1 onak 0.3.0
   2 Copyright 2003-2004 Project Purple. Written by Jonathan McDowell
   3 http://www.earth.li/projectpurple/progs/onak.html
   4
   5
   6 Introduction:
   7
   8 onak is an OpenPGP compatible keyserver. It's primary purpose is the
   9 storage and retrieval of OpenPGP keys but it also has features that make
  10 use of the stored keys for various other purposes. The most useful of
  11 these is probably the pathfinder. This takes two keys, a & b, and
  12 attempts to find a path of trust from a to b in the key database. I
  13 started work on it because at the time there was no DFSG compliant
  14 server that supported multiple subkeys and could act as a drop in
  15 replacement for pksd, which I was running (and still am).
  16
  17
  18 Installation:
  19
  20 onak has been mainly developed under Linux with a bit of work on FreeBSD
  21 at times also. It should run on all architectures, but has only been
  22 tested on i386 and PowerPC so far.
  23
  24 Typing "./configure && make" should produce a version of onak with
  25 support for the DB4 backend. If you want to choose a different backend
  26 (see below for a discussion about the options) you'll need to pass the
  27 appropriate option to ./configure.
  28
  29 Once make has completed you'll end up with various binaries:
  30
  31 * onak
  32   This is the main program. It's intended to be run from the command
  33   line and allows the addition, deletion and searching of keys in the
  34   database.
  35
  36 * onak-mail.pl
  37   The mail processor. Takes incoming mail (usually to
  38   pgp-public-keys@host) and calls onak to do the necessary work.
  39   Currently only supports INCREMENTAL mails for syncing with other
  40   keyservers.
  41
  42 * add, lookup & gpgwww
  43   The CGI programs. add & lookup are common to all PGP keyservers while
  44   gpgwww is the pathfinder component of onak. To get a keyserver that
  45   clients such as GPG can sync with you'll need to put these in a /pks
  46   directory on a web server running on port 11371. There's an example
  47   mathopd.conf file provided that I used for testing, but I'm now using
  48   Apache for the public test rig as it's already present on the host
  49   running it.
  50
  51
  52 Config:
  53
  54 I've finally added config file support. onak.conf is an example config;
  55 the main thing to change is the db_dir to whereever you want to put your
  56 database files. You can change CONFIGFILE in onak-conf.h to specify
  57 where onak should look for this file. By default it's
  58 "/home/noodles/projects/onak/onak.conf" as this suits my development. No
  59 doubt it'll become a compile option at some point.
  60
  61
  62 Backends:
  63
  64 Currently there is support for 4 different database backends:
  65
  66 * file
  67   The original backend. Very simple and ideal for testing. Stores each
  68   key as a separate file. Doesn't support searching based on key text.
  69
  70 * pg (PostgreSQL)
  71   Once the preferred backend. Use onak.sql to create the tables
  72   necessary to run with this. Unfortunately although suitable for the
  73   keyserver side it was found to be too slow for running the pathfinder
  74   with a large number of keys. This may well be due to my use of it - if
  75   you can help speed it up info would be appreciated.
  76
  77 * db2 (Berkeley libdb2)
  78   Only added to provide the ability to run the pathfinder with a key
  79   database produced by pksd. Currently only supports pulling keys out by
  80   keyid - no key updating or searching by key test. Found to be
  81   tempramental and prone to deadlock in the db2 library.
  82
  83 * db4 (Berkeley libdb4)
  84   The currently preferred backend. Supports the full range of functions
  85   like the pg backend but is considerably faster. Also easier to setup
  86   assuming you have libdb4 installed; there's no need to have an SQL
  87   database running and configured.
  88
  89 * fs (file backend)
  90   A fuller featured file based backend. Doesn't need any external
  91   libraries and supports the full range of operations (such as text and
  92   subkey searching). Needs a good filesystem to get good performance
  93   though as it creates many, many files and links.
  94
  95
  96 Other keyservers:
  97
  98 I'm aware of the following other keyservers. If you know of any more
  99 please let me know and I'll add them.
 100
 101 * pks
 102   http://sf.net/projects/pks/
 103   The prodominant keyserver I believe; certainly what I run on
 104   wwwkeys.uk.pgp.net. Recently development restarted on this (when I
 105   started writing onak it had been dormant for some time) so it should
 106   hopefully get its problems sorted out soon. The main issue with pks is
 107   that it lacks support for keys with multiple subkeys bound to them and
 108   unfortunately mangles them.
 109
 110 * CryptNET Keyserver
 111   http://www.cryptnet.net/fsp/cks/
 112   A GPLed server with support for multiple subkeys, but unfortunately
 113   when I looked at it there was no support for syncing via email which
 114   means it can't replace a pks server to act as part of pgp.net.
 115
 116 * OpenPKSD
 117   http://openpksd.org/
 118   Don't really know a lot about this. Primarily Japanese development
 119   AFAICT.
 120
 121 * SKS
 122   http://sks.sourceforge.net/
 123   A reasonably new keyserver concentrating more on the whole issue of
 124   syncronization between keyservers.
 125
 126
 127 Contacting the author:
 128
 129 I can be reached via email as noodles@earth.li. I'm usually on IRC on
 130 OFTC (irc.oftc.net) as Noodles.
 131
 132 All constructive criticism, bugs reports, patches and ideas are welcome.
 133
 134
 135 License:
 136
 137 onak is distributed under the GNU Public License, a copy of which should
 138 have been provided with this archive as LICENSE.