free
/
freedombone
Observar 1
Favorito 0
Fork 0
Código Issues 0 Pull Requests 0 Versões 0 Wiki Atividade
Ver código fonte

xmpp instructions

Bob Mottram 10 anos atrás
pai
e4ad775217
commit
acf70a6fe6
2 arquivos alterados com 219 adições e 1 exclusões
Visão unificada Mostrar estatísticas do Diff
  1. 76
    0
      usage.org
  2. 143
    1
      website/usage.html

+ 76
- 0
usage.org Ver arquivo

357 
 Click *close* and then *connect*.
 357 
 Click *close* and then *connect*.
358
358
359 
 ** XMPP/Jabber
 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 Ver arquivo

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 
 <title></title>
 6 
 <title></title>
7 
-<!-- 2014-10-26 Sun 20:49 -->
7 
+<!-- 2014-10-27 Mon 22:29 -->
8 
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
 8 
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
9 
 <meta  name="generator" content="Org-mode" />
 9 
 <meta  name="generator" content="Org-mode" />
10 
 <meta  name="author" content="Bob Mottram" />
 10 
 <meta  name="author" content="Bob Mottram" />
1092
1092
1093 
 <div id="outline-container-unnumbered-36" class="outline-3">
 1093 
 <div id="outline-container-unnumbered-36" class="outline-3">
1094 
 <h3 id="unnumbered-36">XMPP/Jabber</h3>
 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 
 </div>
 1237 
 </div>
1096 
 </div>
 1238 
 </div>
1097 
 </div>
 1239 
 </div>