utf-8 is already converted by ja_JP extra functions.
[squirrelmail.git] / plugins / squirrelspell / doc / CRYPTO
CommitLineData
849bdf42 1CRYPTOGRAPHY SUPPORT IN SQUIRRELSPELL
2--------------------------------------
3
4Starting with version v0.3 SquirrelSpell is capable of working with encrypted
5user dictionaries. However, this option is only available when PHP
6is compiled with support for MCRYPT. This is relatively easy -- to enable
7MCRYPT support, follow instructions at:
8
9http://www.php.net/manual/en/ref.mcrypt.php
10
11NOTE: You will need libmcrypt version 2.4.x or above for SquirrelSpell
12to work.
13
14HOW IT'S DONE
15--------------
16SquirrelSpell encrypts the dictionary with the user's mailbox password,
17thus making the encryption/decryption process transparent to the user.
18The algorythm used for encryption is Blowfish, but you may manually override
19it in the code if you so wish.
20
21The only shortcoming this approach has -- when mailbox password is changed,
22SquirrelSpell asks the user to enter the old password in order to re-encrypt
23the file with the new key. If the user doesn't remember the password, then
24the file is lost, unless you want to brute-force it open.
25
26The encryption is off by default and users are warned about remembering
27their passwords before they enable encryption of their personal dictionary.
28
29I haven't tested the overhead. If anyone has any benchmarks -- you are
30welcome to share them.