1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
.. _hacking:
Hacking on Bitmask Mail
========================
Some hints oriented to `leap.mail` hackers. These notes are mostly related to
the imap server, although they probably will be useful for other pieces too.
Profiling
----------
If using ``twistd`` to launch the server, you can use twisted profiling
capabities::
LEAP_MAIL_CONFIG=~/.leapmailrc twistd --profile=/tmp/mail-profiling -n -y imap-server.tac
``--profiler`` option allows you to select different profilers (default is
"hotshot").
You can also do profiling when using the ``bitmask`` client. Enable the
``LEAP_PROFILE_IMAPCMD`` environment flag to get profiling of certain IMAP
commands::
LEAP_PROFILE_IMAPCMD=1 bitmask --debug
Mutt config
------------
You cannot live without mutt? You're lucky! Use the following minimal config
with the imap service::
set folder="imap://user@provider@localhost:1984"
set spoolfile="imap://user@provider@localhost:1984/INBOX"
set ssl_starttls = no
set ssl_force_tls = no
set imap_pass=MAHSIKRET
Debugging IMAP
------------------------------
After IMAP service is running, you can telnet into your local IMAP server and read your mail like a real programmer™::
% telnet localhost 1984
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
* OK [CAPABILITY IMAP4rev1 LITERAL+ IDLE NAMESPACE] Twisted IMAP4rev1 Ready
tag LOGIN me@myprovider.net mahsikret
tag OK LOGIN succeeded
tag SELECT Inbox
* 2 EXISTS
* 1 RECENT
* FLAGS (\Seen \Answered \Flagged \Deleted \Draft \Recent List)
* OK [UIDVALIDITY 1410453885932] UIDs valid
tag OK [READ-WRITE] SELECT successful
^]
telnet> Connection closed.
Although you probably prefer to use ``offlineimap`` for tests::
offlineimap -c LEAPofflineimapRC-tests
Use ``ngrep`` to obtain live logs of the commands and responses::
sudo ngrep -d lo -W byline port 1984
Thunderbird
---------------------------
To get verbose output from thunderbird/icedove, set the following environment
variable::
NSPR_LOG_MODULES="imap:5" icedove
Minimal offlineimap configuration
---------------------------------
You can use this as a sample offlineimap config file::
[general]
accounts = leap-local
[Account leap-local]
localrepository = LocalLeap
remoterepository = RemoteLeap
[Repository LocalLeap]
type = Maildir
localfolders = ~/LEAPMail/Mail
[Repository RemoteLeap]
type = IMAP
ssl = no
remotehost = localhost
remoteport = 1984
remoteuser = user
remotepass = pass
Testing utilities
-----------------
There are a bunch of utilities to test IMAP delivery in ``imap/tests`` folder.
If looking for a quick way of inspecting mailboxes, have a look at ``getmail``::
./getmail me@testprovider.net mahsikret
1. Drafts
2. INBOX
3. Trash
Which mailbox? [1] 2
1 Subject: this is the time of the revolution
2 Subject: ignore me
Which message? [1] (Q quits) 1
1 X-Leap-Provenance: Thu, 11 Sep 2014 16:52:11 -0000; pubkey="C1F8DE10BD151F99"
Received: from mx1.testprovider.net(mx1.testprovider.net [198.197.196.195])
(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
(Client CN "*.foobar.net", Issuer "Gandi Standard SSL CA" (not verified))
by blackhole (Postfix) with ESMTPS id DEADBEEF
for <me@testprovider.net>; Thu, 11 Sep 2014 16:52:10 +0000 (UTC)
Delivered-To: 926d4915cfd42b6d96d38660c04613af@testprovider.net
Message-Id: <20140911165205.GB8054@samsara>
From: Kali <kali@leap.se>
(snip)
IMAP Message Rendering Regressions
----------------------------------
For testing the IMAP server implementation, there is a litte regressions script
that needs some manual work from your side.
First of all, you need an already initialized account. Which for now basically
means you have created a new account with a provider that offers the Encrypted
Mail Service, using the Bitmask Client wizard. Then you need to log in with that
account, and let it generate the secrets and sync with the remote for a first
time. After this you can run the twistd server locally and offline.
From the ``leap.mail.imap.tests`` folder, and with an already initialized server
running::
./regressions_mime_struct user@provider pass path_to_samples/
You can find several message samples in the ``leap/mail/tests`` folder.
|
