From 9021c1e80152a8284b72e50e70b1dde82f018255 Mon Sep 17 00:00:00 2001 From: Bob Mottram Date: Tue, 23 Feb 2016 11:45:39 +0000 Subject: [PATCH] Update documentation for rss reader --- doc/EN/usage.org | 24 +++++++----------------- website/EN/usage.html | 36 ++++++++++++------------------------ 2 files changed, 19 insertions(+), 41 deletions(-) diff --git a/doc/EN/usage.org b/doc/EN/usage.org index cb4ca773..a322a10d 100644 --- a/doc/EN/usage.org +++ b/doc/EN/usage.org @@ -324,30 +324,20 @@ Selecting the server by pressing on it then connects you to the server so that y Freedombone also supports SIP phones The username and domain is the same as for your email address, and the SIP password and extension number will appear within the README file in your home directory. Various SIP client options are available, such as CSipSimple on Android and Jitsi on desktop or laptop machines. Ideally use clients which support ZRTP, which will provide the best level of security. * RSS Reader -If you check the readme file within your home directory then you will be able to find out the onion address for the RSS reader which exists on most variants of Freedombone. The address can also be found on the control panel About screen. +The way that RSS reading is set up on Freedombone gives you strong reading privacy. Not only is there onion routing between you and the server but also between the server and the source of the RSS feed. The only down side is that many RSS feeds are still http only, and so could be vulnerable to injection attacks, but it's expected that more of this will go to https in the foreseeable future due to a combination of growing recognition of security issues and systems like Let's Encrypt which make obtaining certificates much easier. + +See the control panel for the RSS reader onion address. #+BEGIN_SRC bash ssh username@domainname -p 2222 -emacs README -exit +sudo control #+END_SRC +Then select the *About* screen. + The RSS reader is accessible only via an onion address. This provides a reasonable degree of reading privacy, making it difficult for passive adversaries such as governments or corporations to create lists of sites which you are subscribed to. -To set up the system open http://rss_reader_onion_address/ and enter: - - * Database type: MySQL - * Username: root - * Password: [MariaDB database root password] - * Database name: ttrss - * Host name: localhost - * Port: 3306 - * Tiny Tint RSS URL: http://rss_reader_onion_address/ - -Click *Test configuration* and then *Initialize database*. You may need to click *Save configuration*. -Initially log in with username *admin* and password *password*. - -Then go to *Preferences/Users*, click on the *admin* user and then change the password. You will immediately see what looks like an authorisation error, so log out and log back in with username "admin" and your new password. +To set up the system open http://rss_reader_onion_address/. Initially log in with username *admin* and password *password*. Then go to *Preferences/Users*, click on the *admin* user and then change the password. You will immediately see what looks like an authorisation error, so log out and log back in with username "admin" and your new password. To access the RSS reader from a mobile device you can install a Tor compatible browser such as [[https://f-droid.org/wiki/page/info.guardianproject.orfox][OrFox]]. It will try to automatically change to the mobile version of the user interface, but if that doesn't work then navigate to http://rss_reader_onion_address/mobile. diff --git a/website/EN/usage.html b/website/EN/usage.html index 66512c45..03b978d0 100644 --- a/website/EN/usage.html +++ b/website/EN/usage.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + @@ -858,42 +858,30 @@ Freedombone also supports SIP phones The username and domain is the same as for

RSS Reader

-If you check the readme file within your home directory then you will be able to find out the onion address for the RSS reader which exists on most variants of Freedombone. The address can also be found on the control panel About screen. +The way that RSS reading is set up on Freedombone gives you strong reading privacy. Not only is there onion routing between you and the server but also between the server and the source of the RSS feed. The only down side is that many RSS feeds are still http only, and so could be vulnerable to injection attacks, but it's expected that more of this will go to https in the foreseeable future due to a combination of growing recognition of security issues and systems like Let's Encrypt which make obtaining certificates much easier. +

+ +

+See the control panel for the RSS reader onion address. 

ssh username@domainname -p 2222
-emacs README
-exit
+sudo control
+

+Then select the About screen. +

+

The RSS reader is accessible only via an onion address. This provides a reasonable degree of reading privacy, making it difficult for passive adversaries such as governments or corporations to create lists of sites which you are subscribed to.

-To set up the system open http://rss_reader_onion_address/ and enter: -

- - - -

-Click Test configuration and then Initialize database. You may need to click Save configuration. -Initially log in with username admin and password password. -

- -

-Then go to Preferences/Users, click on the admin user and then change the password. You will immediately see what looks like an authorisation error, so log out and log back in with username "admin" and your new password. +To set up the system open http://rss_reader_onion_address/. Initially log in with username admin and password password. Then go to Preferences/Users, click on the admin user and then change the password. You will immediately see what looks like an authorisation error, so log out and log back in with username "admin" and your new password.