lib/secure/README_SECURE

   1
   2
   3 Secure OLSR 0.4 implementation notes
   4 (c)Andreas Tonnesen 2004
   5
   6 This document contains information on how to
   7 use the secure OLSR plugin with the UniK olsr daemon.
   8 It does _not_ cover secure OLSR protocol issues.
   9
  10 Lines starting with '# ' indicates shell commands.
  11
  12 NOTES
  13
  14   The plugin interface and olsrd output buffering was
  15   heavily rewritten for the 0.4.8 release. The plugin
  16   should work with this release - but has not been
  17   tested much.
  18
  19 COMPILING
  20
  21   To compile simply do:
  22   # make
  23   This compiles the local MD5 function and the plugin has
  24   no external dependencies.
  25   If you want the plugin to use SHA-1 using the openssl libs
  26   do:
  27   # make USE_OPENSSL=1
  28
  29 INSTALLING
  30
  31   To install:
  32   # make install
  33
  34   This will run ldconfig to update the dynamic linker.
  35   It might take a while.
  36
  37 USAGE
  38
  39   To make olsrd load the secure OLSR plugin add the
  40   following in the olsrd configuration file:
  41
  42 LoadPlugin "olsrd_secure.so.0.5"
  43 {
  44     PlParam     "Keyfile"   "FILENAME"
  45 }
  46
  47   replacing FILENAME with the full path of the file
  48   containing the shared key.
  49
  50   The plugin uses this shared secret key for signature
  51   generation and verification. For nodes to participate
  52   in the OLSR routing domain they need to use the key
  53   used by the other nodes.
  54   The key is 128-bits of size and is read from the
  55   specified file from the config file or by default from:
  56   /etc/olsrd.d/olsrd_secure_key
  57
  58   Copy the key to this file an all nodes. The plugin
  59   will terminate olsrd if this file cannot be found.
  60
  61   Now start olsrd and the let the plugin do its
  62   thing :)
  63
  64 - Andreas