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

ssh keys

This commit is contained in:
Bob Mottram 2014-12-08 18:43:32 +00:00
parent 99f21eefe1
commit f143a83d94
2 changed files with 310 additions and 184 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
usage.org
View File

@ -21,6 +21,36 @@ emacs ~/README
You should transfer any passwords to a password manager such as [[http://www.keepassx.org/][KeepassX]] and then delete them from the README file. To save the file after removing passwords use *CTRL-x CTRL-s*.
To exit you can either just close the terminal or use *CTRL-x CTRL-c* followed by the *exit* command.
* Improving ssh security
To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
On your local machine:
#+BEGIN_SRC bash
ssh-keygen
#+END_SRC
For extra security you may also want to add a passphrase to the ssh private key. You can show the generated public key with:
#+BEGIN_SRC bash
cat ~/.ssh/id_rsa.pub
#+END_SRC
Copy the contents of *~/.ssh/id_rsa* and *~/.ssh/id_rsa.pub* to you password manager, together with the private key password if you created one.
ssh to the Freedombone and edit the authorized keys:
#+BEGIN_SRC bash
ssh username@domain -p 2222
emacs ~/.ssh/authorized_keys
#+END_SRC
Now copy and paste the contents of *id_rsa.pub* into the authorized_keys file. Save the file and exit. Open another terminal window and try logging in again and you should notice that you are no longer asked for a password, because the ssh key is used instead.
There are advantages and disadvantages to using ssh keys for logins. The advantage is that this is much more secure than a memorised password, but the disadvantage is that you need to carry your ssh keys around and be able to install them on any computer of mobile device that you use. In high security or hostile infosec environments it may not be possible to carry or use USB thumb drives containing your keys and so memorised passwords may be the only available choice.
If you wish to only use ssh keys then log in to the Freedombone and edit */etc/ssh/sshd_config*, then change *PasswordAuthentication* to "no", save and run *service ssh restart*. Any subsequent attempts to log in via a password will then be denied.
* Using Email
** A technical note about email transport security
Port 465 is used for SMTP and this is supposedly deprecated for secure email. However, using TLS from the start of the communications seems far more secure than starting off with insecure communications and then trying to upgrade it with a command to begin TLS, as happens with STARTTLS. There are [[https://www.eff.org/deeplinks/2014/11/starttls-downgrade-attacks][possible attacks against STARTTLS]] in which the command to begin secure communications is removed or overwritten which could then result in email being transferred in plain text over the internet and be readable by third parties.

464
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-11-11 Tue 21:13 -->
<!-- 2014-12-08 Mon 15:20 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="generator" content="Org-mode" />
<meta name="author" content="Bob Mottram" />
@ -91,10 +91,6 @@
{ background-color: #ffff00; color: #000000; font-weight: bold; }
/*]]>*/-->
</style>
<link rel="stylesheet" type="text/css"
href="http://sachachua.com/blog/wp-content/themes/sacha-v3/foundation/css/foundation.min.css"></link>
<link rel="stylesheet" type="text/css" href="http://sachachua.com/org-export.css"></link>
<link rel="stylesheet" type="text/css" href="http://sachachua.com/blog/wp-content/themes/sacha-v3/style.css"></link>
<script type="text/javascript">
/*
@licstart The following is the entire license notice for the
@ -143,11 +139,85 @@ for the JavaScript code in this tag.
</script>
</head>
<body>
<div id="preamble" class="status">
<a name="top" id="top"></a>
</div>
<div id="content">
<h1 class="title"></h1>
<div id="table-of-contents">
<h2>Table of Contents</h2>
<div id="text-table-of-contents">
<ul>
<li><a href="#sec-1">1. Readme</a></li>
<li><a href="#sec-2">2. Improving ssh security</a></li>
<li><a href="#sec-3">3. Using Email</a>
<ul>
<li><a href="#sec-3-1">3.1. A technical note about email transport security</a></li>
<li><a href="#sec-3-2">3.2. Add a password to your GPG key</a></li>
<li><a href="#sec-3-3">3.3. Publishing your GPG public key</a></li>
<li><a href="#sec-3-4">3.4. Mutt email client</a></li>
<li><a href="#sec-3-5">3.5. Thunderbird</a>
<ul>
<li><a href="#sec-3-5-1">3.5.1. Initial setup</a></li>
<li><a href="#sec-3-5-2">3.5.2. Import your GPG keys</a></li>
<li><a href="#sec-3-5-3">3.5.3. Using for the first time</a></li>
<li><a href="#sec-3-5-4">3.5.4. Making folders visible</a></li>
</ul>
</li>
<li><a href="#sec-3-6">3.6. K9 Android client</a>
<ul>
<li><a href="#sec-3-6-1">3.6.1. Incoming server settings</a></li>
<li><a href="#sec-3-6-2">3.6.2. Outgoing (SMTP) server settings</a></li>
<li><a href="#sec-3-6-3">3.6.3. Folders</a></li>
</ul>
</li>
<li><a href="#sec-3-7">3.7. Subscribing to mailing lists</a></li>
<li><a href="#sec-3-8">3.8. Adding email addresses to a group/folder</a></li>
</ul>
</li>
<li><a href="#sec-4">4. Mailing List</a></li>
<li><a href="#sec-5">5. Syncing to the Cloud</a>
<ul>
<li><a href="#sec-5-1">5.1. Initial install</a></li>
<li><a href="#sec-5-2">5.2. On Android</a></li>
<li><a href="#sec-5-3">5.3. On Linux</a></li>
</ul>
</li>
<li><a href="#sec-6">6. Play Music</a>
<ul>
<li><a href="#sec-6-1">6.1. With the DLNA service</a></li>
<li><a href="#sec-6-2">6.2. With Owncloud</a></li>
</ul>
</li>
<li><a href="#sec-7">7. Microblogging</a>
<ul>
<li><a href="#sec-7-1">7.1. Initial configuration</a></li>
</ul>
</li>
<li><a href="#sec-8">8. Social Network</a>
<ul>
<li><a href="#sec-8-1">8.1. Certificates</a></li>
<li><a href="#sec-8-2">8.2. Initial install</a></li>
</ul>
</li>
<li><a href="#sec-9">9. Chat Services</a>
<ul>
<li><a href="#sec-9-1">9.1. IRC</a>
<ul>
<li><a href="#sec-9-1-1">9.1.1. Irssi</a></li>
<li><a href="#sec-9-1-2">9.1.2. XChat</a></li>
</ul>
</li>
<li><a href="#sec-9-2">9.2. XMPP/Jabber</a>
<ul>
<li><a href="#sec-9-2-1">9.2.1. Managing users</a></li>
<li><a href="#sec-9-2-2">9.2.2. Using with Jitsi</a></li>
<li><a href="#sec-9-2-3">9.2.3. Using with Ubuntu</a></li>
<li><a href="#sec-9-2-4">9.2.4. Using with Android</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<div class="center">
<div class="figure">
@ -181,21 +251,21 @@ for the JavaScript code in this tag.
<tbody>
<tr>
<td class="left"><a href="index.html">Home</a></td>
<td class="left"><a href="#unnumbered-1">Readme</a></td>
<td class="left"><a href="#unnumbered-2">Using Email</a></td>
<td class="left"><a href="#unnumbered-18">Mailing List</a></td>
<td class="left"><a href="#unnumbered-19">Syncing to the Cloud</a></td>
<td class="left"><a href="#unnumbered-23">Play Music</a></td>
<td class="left"><a href="#unnumbered-26">Microblogging</a></td>
<td class="left"><a href="#unnumbered-28">Social Network</a></td>
<td class="left"><a href="#unnumbered-31">Chat Services</a></td>
<td class="left"><a href="#sec-1">1</a></td>
<td class="left"><a href="#sec-3">3</a></td>
<td class="left"><a href="#sec-4">4</a></td>
<td class="left"><a href="#sec-5">5</a></td>
<td class="left"><a href="#sec-6">6</a></td>
<td class="left"><a href="#sec-7">7</a></td>
<td class="left"><a href="#sec-8">8</a></td>
<td class="left"><a href="#sec-9">9</a></td>
</tr>
</tbody>
</table>
<div id="outline-container-unnumbered-1" class="outline-2">
<h2 id="unnumbered-1">Readme</h2>
<div class="outline-text-2" id="text-unnumbered-1">
<div id="outline-container-sec-1" class="outline-2">
<h2 id="sec-1"><span class="section-number-2">1</span> Readme</h2>
<div class="outline-text-2" id="text-1">
<p>
After the system has installed a README file will be generated which contains passwords and some brief advice on using the installed systems. You can read this with the following commands:
</p>
@ -216,20 +286,76 @@ To exit you can either just close the terminal or use <b>CTRL-x CTRL-c</b> follo
</p>
</div>
</div>
<div id="outline-container-unnumbered-2" class="outline-2">
<h2 id="unnumbered-2">Using Email</h2>
<div class="outline-text-2" id="text-unnumbered-2">
</div><div id="outline-container-unnumbered-3" class="outline-3">
<h3 id="unnumbered-3">A technical note about email transport security</h3>
<div class="outline-text-3" id="text-unnumbered-3">
<div id="outline-container-sec-2" class="outline-2">
<h2 id="sec-2"><span class="section-number-2">2</span> Improving ssh security</h2>
<div class="outline-text-2" id="text-2">
<p>
To improve ssh security you can generate an ssh key pair on your system and then upload the public key to the Freedombone.
</p>
<p>
On your local machine:
</p>
<div class="org-src-container">
<pre class="src src-bash">ssh-keygen
</pre>
</div>
<p>
For extra security you may also want to add a passphrase to the ssh private key. You can show the generated public key with:
</p>
<div class="org-src-container">
<pre class="src src-bash">cat ~/.ssh/id_rsa.pub
</pre>
</div>
<p>
Copy the contents of <b>~/.ssh/id_rsa</b> and <b>~/.ssh/id_rsa.pub</b> to you password manager, together with the private key password if you created one.
</p>
<p>
ssh to the Freedombone and edit the authorized keys:
</p>
<div class="org-src-container">
<pre class="src src-bash">ssh username@domain -p 2222
emacs ~/.ssh/authorized_keys
</pre>
</div>
<p>
Now copy and paste the contents of <b>id_rsa.pub</b> into the authorized_keys file. Save the file and exit. Open another terminal window and try logging in again and you should notice that you are no longer asked for a password, because the ssh key is used instead.
</p>
<p>
There are advantages and disadvantages to using ssh keys for logins. The advantage is that this is much more secure than a memorised password, but the disadvantage is that you need to carry your ssh keys around and be able to install them on any computer of mobile device that you use. In high security or hostile infosec environments it may not be possible to carry or use USB thumb drives containing your keys and so memorised passwords may be the only available choice.
</p>
<p>
If you wish to only use ssh keys then log in to the Freedombone and edit <b>/etc/ssh/sshd_config</b>, then change <b>PasswordAuthentication</b> to "no", save and run <b>service ssh restart</b>. Any subsequent attempts to log in via a password will then be denied.
</p>
</div>
</div>
<div id="outline-container-sec-3" class="outline-2">
<h2 id="sec-3"><span class="section-number-2">3</span> Using Email</h2>
<div class="outline-text-2" id="text-3">
</div><div id="outline-container-sec-3-1" class="outline-3">
<h3 id="sec-3-1"><span class="section-number-3">3.1</span> A technical note about email transport security</h3>
<div class="outline-text-3" id="text-3-1">
<p>
Port 465 is used for SMTP and this is supposedly deprecated for secure email. However, using TLS from the start of the communications seems far more secure than starting off with insecure communications and then trying to upgrade it with a command to begin TLS, as happens with STARTTLS. There are <a href="https://www.eff.org/deeplinks/2014/11/starttls-downgrade-attacks">possible attacks against STARTTLS</a> in which the command to begin secure communications is removed or overwritten which could then result in email being transferred in plain text over the internet and be readable by third parties.
</p>
</div>
</div>
<div id="outline-container-unnumbered-4" class="outline-3">
<h3 id="unnumbered-4">Add a password to your GPG key</h3>
<div class="outline-text-3" id="text-unnumbered-4">
<div id="outline-container-sec-3-2" class="outline-3">
<h3 id="sec-3-2"><span class="section-number-3">3.2</span> Add a password to your GPG key</h3>
<div class="outline-text-3" id="text-3-2">
<p>
If you didn't use existing GPG keys during the Freedombone installation then you'll need to add a password to your newly generated private key. This is highly recommended. Go through the following sequence of commands to ssh into the Freedombone and then change your GPG password.
</p>
@ -241,7 +367,7 @@ gpg --edit-key username@domain
passwd
save
quit
<span class="org-keyword">exit</span>
exit
</pre>
</div>
@ -251,9 +377,9 @@ Having a password on your GPG key will prevent someone from reading your email <
</div>
</div>
<div id="outline-container-unnumbered-5" class="outline-3">
<h3 id="unnumbered-5">Publishing your GPG public key</h3>
<div class="outline-text-3" id="text-unnumbered-5">
<div id="outline-container-sec-3-3" class="outline-3">
<h3 id="sec-3-3"><span class="section-number-3">3.3</span> Publishing your GPG public key</h3>
<div class="outline-text-3" id="text-3-3">
<p>
If you havn't already then you should publish your GPG public key so that others can find it.
</p>
@ -262,14 +388,14 @@ If you havn't already then you should publish your GPG public key so that others
<pre class="src src-bash">ssh username@domainname -p 2222
gpg --send-keys username@domainname
<span class="org-keyword">exit</span>
exit
</pre>
</div>
</div>
</div>
<div id="outline-container-unnumbered-6" class="outline-3">
<h3 id="unnumbered-6">Mutt email client</h3>
<div class="outline-text-3" id="text-unnumbered-6">
<div id="outline-container-sec-3-4" class="outline-3">
<h3 id="sec-3-4"><span class="section-number-3">3.4</span> Mutt email client</h3>
<div class="outline-text-3" id="text-3-4">
<p>
Mutt is a terminal based email client which comes already installed onto the Freedombone. To access it you'll need to access it via ssh with:
</p>
@ -412,9 +538,9 @@ When reading emails you will initially need to enter your GPG password. It will
</div>
</div>
<div id="outline-container-unnumbered-7" class="outline-3">
<h3 id="unnumbered-7">Thunderbird</h3>
<div class="outline-text-3" id="text-unnumbered-7">
<div id="outline-container-sec-3-5" class="outline-3">
<h3 id="sec-3-5"><span class="section-number-3">3.5</span> Thunderbird</h3>
<div class="outline-text-3" id="text-3-5">
<p>
Another common way in which you may want to access email is via Thunderbird. This may be especially useful if you're trying to convert former Windows users who may previously have been using some version of Outlook.
</p>
@ -424,9 +550,9 @@ The following instructions should be carried out on the client machines (laptop,
</p>
</div>
<div id="outline-container-unnumbered-8" class="outline-4">
<h4 id="unnumbered-8">Initial setup</h4>
<div class="outline-text-4" id="text-unnumbered-8">
<div id="outline-container-sec-3-5-1" class="outline-4">
<h4 id="sec-3-5-1"><span class="section-number-4">3.5.1</span> Initial setup</h4>
<div class="outline-text-4" id="text-3-5-1">
<p>
Install <b>Thunderbird</b> and <b>Enigmail</b>. How you do this just depends upon your distro and software manager or "app store".
</p>
@ -485,9 +611,9 @@ Select "<b>yes</b>" to change default settings.
</p>
</div>
</div>
<div id="outline-container-unnumbered-9" class="outline-4">
<h4 id="unnumbered-9">Import your GPG keys</h4>
<div class="outline-text-4" id="text-unnumbered-9">
<div id="outline-container-sec-3-5-2" class="outline-4">
<h4 id="sec-3-5-2"><span class="section-number-4">3.5.2</span> Import your GPG keys</h4>
<div class="outline-text-4" id="text-3-5-2">
<p>
On the Freedombone export your GPG public and private keys.
</p>
@ -536,9 +662,9 @@ shred -zu ~/private_key.gpg
</div>
</div>
<div id="outline-container-unnumbered-10" class="outline-4">
<h4 id="unnumbered-10">Using for the first time</h4>
<div class="outline-text-4" id="text-unnumbered-10">
<div id="outline-container-sec-3-5-3" class="outline-4">
<h4 id="sec-3-5-3"><span class="section-number-4">3.5.3</span> Using for the first time</h4>
<div class="outline-text-4" id="text-3-5-3">
<p>
Click on the Thunderbird menu, which looks like three horizontal bars on the right hand side.
</p>
@ -573,9 +699,9 @@ Get into the habit of using email encryption and encourage others to do so. Rem
</div>
</div>
<div id="outline-container-unnumbered-11" class="outline-4">
<h4 id="unnumbered-11">Making folders visible</h4>
<div class="outline-text-4" id="text-unnumbered-11">
<div id="outline-container-sec-3-5-4" class="outline-4">
<h4 id="sec-3-5-4"><span class="section-number-4">3.5.4</span> Making folders visible</h4>
<div class="outline-text-4" id="text-3-5-4">
<p>
By default you won't be able to see any folders which you may have created earlier using the <i>mailinglistrule</i> script. To make folders visible select:
</p>
@ -591,17 +717,17 @@ Make sure that "<b>show only subscribed folders</b>" is not checked. Then click
</div>
</div>
<div id="outline-container-unnumbered-12" class="outline-3">
<h3 id="unnumbered-12">K9 Android client</h3>
<div class="outline-text-3" id="text-unnumbered-12">
<div id="outline-container-sec-3-6" class="outline-3">
<h3 id="sec-3-6"><span class="section-number-3">3.6</span> K9 Android client</h3>
<div class="outline-text-3" id="text-3-6">
<p>
<b>NOTE</b>: Currently the K9 email client will not work with the Freedombone since it doesn't support PGP/MIME encoding. However, there is development work taking place on that feature and it is hoped that K9 may be usable in the near future.
</p>
</div>
<div id="outline-container-unnumbered-13" class="outline-4">
<h4 id="unnumbered-13">Incoming server settings</h4>
<div class="outline-text-4" id="text-unnumbered-13">
<div id="outline-container-sec-3-6-1" class="outline-4">
<h4 id="sec-3-6-1"><span class="section-number-4">3.6.1</span> Incoming server settings</h4>
<div class="outline-text-4" id="text-3-6-1">
<ul class="org-ul">
<li>Select settings/account settings
</li>
@ -620,9 +746,9 @@ Make sure that "<b>show only subscribed folders</b>" is not checked. Then click
</ul>
</div>
</div>
<div id="outline-container-unnumbered-14" class="outline-4">
<h4 id="unnumbered-14">Outgoing (SMTP) server settings</h4>
<div class="outline-text-4" id="text-unnumbered-14">
<div id="outline-container-sec-3-6-2" class="outline-4">
<h4 id="sec-3-6-2"><span class="section-number-4">3.6.2</span> Outgoing (SMTP) server settings</h4>
<div class="outline-text-4" id="text-3-6-2">
<ul class="org-ul">
<li>Select settings/account settings
</li>
@ -643,9 +769,9 @@ Make sure that "<b>show only subscribed folders</b>" is not checked. Then click
</ul>
</div>
</div>
<div id="outline-container-unnumbered-15" class="outline-4">
<h4 id="unnumbered-15">Folders</h4>
<div class="outline-text-4" id="text-unnumbered-15">
<div id="outline-container-sec-3-6-3" class="outline-4">
<h4 id="sec-3-6-3"><span class="section-number-4">3.6.3</span> Folders</h4>
<div class="outline-text-4" id="text-3-6-3">
<p>
To view any new folders which you may have created using the <i>mailinglistrule</i> script from your inbox press the <b>K9 icon</b> at the top left to access folders, then press the <b>menu button</b> and select <b>refresh folder list</b>.
</p>
@ -657,9 +783,9 @@ If your folder still doesn't show up then press the <b>menu button</b>, select <
</div>
</div>
<div id="outline-container-unnumbered-16" class="outline-3">
<h3 id="unnumbered-16">Subscribing to mailing lists</h3>
<div class="outline-text-3" id="text-unnumbered-16">
<div id="outline-container-sec-3-7" class="outline-3">
<h3 id="sec-3-7"><span class="section-number-3">3.7</span> Subscribing to mailing lists</h3>
<div class="outline-text-3" id="text-3-7">
<p>
To subscribe to a mailing list so that it appears within Mutt or Thunderbird.
</p>
@ -668,7 +794,7 @@ To subscribe to a mailing list so that it appears within Mutt or Thunderbird.
<pre class="src src-bash">ssh username@domainname -p 2222
addmailinglist &lt;username&gt; &lt;mailinglistname&gt; &lt;subjecttag&gt;
<span class="org-keyword">exit</span>
exit
</pre>
</div>
@ -677,9 +803,9 @@ The subject tag should be the word or phrase which appears within the brackets i
</p>
</div>
</div>
<div id="outline-container-unnumbered-17" class="outline-3">
<h3 id="unnumbered-17">Adding email addresses to a group/folder</h3>
<div class="outline-text-3" id="text-unnumbered-17">
<div id="outline-container-sec-3-8" class="outline-3">
<h3 id="sec-3-8"><span class="section-number-3">3.8</span> Adding email addresses to a group/folder</h3>
<div class="outline-text-3" id="text-3-8">
<p>
Similar to adding mailing list folders you can also add specified email addresses into a folder.
</p>
@ -688,7 +814,7 @@ Similar to adding mailing list folders you can also add specified email addresse
<pre class="src src-bash">ssh username@domainname -p 2222
addemailtofolder &lt;username&gt; &lt;emailaddress&gt; &lt;mailinglistname&gt;
<span class="org-keyword">exit</span>
exit
</pre>
</div>
@ -699,9 +825,9 @@ The mailing list name should be something short so that it is readable within th
</div>
</div>
<div id="outline-container-unnumbered-18" class="outline-2">
<h2 id="unnumbered-18">Mailing List</h2>
<div class="outline-text-2" id="text-unnumbered-18">
<div id="outline-container-sec-4" class="outline-2">
<h2 id="sec-4"><span class="section-number-2">4</span> Mailing List</h2>
<div class="outline-text-2" id="text-4">
<p>
If you want to set up a public mailing list then when installing the system remember to set the <b>PUBLIC_MAILING_LIST</b> variable within <b>freedombone.cfg</b> to the name of your list. The name should have no spaces in it. Public mailing lists are unencrypted so anyone will be able to read the contents, including non subscribers.
</p>
@ -721,12 +847,12 @@ Tip: When using the Mutt email client if you want to send an email in cleartext
</p>
</div>
</div>
<div id="outline-container-unnumbered-19" class="outline-2">
<h2 id="unnumbered-19">Syncing to the Cloud</h2>
<div class="outline-text-2" id="text-unnumbered-19">
</div><div id="outline-container-unnumbered-20" class="outline-3">
<h3 id="unnumbered-20">Initial install</h3>
<div class="outline-text-3" id="text-unnumbered-20">
<div id="outline-container-sec-5" class="outline-2">
<h2 id="sec-5"><span class="section-number-2">5</span> Syncing to the Cloud</h2>
<div class="outline-text-2" id="text-5">
</div><div id="outline-container-sec-5-1" class="outline-3">
<h3 id="sec-5-1"><span class="section-number-3">5.1</span> Initial install</h3>
<div class="outline-text-3" id="text-5-1">
<p>
Within a browser go to your owncloud domain, then create an administrator account. The username and password can be anything, and ideally should be generated from a password manager.
</p>
@ -751,7 +877,7 @@ You will also need to enter database details:
<tr>
<td class="left">Owncloud database password</td>
<td class="left">See the <a href="#unnumbered-1">Readme</a> file</td>
<td class="left">See the <a href="#sec-1">1</a> file</td>
</tr>
<tr>
@ -770,9 +896,9 @@ Log out from the administrator account and then log back in as the user you just
</p>
</div>
</div>
<div id="outline-container-unnumbered-21" class="outline-3">
<h3 id="unnumbered-21">On Android</h3>
<div class="outline-text-3" id="text-unnumbered-21">
<div id="outline-container-sec-5-2" class="outline-3">
<h3 id="sec-5-2"><span class="section-number-3">5.2</span> On Android</h3>
<div class="outline-text-3" id="text-5-2">
<p>
Within F-droid search for <b>owncloud</b> and install the client. Also install <b>CalDAV Sync Adapter</b>.
</p>
@ -796,9 +922,9 @@ You will also be prompted to enter login details. Your Android and Owncloud cale
</p>
</div>
</div>
<div id="outline-container-unnumbered-22" class="outline-3">
<h3 id="unnumbered-22">On Linux</h3>
<div class="outline-text-3" id="text-unnumbered-22">
<div id="outline-container-sec-5-3" class="outline-3">
<h3 id="sec-5-3"><span class="section-number-3">5.3</span> On Linux</h3>
<div class="outline-text-3" id="text-5-3">
<p>
Open your software center and search for "owncloud client". Enter your owncloud domain name (with the https prefix) and login details.
</p>
@ -809,12 +935,12 @@ You can now drag files into the <b>~/owncloud</b> directory and they will automa
</div>
</div>
</div>
<div id="outline-container-unnumbered-23" class="outline-2">
<h2 id="unnumbered-23">Play Music</h2>
<div class="outline-text-2" id="text-unnumbered-23">
</div><div id="outline-container-unnumbered-24" class="outline-3">
<h3 id="unnumbered-24">With the DLNA service</h3>
<div class="outline-text-3" id="text-unnumbered-24">
<div id="outline-container-sec-6" class="outline-2">
<h2 id="sec-6"><span class="section-number-2">6</span> Play Music</h2>
<div class="outline-text-2" id="text-6">
</div><div id="outline-container-sec-6-1" class="outline-3">
<h3 id="sec-6-1"><span class="section-number-3">6.1</span> With the DLNA service</h3>
<div class="outline-text-3" id="text-6-1">
<p>
An easy way to play music on any mobile device in your home is to use the DLNA service. Copy your music into a directory called "<i>Music</i>" on a USB thumb drive and then insert it into from socket on the Beaglebone.
</p>
@ -854,9 +980,9 @@ The DLNA service will only work within your local home network, and isn't remote
</div>
</div>
<div id="outline-container-unnumbered-25" class="outline-3">
<h3 id="unnumbered-25">With Owncloud</h3>
<div class="outline-text-3" id="text-unnumbered-25">
<div id="outline-container-sec-6-2" class="outline-3">
<h3 id="sec-6-2"><span class="section-number-3">6.2</span> With Owncloud</h3>
<div class="outline-text-3" id="text-6-2">
<p>
The main advantage of playing music via Owncloud is that you can do that from anywhere - not only within your home network.
</p>
@ -868,12 +994,12 @@ By default a music player is installed into Owncloud, so all you need to do is t
</div>
</div>
<div id="outline-container-unnumbered-26" class="outline-2">
<h2 id="unnumbered-26">Microblogging</h2>
<div class="outline-text-2" id="text-unnumbered-26">
</div><div id="outline-container-unnumbered-27" class="outline-3">
<h3 id="unnumbered-27">Initial configuration</h3>
<div class="outline-text-3" id="text-unnumbered-27">
<div id="outline-container-sec-7" class="outline-2">
<h2 id="sec-7"><span class="section-number-2">7</span> Microblogging</h2>
<div class="outline-text-2" id="text-7">
</div><div id="outline-container-sec-7-1" class="outline-3">
<h3 id="sec-7-1"><span class="section-number-3">7.1</span> Initial configuration</h3>
<div class="outline-text-3" id="text-7-1">
<p>
To set up your microblog go to:
</p>
@ -924,7 +1050,7 @@ and enter the following settings:
<tr>
<td class="left">DB Password</td>
<td class="left">See the MariaDB password in the <a href="#unnumbered-1">Readme</a> file</td>
<td class="left">See the MariaDB password in the <a href="#sec-1">1</a> file</td>
</tr>
<tr>
@ -934,7 +1060,7 @@ and enter the following settings:
<tr>
<td class="left">Administrator password</td>
<td class="left">See the <a href="#unnumbered-1">Readme</a> file</td>
<td class="left">See the <a href="#sec-1">1</a> file</td>
</tr>
<tr>
@ -981,12 +1107,12 @@ When the install is complete you will see a lot of warnings but just ignore thos
</div>
</div>
</div>
<div id="outline-container-unnumbered-28" class="outline-2">
<h2 id="unnumbered-28">Social Network</h2>
<div class="outline-text-2" id="text-unnumbered-28">
</div><div id="outline-container-unnumbered-29" class="outline-3">
<h3 id="unnumbered-29">Certificates</h3>
<div class="outline-text-3" id="text-unnumbered-29">
<div id="outline-container-sec-8" class="outline-2">
<h2 id="sec-8"><span class="section-number-2">8</span> Social Network</h2>
<div class="outline-text-2" id="text-8">
</div><div id="outline-container-sec-8-1" class="outline-3">
<h3 id="sec-8-1"><span class="section-number-3">8.1</span> Certificates</h3>
<div class="outline-text-3" id="text-8-1">
<p>
You will need to have a non self-signed SSL certificate in order to use Red Matrix. Put the public certificate in <b>/etc/ssl/certs/yourredmatrixdomainname.crt</b> and the private certificate in <b>/etc/ssl/private/yourredmatrixdomainname.key</b>. If there is an intermediate certificate needed (such as with StartSSL) then this will need to be concatenated onto the end of the crt file, like this:
</p>
@ -1003,9 +1129,9 @@ Then change ssl_certificate to <b>/etc/ssl/certs/yourredmatrixdomainname.bundle.
</p>
</div>
</div>
<div id="outline-container-unnumbered-30" class="outline-3">
<h3 id="unnumbered-30">Initial install</h3>
<div class="outline-text-3" id="text-unnumbered-30">
<div id="outline-container-sec-8-2" class="outline-3">
<h3 id="sec-8-2"><span class="section-number-3">8.2</span> Initial install</h3>
<div class="outline-text-3" id="text-8-2">
<p>
Visit the URL of your Red Matrix site and you should be taken through the rest of the installation procedure. Note that this may take a few minutes so don't be concerned if it looks as if it has crashed - just leave it running.
</p>
@ -1016,21 +1142,21 @@ When installation is complete you can register a new user.
</div>
</div>
</div>
<div id="outline-container-unnumbered-31" class="outline-2">
<h2 id="unnumbered-31">Chat Services</h2>
<div class="outline-text-2" id="text-unnumbered-31">
</div><div id="outline-container-unnumbered-32" class="outline-3">
<h3 id="unnumbered-32">IRC</h3>
<div class="outline-text-3" id="text-unnumbered-32">
<div id="outline-container-sec-9" class="outline-2">
<h2 id="sec-9"><span class="section-number-2">9</span> Chat Services</h2>
<div class="outline-text-2" id="text-9">
</div><div id="outline-container-sec-9-1" class="outline-3">
<h3 id="sec-9-1"><span class="section-number-3">9.1</span> IRC</h3>
<div class="outline-text-3" id="text-9-1">
<p>
IRC is useful for multi-user chat. The classic use case is for software development where many engineers might need to coordinate their activities, but it's also useful for meetings, parties and general socialising.
</p>
</div>
<div id="outline-container-unnumbered-33" class="outline-4">
<h4 id="unnumbered-33">Irssi</h4>
<div class="outline-text-4" id="text-unnumbered-33">
<div id="outline-container-sec-9-1-1" class="outline-4">
<h4 id="sec-9-1-1"><span class="section-number-4">9.1.1</span> Irssi</h4>
<div class="outline-text-4" id="text-9-1-1">
<p>
If you are using the <a href="http://www.irssi.org/">irssi</a> IRC client then you can use the following commands to connect to your IRC server.
If you are using the <a href="http://www.irssi.org">irssi</a> IRC client then you can use the following commands to connect to your IRC server.
</p>
<div class="org-src-container">
@ -1042,9 +1168,9 @@ If you are using the <a href="http://www.irssi.org/">irssi</a> IRC client then y
</div>
</div>
</div>
<div id="outline-container-unnumbered-34" class="outline-4">
<h4 id="unnumbered-34">XChat</h4>
<div class="outline-text-4" id="text-unnumbered-34">
<div id="outline-container-sec-9-1-2" class="outline-4">
<h4 id="sec-9-1-2"><span class="section-number-4">9.1.2</span> XChat</h4>
<div class="outline-text-4" id="text-9-1-2">
<p>
If you are using the XChat client:
</p>
@ -1080,12 +1206,12 @@ Click <b>close</b> and then <b>connect</b>.
</div>
</div>
<div id="outline-container-unnumbered-35" class="outline-3">
<h3 id="unnumbered-35">XMPP/Jabber</h3>
<div class="outline-text-3" id="text-unnumbered-35">
</div><div id="outline-container-unnumbered-36" class="outline-4">
<h4 id="unnumbered-36">Managing users</h4>
<div class="outline-text-4" id="text-unnumbered-36">
<div id="outline-container-sec-9-2" class="outline-3">
<h3 id="sec-9-2"><span class="section-number-3">9.2</span> XMPP/Jabber</h3>
<div class="outline-text-3" id="text-9-2">
</div><div id="outline-container-sec-9-2-1" class="outline-4">
<h4 id="sec-9-2-1"><span class="section-number-4">9.2.1</span> Managing users</h4>
<div class="outline-text-4" id="text-9-2-1">
<p>
To add a user:
</p>
@ -1095,8 +1221,8 @@ To add a user:
<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>
exit
exit
</pre>
</div>
@ -1109,8 +1235,8 @@ To change a user password:
<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>
exit
exit
</pre>
</div>
@ -1123,8 +1249,8 @@ To remove a user:
<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>
exit
exit
</pre>
</div>
@ -1137,22 +1263,22 @@ Report the status of the XMPP server:
<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>
exit
exit
</pre>
</div>
</div>
</div>
<div id="outline-container-unnumbered-37" class="outline-4">
<h4 id="unnumbered-37">Using with Jitsi</h4>
<div class="outline-text-4" id="text-unnumbered-37">
<div id="outline-container-sec-9-2-2" class="outline-4">
<h4 id="sec-9-2-2"><span class="section-number-4">9.2.2</span> Using with Jitsi</h4>
<div class="outline-text-4" id="text-9-2-2">
<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>
Jitsi can be downloaded from <a href="https://jitsi.org">https://jitsi.org</a>
</p>
<p>
@ -1176,9 +1302,9 @@ You can also <a href="https://www.youtube.com/watch?v=vgx7VSrDGjk">see this vide
</p>
</div>
</div>
<div id="outline-container-unnumbered-38" class="outline-4">
<h4 id="unnumbered-38">Using with Ubuntu</h4>
<div class="outline-text-4" id="text-unnumbered-38">
<div id="outline-container-sec-9-2-3" class="outline-4">
<h4 id="sec-9-2-3"><span class="section-number-4">9.2.3</span> Using with Ubuntu</h4>
<div class="outline-text-4" id="text-9-2-3">
<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>
@ -1196,9 +1322,9 @@ Click on <b>Advanced</b> and make sure that <b>Encryption required</b> and <b>Ig
</p>
</div>
</div>
<div id="outline-container-unnumbered-39" class="outline-4">
<h4 id="unnumbered-39">Using with Android</h4>
<div class="outline-text-4" id="text-unnumbered-39">
<div id="outline-container-sec-9-2-4" class="outline-4">
<h4 id="sec-9-2-4"><span class="section-number-4">9.2.4</span> Using with Android</h4>
<div class="outline-text-4" id="text-9-2-4">
<p>
Install <a href="https://f-droid.org/">F-Droid</a>
</p>
@ -1228,40 +1354,10 @@ Go back to the initial screen and then using the menu you can add contacts and b
</div>
</div>
<div id="postamble" class="status">
<style type="text/css">
.back-to-top {
position: fixed;
bottom: 2em;
right: 0px;
text-decoration: none;
color: #000000;
background-color: rgba(235, 235, 235, 0.80);
font-size: 12px;
padding: 1em;
display: none;
}
.back-to-top:hover {
background-color: rgba(135, 135, 135, 0.50);
}
</style>
<div class="back-to-top">
<a href="#top">Back to top</a> | <a href="mailto:bob@robotics.uk.to">E-mail me</a>
</div>
<script type="text/javascript">
var offset = 220;
var duration = 500;
jQuery(window).scroll(function() {
if (jQuery(this).scrollTop() > offset) {
jQuery('.back-to-top').fadeIn(duration);
} else {
jQuery('.back-to-top').fadeOut(duration);
}
});
</script>
<p class="author">Author: Bob Mottram</p>
<p class="date">Created: 2014-12-08 Mon 15:20</p>
<p class="creator"><a href="http://www.gnu.org/software/emacs/">Emacs</a> 24.4.1 (<a href="http://orgmode.org">Org</a> mode 8.2.10)</p>
<p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
</div>
</body>
</html>