소스 검색

xmpp instructions

Bob Mottram 10 년 전
부모
커밋
acf70a6fe6
2개의 변경된 파일219개의 추가작업 그리고 1개의 파일을 삭제
  1. 76
    0
      usage.org
  2. 143
    1
      website/usage.html

+ 76
- 0
usage.org 파일 보기

@@ -357,3 +357,79 @@ Enter *#freedombone* as the channel name.
357 357
 Click *close* and then *connect*.
358 358
 
359 359
 ** XMPP/Jabber
360
+*** Managing users
361
+
362
+To add a user:
363
+
364
+#+BEGIN_SRC bash
365
+ssh username@domainname -p 2222
366
+su
367
+prosodyctl adduser newusername@newdomainname
368
+exit
369
+exit
370
+#+END_SRC
371
+
372
+To change a user password:
373
+
374
+#+BEGIN_SRC bash
375
+ssh username@domainname -p 2222
376
+su
377
+prosodyctl passwd username@domainname
378
+exit
379
+exit
380
+#+END_SRC
381
+
382
+To remove a user:
383
+
384
+#+BEGIN_SRC bash
385
+ssh username@domainname -p 2222
386
+su
387
+prosodyctl deluser username@domainname.com
388
+exit
389
+exit
390
+#+END_SRC
391
+
392
+Report the status of the XMPP server:
393
+
394
+#+BEGIN_SRC bash
395
+ssh username@domainname -p 2222
396
+su
397
+prosodyctl status
398
+exit
399
+exit
400
+#+END_SRC
401
+
402
+*** Using with Jitsi
403
+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.
404
+
405
+Jitsi can be downloaded from https://jitsi.org
406
+
407
+On your desktop/laptop open Jitsi and select *Options* from the *Tools* menu.
408
+
409
+Click *Add* to add a new user, then enter the Jabber ID which you previously specified with /prosodyctl/ when setting up the XMPP server. Close and then you should notice that your status is "Online" (or if not then you should be able to set it to online).
410
+
411
+From the *File* menu you can add contacts, then select the chat icon to begin a chat.  Click on the lock icon on the right hand side and this will initiate an authentication procedure in which you can specify a question and answer to verify the identity of the person you're communicating with.  Once authentication is complete then you'll be chating using OTR, which provides an additional layer of security.
412
+
413
+When opening Jitsi initially you will get a certificate warning for your domain name (assuming that you're using a self-signed certificate). If this happens then select *View Certificate* and enable the checkbox to trust the certificate, then select *Continue Anyway*.  Once you've done this then the certificate warning will not appear again unless you reinstall Jitsi or use a different computer.
414
+
415
+You can also [[https://www.youtube.com/watch?v=vgx7VSrDGjk][see this video]] as an example of using OTR.
416
+*** Using with Ubuntu
417
+The default XMPP client in Ubuntu is Empathy.  Using Empathy isn't as secure as using Jitsi, since it doesn't include the /off the record/ feature, but since it's the default it's what many users will have easy access to.
418
+
419
+Open *System Settings* and select *Online Accounts*, *Add account*  and then *Jabber*.
420
+
421
+Enter your username (username@domainname) and password.
422
+
423
+Click on *Advanced* and make sure that *Encryption required* and *Ignore SSL certificate errors* are checked.  Ignoring the certificate errors will allow you to use the self-signed certificate created earlier.  Then click *Done* and set your Jabber account and Empathy to *On*.
424
+*** Using with Android
425
+Install [[https://f-droid.org/][F-Droid]]
426
+
427
+Search for and install Xabber.
428
+
429
+Add an account and enter your Jabber/XMPP ID and password.
430
+
431
+From the menu select *Settings* then *Security* then *OTR mode*.  Set the mode to *Required*.
432
+
433
+Make sure that *Check server certificate* is not checked.
434
+
435
+Go back to the initial screen and then using the menu you can add contacts and begin chatting.  Both parties will need to go through the off-the-record question and answer verification before the chat can begin, but that only needs to be done once for each person you're chatting with.

+ 143
- 1
website/usage.html 파일 보기

@@ -4,7 +4,7 @@
4 4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5 5
 <head>
6 6
 <title></title>
7
-<!-- 2014-10-26 Sun 20:49 -->
7
+<!-- 2014-10-27 Mon 22:29 -->
8 8
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
9 9
 <meta  name="generator" content="Org-mode" />
10 10
 <meta  name="author" content="Bob Mottram" />
@@ -1092,6 +1092,148 @@ Click <b>close</b> and then <b>connect</b>.
1092 1092
 
1093 1093
 <div id="outline-container-unnumbered-36" class="outline-3">
1094 1094
 <h3 id="unnumbered-36">XMPP/Jabber</h3>
1095
+<div class="outline-text-3" id="text-unnumbered-36">
1096
+</div><div id="outline-container-unnumbered-37" class="outline-4">
1097
+<h4 id="unnumbered-37">Managing users</h4>
1098
+<div class="outline-text-4" id="text-unnumbered-37">
1099
+<p>
1100
+To add a user:
1101
+</p>
1102
+
1103
+<div class="org-src-container">
1104
+
1105
+<pre class="src src-bash">ssh username@domainname -p 2222
1106
+su
1107
+prosodyctl adduser newusername@newdomainname
1108
+<span class="org-keyword">exit</span>
1109
+<span class="org-keyword">exit</span>
1110
+</pre>
1111
+</div>
1112
+
1113
+<p>
1114
+To change a user password:
1115
+</p>
1116
+
1117
+<div class="org-src-container">
1118
+
1119
+<pre class="src src-bash">ssh username@domainname -p 2222
1120
+su
1121
+prosodyctl passwd username@domainname
1122
+<span class="org-keyword">exit</span>
1123
+<span class="org-keyword">exit</span>
1124
+</pre>
1125
+</div>
1126
+
1127
+<p>
1128
+To remove a user:
1129
+</p>
1130
+
1131
+<div class="org-src-container">
1132
+
1133
+<pre class="src src-bash">ssh username@domainname -p 2222
1134
+su
1135
+prosodyctl deluser username@domainname.com
1136
+<span class="org-keyword">exit</span>
1137
+<span class="org-keyword">exit</span>
1138
+</pre>
1139
+</div>
1140
+
1141
+<p>
1142
+Report the status of the XMPP server:
1143
+</p>
1144
+
1145
+<div class="org-src-container">
1146
+
1147
+<pre class="src src-bash">ssh username@domainname -p 2222
1148
+su
1149
+prosodyctl status
1150
+<span class="org-keyword">exit</span>
1151
+<span class="org-keyword">exit</span>
1152
+</pre>
1153
+</div>
1154
+</div>
1155
+</div>
1156
+
1157
+<div id="outline-container-unnumbered-38" class="outline-4">
1158
+<h4 id="unnumbered-38">Using with Jitsi</h4>
1159
+<div class="outline-text-4" id="text-unnumbered-38">
1160
+<p>
1161
+Jitsi is the recommended communications client for desktop or laptop systems, since it includes the <i>off the record</i> (OTR) feature which provides some additional security beyond the usual SSL certificates.
1162
+</p>
1163
+
1164
+<p>
1165
+Jitsi can be downloaded from <a href="https://jitsi.org/">https://jitsi.org/</a>
1166
+</p>
1167
+
1168
+<p>
1169
+On your desktop/laptop open Jitsi and select <b>Options</b> from the <b>Tools</b> menu.
1170
+</p>
1171
+
1172
+<p>
1173
+Click <b>Add</b> to add a new user, then enter the Jabber ID which you previously specified with <i>prosodyctl</i> when setting up the XMPP server. Close and then you should notice that your status is "Online" (or if not then you should be able to set it to online).
1174
+</p>
1175
+
1176
+<p>
1177
+From the <b>File</b> menu you can add contacts, then select the chat icon to begin a chat.  Click on the lock icon on the right hand side and this will initiate an authentication procedure in which you can specify a question and answer to verify the identity of the person you're communicating with.  Once authentication is complete then you'll be chating using OTR, which provides an additional layer of security.
1178
+</p>
1179
+
1180
+<p>
1181
+When opening Jitsi initially you will get a certificate warning for your domain name (assuming that you're using a self-signed certificate). If this happens then select <b>View Certificate</b> and enable the checkbox to trust the certificate, then select <b>Continue Anyway</b>.  Once you've done this then the certificate warning will not appear again unless you reinstall Jitsi or use a different computer.
1182
+</p>
1183
+
1184
+<p>
1185
+You can also <a href="https://www.youtube.com/watch?v=vgx7VSrDGjk">see this video</a> as an example of using OTR.
1186
+</p>
1187
+</div>
1188
+</div>
1189
+<div id="outline-container-unnumbered-39" class="outline-4">
1190
+<h4 id="unnumbered-39">Using with Ubuntu</h4>
1191
+<div class="outline-text-4" id="text-unnumbered-39">
1192
+<p>
1193
+The default XMPP client in Ubuntu is Empathy.  Using Empathy isn't as secure as using Jitsi, since it doesn't include the <i>off the record</i> feature, but since it's the default it's what many users will have easy access to.
1194
+</p>
1195
+
1196
+<p>
1197
+Open <b>System Settings</b> and select <b>Online Accounts</b>, <b>Add account</b>  and then <b>Jabber</b>.
1198
+</p>
1199
+
1200
+<p>
1201
+Enter your username (username@domainname) and password.
1202
+</p>
1203
+
1204
+<p>
1205
+Click on <b>Advanced</b> and make sure that <b>Encryption required</b> and <b>Ignore SSL certificate errors</b> are checked.  Ignoring the certificate errors will allow you to use the self-signed certificate created earlier.  Then click <b>Done</b> and set your Jabber account and Empathy to <b>On</b>.
1206
+</p>
1207
+</div>
1208
+</div>
1209
+<div id="outline-container-unnumbered-40" class="outline-4">
1210
+<h4 id="unnumbered-40">Using with Android</h4>
1211
+<div class="outline-text-4" id="text-unnumbered-40">
1212
+<p>
1213
+Install <a href="https://f-droid.org/">F-Droid</a>
1214
+</p>
1215
+
1216
+<p>
1217
+Search for and install Xabber.
1218
+</p>
1219
+
1220
+<p>
1221
+Add an account and enter your Jabber/XMPP ID and password.
1222
+</p>
1223
+
1224
+<p>
1225
+From the menu select <b>Settings</b> then <b>Security</b> then <b>OTR mode</b>.  Set the mode to <b>Required</b>.
1226
+</p>
1227
+
1228
+<p>
1229
+Make sure that <b>Check server certificate</b> is not checked.
1230
+</p>
1231
+
1232
+<p>
1233
+Go back to the initial screen and then using the menu you can add contacts and begin chatting.  Both parties will need to go through the off-the-record question and answer verification before the chat can begin, but that only needs to be done once for each person you're chatting with.
1234
+</p>
1235
+</div>
1236
+</div>
1095 1237
 </div>
1096 1238
 </div>
1097 1239
 </div>