xmpp instructions
This commit is contained in:
Bob Mottram
parent
e4ad775217
commit
acf70a6fe6
76
usage.org
76
usage.org
|
|
@ -357,3 +357,79 @@ Enter *#freedombone* as the channel name.
|
||||||
Click *close* and then *connect*.
|
Click *close* and then *connect*.
|
||||||
|
|
||||||
** XMPP/Jabber
|
** 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.
|
||||||
|
|
|
||||||
|
|
@ -4,7 +4,7 @@
|
||||||
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
|
||||||
<head>
|
<head>
|
||||||
<title></title>
|
<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 http-equiv="Content-Type" content="text/html;charset=utf-8" />
|
||||||
<meta name="generator" content="Org-mode" />
|
<meta name="generator" content="Org-mode" />
|
||||||
<meta name="author" content="Bob Mottram" />
|
<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">
|
<div id="outline-container-unnumbered-36" class="outline-3">
|
||||||
<h3 id="unnumbered-36">XMPP/Jabber</h3>
|
<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>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue