blob: 018a509cbfdd31bcdb6b079f2cce25c6acb8f9dd (
plain)
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
|
Bitmask Thunderbird Extension
=============================
The Bitmask Thunderbird Extension provides:
* A wizard for creating email accounts with IMAP/SMTP configuration targeted
to localhost and the default Bitmask client ports. There are different ways to
launch the wizard for configuring a Bitmask Account:
- File -> New -> Bitmask account.
- Edit -> Account Settings... -> Account Actions -> Add Bitmask Accont.
* Caching prevention: accounts are created with caching turned off and the
UI is modified to prevent users from turning on caching for these
accounts.
Development/testing
-------------------
For development/testing purposes you can create a text file in Thunderbird's
extension directory whose contents point to the repository dir:
* The file must be created in the `~/.thunderbird/<profile>/extensions/`
directory.
* The file name must be `bitmask-thunderbird@leap.se`.
* The file contents must be the path for this repository.
Certificates
------------
For generating signed XPI packages you need a code signing certificate. In
order to do that you will need Network Security Services ("nss") and Netscape
Portable Runtime ("nspr"). If you are running debian, you can do:
apt install libnss3-dev libnspr4-dev libnss3-tools
Initialize some variables:
CERTDIR=/path/to/cert/dir
CERTNICK=myCertificateNickname
Initialize the certificate database:
certutil -N -d ${CERTDIR}
Generate a signing certificate:
signtool -G ${CERTNICK} -d ${CERTDIR} -p"<password>"
XPI Package
-----------
To generate an unsigned XPI package, type the following inside the root of the
repository:
make DEFAULTKEY=<key id>
This command will:
* Generate a `.xpi` file inside the `build/` directory.
* Create a `build/SHA512SUMS` file containing the sha512 hash of the `.xpi` file.
* Sign that file with the given `DEFAULTKEY` and create a `build/SHA512SUMS.gpg` file.
You can now use the generated `.xpi` file install the package as a normal
Thunderbird extension.
Signed XPI package
------------------
To generate a signed XPI package you must first have a certificate and then do
the following:
make signed CERTDIR=<path to cert dir> CERTNAME=<cert name> DEFAULTKEY=<key id>
This command will:
* Generate a signed `.xpi` file inside the `build/` directory using the
`CERTNAME` certificate contained in `CERTDIR`.
* Create a `build/SHA512SUMS` file containing the sha512 hash of the `.xpi` file.
* Sign that file with the given `DEFAULTKEY` and create a `build/SHA512SUMS.gpg` file.
For more information about signed `.xpi` files, see:
https://developer.mozilla.org/en-US/docs/Signing_a_XPI
|
