Project

General

Profile

Blowfish Encryption Manual » History » Version 9

sjefen6, 05/09/2013 07:31 PM
added information about libqca2-plugin-ossl in debian

1 1 johu
h1. Blowfish Encryption
2 1 johu
3 5 johu
* required version *>=0.7*
4 4 johu
5 2 johu
h2. Introduction
6 1 johu
7 3 johu
Blowfish can be used to encrypt messages between 2 persons in query, messages in channel and the topic. In Quassel all messages will be de-/encrypted on core. So it is *highly recommend* to *[[Client-Core_SSL_support|setup SSL]]* in case of you are not running monolithic client.
8 2 johu
9 2 johu
!http://bugs.quassel-irc.org/attachments/304/core_deencryption.png!
10 2 johu
11 2 johu
h2. Commands
12 2 johu
13 2 johu
a) setting a key for a user or channel 
14 2 johu
15 2 johu
> Usage
16 2 johu
<pre><code>/setkey <nick|channel> <key></code></pre>
17 2 johu
18 2 johu
b) deleting a key for a user or channel
19 2 johu
20 2 johu
> Usage
21 2 johu
<pre><code>/delkey <nick|channel></code></pre>
22 4 johu
23 7 johu
c) show key for a user or channel (since *0.8*)
24 7 johu
25 7 johu
> Usage
26 7 johu
<pre><code>/showkey <nick|channel></code></pre>
27 7 johu
28 8 Anonymous
d) Automatically negotiate a key with the target (DH-1080 key exchange; since *0.9.0*)
29 8 Anonymous
30 8 Anonymous
> Usage
31 8 Anonymous
<pre><code>/keyx <nick|channel></code></pre>
32 8 Anonymous
33 4 johu
h2. Build Instructions
34 4 johu
35 4 johu
Blowfish support for Quassel depends on *"QCA":http://delta.affinix.com/qca/* (Qt Cryptographic Architecture) library. It is needed to compile your core/monolithic client with crypt compile option. 
36 4 johu
37 4 johu
bq. _..._ -DWITH_CRYPT=ON _..._
38 4 johu
39 4 johu
For detailed build instructions have at look "general build instructons":http://bugs.quassel-irc.org/projects/quassel-irc/wiki/#Specific-installation-instructions.
40 6 johu
41 6 johu
h2. Troubleshooting
42 6 johu
43 9 sjefen6
* If Quassel crashes (like #1045) when tries to send a message to a <nick|channel> where a blowfish encryption key has been set with _<code>/setkey <nick|channel> <key></code>_, you have to install *"qca-ossl":http://delta.affinix.com/qca/*.
44 9 sjefen6
* To use blowfish in debian you might need the "libqca2-plugin-ossl" package. "sudo apt-get install libqca2-plugin-ossl"