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