About this document
This is a quick start guide, geared towards experienced users of the Unix
operating system. More detailed instructions are in the file Start.html.
This is a basic description of some of the files in the kiwi package, and
how to use them.
A cookie will be rejected if the cookie does not decrypt to valid data (a
randomly generated cookie has a 1 in 113 chance of being considered valid
data), or if the time stamp in the decrypted cookie has expired.
If PASSWORD is defined in
Example of using Kiwi:
Files included with Kiwi
Example of using Kiwi
About this document
Files included with Kiwi
tools
, secpass is used to generate a
random key for the encryption, to be placed in the KEY field in config.h
(using cut and paste). This program will only run on an operating system
with /dev/random
support, and with a copy of the perl
interpreter in /usr/bin/perl
. Any modern Linux distribution
will have /dev/random support and perl located at /usr/bin/perl.
.forward
(or
.qmail
and .qmail-default
on qmail systems) that
determines if a message was sent to a valid cookie (or has the correct
password in the email address), and if so, either appends your mailbox
with the message in question, or forwards it to another email address you
have. If the cookie was rejected, then it discards the message and makes
a note in your maillog file.
config.h
, and someone sends
mail with the password in place of the encrypted cookie in the address,
the message will be accepted. This is useful for giving personal friends
an easy to remember email address. Care must be taken that the email
address with the password does not fall in to spammers' hands.
.pinerc
file:
sendmail-path=/home/
your_username/.wrapper -t
Example of using Kiwi
$ cd ../src
[Paste the password generated by secpass (Not the above
example password), and put it in the KEY field when you edit config.h]
$ ../tools/secpass
If it pauses here, please type some random text to replenish the random seed
Random password with 96 bits of entropy: jzsmGA.Mtep7-tDD
[edit the config.h file]
$ pico -w config.h
[you will get a number of compiling messages]
$ make
[The exact text needs to be different on your system]
$ ./cryptday
fmx2v6v
[The exact text needs to be different on your system]
$ ./ipcrypt 127.0.0.1
eqjq2b4
[Use the text you got from cryptday above]
$ ./decode
fmx2v6v
[Your date will be different]
Data type: Long timeout
Message: 905972880, or Wed Sep 16 12:08:00 1998
[Use the text you got from ipcrypt above]
$ ./decode
eqjq2b4
Data type: Truncated IP
Message: 127.0.0.0-16