jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Site updated at 2016-08-22 08:21:42 UTC

Browse source
This commit is contained in:
Travis CI 2016-08-22 08:21:43 +00:00
parent f9d65cbe57
commit 4acb07bf8e
559 changed files with 18878 additions and 21688 deletions
Download patch file Download diff file Expand all files Collapse all files

52
cookbook/tor_configuration/index.html
View file

@ -106,7 +106,7 @@
<p>You can learn more about how Tor can be used to secure home automation and IoT platforms through this short set of slides on the <a href="https://github.com/n8fr8/talks/blob/master/onion_things/Internet%20of%20Onion%20Things.pdf">Internet of Onion Things</a></p>
<p>This configuration was provided by @n8fr8 (<a href="https://github.com/n8fr8">github</a>, <a href="https://twitter.com/n8fr8">twitter</a>) of the <a href="https://guardianproject.info">Guardian Project</a> and <a href="https://torproject.org">Tor Project</a>. You can send questions, feedback and ideas to <a href="&#109;&#097;&#105;&#108;&#116;&#111;:&#115;&#117;&#112;&#112;&#111;&#114;&#116;&#064;&#103;&#117;&#097;&#114;&#100;&#105;&#097;&#110;&#112;&#114;&#111;&#106;&#101;&#099;&#116;&#046;&#105;&#110;&#102;&#111;">&#115;&#117;&#112;&#112;&#111;&#114;&#116;&#064;&#103;&#117;&#097;&#114;&#100;&#105;&#097;&#110;&#112;&#114;&#111;&#106;&#101;&#099;&#116;&#046;&#105;&#110;&#102;&#111;</a>.</p>
<p>This configuration was provided by @n8fr8 (<a href="https://github.com/n8fr8">github</a>, <a href="https://twitter.com/n8fr8">twitter</a>) of the <a href="https://guardianproject.info">Guardian Project</a> and <a href="https://torproject.org">Tor Project</a>. You can send questions, feedback and ideas to <a href="mailto:support@guardianproject.info">support@guardianproject.info</a>.</p>
<h4><a class="title-link" name="hidden-services-and-onion-sites" href="#hidden-services-and-onion-sites"></a> Hidden Services and Onion Sites</h4>
@ -118,55 +118,45 @@
<p>First, install Tor. On a Debain-based system, you can install the package easily:</p>
<div class="highlighter-coderay"><div class="CodeRay">
<div class="code"><pre>$ sudo apt-get install tor
</pre></div>
</div>
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>sudo apt-get install tor
</code></pre>
</div>
<p>You can find more instructions for downloading and installing Tor on other platforms on the <a href="https://www.torproject.org/download/download.html">Tor Project Download Page</a>.</p>
<p>Next, modify Tor’s main configuration file <code>/etc/tor/torrc</code> to include the following lines:</p>
<p>Next, modify Tor’s main configuration file <code class="highlighter-rouge">/etc/tor/torrc</code> to include the following lines:</p>
<div class="highlighter-coderay"><div class="CodeRay">
<div class="code"><pre>############### This section is just for location-hidden services ###
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="c">############### This section is just for location-hidden services ###</span>
## Once you have configured a hidden service, you can look at the
## contents of the file &quot;.../hidden_service/hostname&quot; for the address
## to tell people.
<span class="c">## Once you have configured a hidden service, you can look at the</span>
<span class="c">## contents of the file ".../hidden_service/hostname" for the address</span>
<span class="c">## to tell people.</span>
...
HiddenServiceDir /var/lib/tor/homeassistant/
HiddenServicePort 80 127.0.0.1:8123
HiddenServiceAuthorizeClient stealth haremote1
...
</pre></div>
</div>
</code></pre>
</div>
<p>The “stealth” entry above ensures traffic to and from your Home Assistant instance over Tor, is hidden even from other nodes on the Tor network. The <code>haremote1</code> value is a generic client name entry that you can modify as you please.</p>
<p>The “stealth” entry above ensures traffic to and from your Home Assistant instance over Tor, is hidden even from other nodes on the Tor network. The <code class="highlighter-rouge">haremote1</code> value is a generic client name entry that you can modify as you please.</p>
<p>Then, restart Tor:</p>
<div class="highlighter-coderay"><div class="CodeRay">
<div class="code"><pre>$ sudo /etc/init.d/tor restart
</pre></div>
</div>
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>sudo /etc/init.d/tor restart
</code></pre>
</div>
<p>Then read the new generated authentication cookie from the Tor-generated hostname file:</p>
<div class="highlighter-coderay"><div class="CodeRay">
<div class="code"><pre>$ sudo more /var/lib/tor/homeassistant/hostname
</pre></div>
</div>
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>sudo more /var/lib/tor/homeassistant/hostname
</code></pre>
</div>
<p>The output of that command should look something like this, but with your own unique “dot onion” domain and authentication cookie:</p>
<div class="highlighter-coderay"><div class="CodeRay">
<div class="code"><pre>abcdef1234567890.onion ABCDEF1122334455667789 # client: haremote1
</pre></div>
</div>
<div class="language-bash highlighter-rouge"><pre class="highlight"><code>abcdef1234567890.onion ABCDEF1122334455667789 <span class="c"># client: haremote1</span>
</code></pre>
</div>
<p>You are now done with the Home Assistant Tor server configuration. Make sure your Home Assistant instance is running, and now you can move to client configuration.</p>
@ -175,15 +165,13 @@ HiddenServiceAuthorizeClient stealth haremote1
<p>Using this setup, you can access your Home Assistant instance over Tor from your laptop or mobile device, using Tor Browser and other software.</p>
<p>Add the authentication cookie to your <code>torrc</code> client configuration on your laptop or mobile device. Using the sample values from above, it would look like this:</p>
<p>Add the authentication cookie to your <code class="highlighter-rouge">torrc</code> client configuration on your laptop or mobile device. Using the sample values from above, it would look like this:</p>
<div class="highlighter-coderay"><div class="CodeRay">
<div class="code"><pre>HidServAuth abcdef1234567890.onion ABCDEF1122334455667789
</pre></div>
</div>
<div class="language-bash highlighter-rouge"><pre class="highlight"><code>HidServAuth abcdef1234567890.onion ABCDEF1122334455667789
</code></pre>
</div>
<p>For Tor Browser on Windows, Mac or Linux, you can find the torrc file here: <code>&lt;tor browser install directory&gt;/Browser/TorBrowser/Data/Tor/torrc-defaults</code></p>
<p>For Tor Browser on Windows, Mac or Linux, you can find the torrc file here: <code class="highlighter-rouge">&lt;tor browser install directory&gt;/Browser/TorBrowser/Data/Tor/torrc-defaults</code></p>
<p>Once you have added the entry, restart the browser, and then browse to the “dot onion” site address to connect to your Home Assistant instance.</p>