Преглед на файлове

Update documentation for profanity

Bob Mottram преди 9 години
родител
ревизия
77b4865d2b
променени са 2 файла, в които са добавени 91 реда и са изтрити 11 реда
  1. 34
    4
      doc/EN/usage.org
  2. 57
    7
      website/EN/usage.html

+ 34
- 4
doc/EN/usage.org Целия файл

196
 ssh username@domain -p 2222
196
 ssh username@domain -p 2222
197
 #+END_SRC
197
 #+END_SRC
198
 
198
 
199
-Then select XMPP and enter your password (for the admin user this can also be found in the README in your home directory).
200
-
201
-Generate an [[https://en.wikipedia.org/wiki/Off-the-Record_Messaging][OTR]] key with:
199
+Then select XMPP. Generate an [[https://en.wikipedia.org/wiki/Off-the-Record_Messaging][OTR]] key with:
202
 
200
 
203
 #+BEGIN_SRC bash
201
 #+BEGIN_SRC bash
204
 /otr gen
202
 /otr gen
210
 /otr start otherusername@otheruserdomain
208
 /otr start otherusername@otheruserdomain
211
 #+END_SRC
209
 #+END_SRC
212
 
210
 
213
-It's automatically routed through Tor and so if you are also using OTR then this provides protection for both message content and metadata.
211
+or if you're already in an insecure chat with someone just use:
212
+
213
+#+BEGIN_SRC bash
214
+/otr start
215
+#+END_SRC
216
+
217
+Set a security question and answer:
218
+
219
+#+BEGIN_SRC bash
220
+/otr question "What is the name of your best friends rabbit?" fiffi
221
+#+END_SRC
222
+
223
+On the other side the user can enter:
224
+
225
+#+BEGIN_SRC bash
226
+/otr answer fifi
227
+#+END_SRC
228
+
229
+For the most paranoid you can also obtain your fingerprint:
230
+
231
+#+BEGIN_SRC bash
232
+/otr myfp
233
+#+END_SRC
234
+
235
+and quote that.  If they quote their back you can check it with:
236
+
237
+#+BEGIN_SRC bash
238
+/otr theirfp
239
+#+END_SRC
240
+
241
+If the fingerprints match then you can be pretty confident that unless you have been socially engineered via the question and answer you probably are talking to who you think you are, and that it will be difficult for mass surveillance systems to know the content of the conversation. For more details see [[http://www.profanity.im/otr.html][this guide]].
242
+
243
+ When accessed via the user control panel the client is automatically routed through Tor and so if you are also using OTR then this provides protection for both message content and metadata.
214
 *** Using with Jitsi
244
 *** Using with Jitsi
215
 Jitsi is the recommended communications client for desktop or laptop systems, since it includes the /off the record/ (OTR) feature which provides some additional security beyond the usual SSL certificates.
245
 Jitsi is the recommended communications client for desktop or laptop systems, since it includes the /off the record/ (OTR) feature which provides some additional security beyond the usual SSL certificates.
216
 
246
 

+ 57
- 7
website/EN/usage.html Целия файл

3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5
 <head>
5
 <head>
6
-<!-- 2016-02-27 Sat 23:14 -->
6
+<!-- 2016-02-28 Sun 10:59 -->
7
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
7
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
8
 <meta name="viewport" content="width=device-width, initial-scale=1" />
8
 <meta name="viewport" content="width=device-width, initial-scale=1" />
9
 <title></title>
9
 <title></title>
600
 </div>
600
 </div>
601
 
601
 
602
 <p>
602
 <p>
603
-Then select XMPP and enter your password (for the admin user this can also be found in the README in your home directory).
604
-</p>
605
-
606
-<p>
607
-Generate an <a href="https://en.wikipedia.org/wiki/Off-the-Record_Messaging">OTR</a> key with:
603
+Then select XMPP. Generate an <a href="https://en.wikipedia.org/wiki/Off-the-Record_Messaging">OTR</a> key with:
608
 </p>
604
 </p>
609
 
605
 
610
 <div class="org-src-container">
606
 <div class="org-src-container">
624
 </div>
620
 </div>
625
 
621
 
626
 <p>
622
 <p>
627
-It's automatically routed through Tor and so if you are also using OTR then this provides protection for both message content and metadata.
623
+or if you're already in an insecure chat with someone just use:
624
+</p>
625
+
626
+<div class="org-src-container">
627
+
628
+<pre class="src src-bash">/otr start
629
+</pre>
630
+</div>
631
+
632
+<p>
633
+Set a security question and answer:
634
+</p>
635
+
636
+<div class="org-src-container">
637
+
638
+<pre class="src src-bash">/otr question <span class="org-string">"What is the name of your best friends rabbit?"</span> fiffi
639
+</pre>
640
+</div>
641
+
642
+<p>
643
+On the other side the user can enter:
644
+</p>
645
+
646
+<div class="org-src-container">
647
+
648
+<pre class="src src-bash">/otr answer fifi
649
+</pre>
650
+</div>
651
+
652
+<p>
653
+For the most paranoid you can also obtain your fingerprint:
654
+</p>
655
+
656
+<div class="org-src-container">
657
+
658
+<pre class="src src-bash">/otr myfp
659
+</pre>
660
+</div>
661
+
662
+<p>
663
+and quote that.  If they quote their back you can check it with:
664
+</p>
665
+
666
+<div class="org-src-container">
667
+
668
+<pre class="src src-bash">/otr theirfp
669
+</pre>
670
+</div>
671
+
672
+<p>
673
+If the fingerprints match then you can be pretty confident that unless you have been socially engineered via the question and answer you probably are talking to who you think you are, and that it will be difficult for mass surveillance systems to know the content of the conversation. For more details see <a href="http://www.profanity.im/otr.html">this guide</a>.
674
+</p>
675
+
676
+<p>
677
+When accessed via the user control panel the client is automatically routed through Tor and so if you are also using OTR then this provides protection for both message content and metadata.
628
 </p>
678
 </p>
629
 </div>
679
 </div>
630
 </div>
680
 </div>