OTR

Version 20 (Adrian Georgescu, 09/13/2013 02:23 am)

1 3 Adrian Georgescu
h1. Blink OTR implementation
2 1 Adrian Georgescu
3 12 Adrian Georgescu
September 12th, 2013
4 12 Adrian Georgescu
5 16 Adrian Georgescu
"Blink SIP client for SIP2SIP edition":http://download.sip2sip.info/ is a multimedia SIP client that supports chat sessions using MSRP protocol (RFC4975 http://tools.ietf.org/html/rfc4975).  The client is designed to work with SIP2SIP service that implements MSRP relay protocol for NAT traversal of SIP sessions with MSRP media like Instant Messaging chat sessions. 
6 1 Adrian Georgescu
7 16 Adrian Georgescu
8 16 Adrian Georgescu
Over the MSRP media chat session, Blink SIP client for SIP2SIP edition implements the OTR protocol. OTR functionality will be gradually deployed to other versions and variations of Blink client. 
9 16 Adrian Georgescu
10 1 Adrian Georgescu
11 3 Adrian Georgescu
h2. OTR Protocol
12 3 Adrian Georgescu
13 9 Adrian Georgescu
"Off-the-Record (OTR) Messaging":http://www.cypherpunks.ca/otr/ allows two parties to have private conversations over instant messaging by providing:
14 3 Adrian Georgescu
15 1 Adrian Georgescu
h3. Encryption
16 1 Adrian Georgescu
17 1 Adrian Georgescu
No one else can read your instant messages.
18 1 Adrian Georgescu
19 1 Adrian Georgescu
h3. Authentication
20 3 Adrian Georgescu
21 1 Adrian Georgescu
You are assured the correspondent is who you think it is.
22 1 Adrian Georgescu
23 1 Adrian Georgescu
h3. Deniability
24 1 Adrian Georgescu
25 1 Adrian Georgescu
The messages you send do not have digital signatures that are checkable by a third party. Anyone can forge messages after a conversation to make them look like they came from you. However, during a conversation, your correspondent is assured the messages he sees are authentic and unmodified.
26 1 Adrian Georgescu
27 1 Adrian Georgescu
h3. Perfect forward secrecy
28 1 Adrian Georgescu
29 1 Adrian Georgescu
If you lose control of your private keys, no previous conversation is compromised.
30 3 Adrian Georgescu
31 3 Adrian Georgescu
h2. Implementation
32 1 Adrian Georgescu
33 20 Adrian Georgescu
The OTR implementation is backwards compatible with remote MSRP clients that do not support it (in this case the encryption features are not available). OTR is not employed when the remote party is a multi-party conference server advertised by is-focus Contact header parameter. 
34 20 Adrian Georgescu
35 20 Adrian Georgescu
The code is written in Python and is based on the "python-otr package":https://pypi.python.org/pypi/python-potr/1.0.0b5
36 7 Adrian Georgescu
37 4 Adrian Georgescu
h3. User input
38 4 Adrian Georgescu
39 17 Adrian Georgescu
 * Local and remote fingerprints are displayed in the Encryption menu
40 1 Adrian Georgescu
 * Chat window has the Encryption toolbar icon, encryption features for each session can be controlled by clicking on this toolbar item, a contextual menu appears
41 17 Adrian Georgescu
 * Verification of remote identity can be performed using SMP protocol (in a separate window) or manually in an audio session
42 7 Adrian Georgescu
 * Each Contact can have encrypted related attributes saved (always use OTR, verification status and learned fingerprint)
43 10 Adrian Georgescu
 * Logging of Chat conversations can be toggled off (global setting)
44 13 Adrian Georgescu
 * History saves for each message the encryption status (encrypted/non-encrypted and fingerprint un/verified). This is rendered using a lock with a corespondent collor
45 1 Adrian Georgescu
46 1 Adrian Georgescu
h3. Notifications
47 4 Adrian Georgescu
48 17 Adrian Georgescu
When the remote party has proposed OTR for the current session, the colour of the toolbar button changes to either orange (unverified fingerprint) or green (verified fingerprint). When the remote party (identified by its SIP URI) has changed its encryption fingerprint, several visual and audible clues appear:
49 7 Adrian Georgescu
50 17 Adrian Georgescu
 * Encryption lock turns red
51 4 Adrian Georgescu
 * Chat window system message is displayed
52 4 Adrian Georgescu
 * Voice synthesiser speaks
53 1 Adrian Georgescu
 * System notification (OSX >=10.8) 
54 1 Adrian Georgescu
 * Growl notification
55 8 Adrian Georgescu
56 11 Adrian Georgescu
h3. Key storage
57 11 Adrian Georgescu
58 11 Adrian Georgescu
The private key is stored in the program configuration folder under a folder called *chat*. The database with the remote fingerprints is stored in a file under the same folder:
59 11 Adrian Georgescu
60 11 Adrian Georgescu
 * private_key.dsa
61 11 Adrian Georgescu
 * trusted_peers
62 11 Adrian Georgescu
63 8 Adrian Georgescu
h3. Interoperability
64 1 Adrian Georgescu
65 19 Adrian Georgescu
We are not aware of any other SIP/MSRP client implementation that supports OTR encryption today. Blink OTR implementation however interoperates well with XMPP clients when using SIP2SIP service built-in SIP/XMPP gateway. We were able to have bidirectional OTR encrypted chat sessions between Blink (using SIP/MSRP) and "Jitsi":http://jit.si (using XMPP) through "SylkServer":http://sylkserver.org.