|
@@ -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>
|