free
/
freedombonee
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

xmpp instructions

This commit is contained in:
Bob Mottram 2014-10-27 22:29:38 +00:00
parent e4ad775217
commit acf70a6fe6
2 changed files with 219 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

76
usage.org
View File

@ -357,3 +357,79 @@ Enter *#freedombone* as the channel name.
Click *close* and then *connect*.
** XMPP/Jabber
*** Managing users
To add a user:
#+BEGIN_SRC bash
ssh username@domainname -p 2222
su
prosodyctl adduser newusername@newdomainname
exit
exit
#+END_SRC
To change a user password:
#+BEGIN_SRC bash
ssh username@domainname -p 2222
su
prosodyctl passwd username@domainname
exit
exit
#+END_SRC
To remove a user:
#+BEGIN_SRC bash
ssh username@domainname -p 2222
su
prosodyctl deluser username@domainname.com
exit
exit
#+END_SRC
Report the status of the XMPP server:
#+BEGIN_SRC bash
ssh username@domainname -p 2222
su
prosodyctl status
exit
exit
#+END_SRC
*** Using with Jitsi
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.
Jitsi can be downloaded from https://jitsi.org
On your desktop/laptop open Jitsi and select *Options* from the *Tools* menu.
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).
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.
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.
You can also [[https://www.youtube.com/watch?v=vgx7VSrDGjk][see this video]] as an example of using OTR.
*** Using with Ubuntu
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.
Open *System Settings* and select *Online Accounts*, *Add account* and then *Jabber*.
Enter your username (username@domainname) and password.
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*.
*** Using with Android
Install [[https://f-droid.org/][F-Droid]]
Search for and install Xabber.
Add an account and enter your Jabber/XMPP ID and password.
From the menu select *Settings* then *Security* then *OTR mode*. Set the mode to *Required*.
Make sure that *Check server certificate* is not checked.
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.

144
website/usage.html
View File

@ -4,7 +4,7 @@
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<title></title>
<!-- 2014-10-26 Sun 20:49 -->
<!-- 2014-10-27 Mon 22:29 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="generator" content="Org-mode" />
<meta name="author" content="Bob Mottram" />
@ -1092,6 +1092,148 @@ Click <b>close</b> and then <b>connect</b>.
<div id="outline-container-unnumbered-36" class="outline-3">
<h3 id="unnumbered-36">XMPP/Jabber</h3>
<div class="outline-text-3" id="text-unnumbered-36">
</div><div id="outline-container-unnumbered-37" class="outline-4">
<h4 id="unnumbered-37">Managing users</h4>
<div class="outline-text-4" id="text-unnumbered-37">
<p>
To add a user:
</p>
<div class="org-src-container">
<pre class="src src-bash">ssh username@domainname -p 2222
su
prosodyctl adduser newusername@newdomainname
<span class="org-keyword">exit</span>
<span class="org-keyword">exit</span>
</pre>
</div>
<p>
To change a user password:
</p>
<div class="org-src-container">
<pre class="src src-bash">ssh username@domainname -p 2222
su
prosodyctl passwd username@domainname
<span class="org-keyword">exit</span>
<span class="org-keyword">exit</span>
</pre>
</div>
<p>
To remove a user:
</p>
<div class="org-src-container">
<pre class="src src-bash">ssh username@domainname -p 2222
su
prosodyctl deluser username@domainname.com
<span class="org-keyword">exit</span>
<span class="org-keyword">exit</span>
</pre>
</div>
<p>
Report the status of the XMPP server:
</p>
<div class="org-src-container">
<pre class="src src-bash">ssh username@domainname -p 2222
su
prosodyctl status
<span class="org-keyword">exit</span>
<span class="org-keyword">exit</span>
</pre>
</div>
</div>
</div>
<div id="outline-container-unnumbered-38" class="outline-4">
<h4 id="unnumbered-38">Using with Jitsi</h4>
<div class="outline-text-4" id="text-unnumbered-38">
<p>
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.
</p>
<p>
Jitsi can be downloaded from <a href="https://jitsi.org/">https://jitsi.org/</a>
</p>
<p>
On your desktop/laptop open Jitsi and select <b>Options</b> from the <b>Tools</b> menu.
</p>
<p>
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).
</p>
<p>
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.
</p>
<p>
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.
</p>
<p>
You can also <a href="https://www.youtube.com/watch?v=vgx7VSrDGjk">see this video</a> as an example of using OTR.
</p>
</div>
</div>
<div id="outline-container-unnumbered-39" class="outline-4">
<h4 id="unnumbered-39">Using with Ubuntu</h4>
<div class="outline-text-4" id="text-unnumbered-39">
<p>
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.
</p>
<p>
Open <b>System Settings</b> and select <b>Online Accounts</b>, <b>Add account</b> and then <b>Jabber</b>.
</p>
<p>
Enter your username (username@domainname) and password.
</p>
<p>
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>.
</p>
</div>
</div>
<div id="outline-container-unnumbered-40" class="outline-4">
<h4 id="unnumbered-40">Using with Android</h4>
<div class="outline-text-4" id="text-unnumbered-40">
<p>
Install <a href="https://f-droid.org/">F-Droid</a>
</p>
<p>
Search for and install Xabber.
</p>
<p>
Add an account and enter your Jabber/XMPP ID and password.
</p>
<p>
From the menu select <b>Settings</b> then <b>Security</b> then <b>OTR mode</b>. Set the mode to <b>Required</b>.
</p>
<p>
Make sure that <b>Check server certificate</b> is not checked.
</p>
<p>
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.
</p>
</div>
</div>
</div>
</div>
</div>