From 25e9336f19daec281035aa4c507ccc663b6950b8 Mon Sep 17 00:00:00 2001 From: Travis CI Date: Sun, 19 Feb 2017 17:25:41 +0000 Subject: [PATCH] Site updated at 2017-02-19 17:25:40 UTC --- atom.xml | 2 +- blog/categories/community/atom.xml | 2 +- blog/categories/device-tracking/atom.xml | 2 +- blog/categories/esp8266/atom.xml | 2 +- blog/categories/how-to/atom.xml | 2 +- blog/categories/ibeacons/atom.xml | 2 +- blog/categories/internet-of-things/atom.xml | 2 +- blog/categories/iot-data/atom.xml | 2 +- blog/categories/micropython/atom.xml | 2 +- blog/categories/mqtt/atom.xml | 2 +- blog/categories/organisation/atom.xml | 2 +- blog/categories/owntracks/atom.xml | 2 +- blog/categories/presence-detection/atom.xml | 2 +- .../public-service-announcement/atom.xml | 2 +- blog/categories/release-notes/atom.xml | 2 +- blog/categories/survey/atom.xml | 2 +- blog/categories/talks/atom.xml | 2 +- blog/categories/technology/atom.xml | 2 +- blog/categories/user-stories/atom.xml | 2 +- blog/categories/video/atom.xml | 2 +- blog/categories/website/atom.xml | 2 +- cookbook/apache_configuration/index.html | 3 + cookbook/githubbackup/index.html | 3 + cookbook/index.html | 3 + cookbook/owntracks_two_mqtt_broker/index.html | 3 + cookbook/tls_domain_certificate/index.html | 230 ++++++++++++++++++ .../tls_self_signed_certificate/index.html | 3 + cookbook/tor_configuration/index.html | 3 + sitemap.xml | 33 +-- 29 files changed, 287 insertions(+), 36 deletions(-) create mode 100644 cookbook/tls_domain_certificate/index.html diff --git a/atom.xml b/atom.xml index 0c2a7f39f1..a3b653766b 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index 1e597fe7e2..156e686522 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Community | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/device-tracking/atom.xml b/blog/categories/device-tracking/atom.xml index ddfd874d82..867f594225 100644 --- a/blog/categories/device-tracking/atom.xml +++ b/blog/categories/device-tracking/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Device-Tracking | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index cb8de55ca9..6a9c6b3b24 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: ESP8266 | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index dd343ba06f..2407fa7cfc 100644 --- a/blog/categories/how-to/atom.xml +++ b/blog/categories/how-to/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: How-To | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/ibeacons/atom.xml b/blog/categories/ibeacons/atom.xml index 6c6c45dec0..e346349aed 100644 --- a/blog/categories/ibeacons/atom.xml +++ b/blog/categories/ibeacons/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: iBeacons | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/internet-of-things/atom.xml b/blog/categories/internet-of-things/atom.xml index de233ae3e1..03c6e854a6 100644 --- a/blog/categories/internet-of-things/atom.xml +++ b/blog/categories/internet-of-things/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Internet-of-Things | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/iot-data/atom.xml b/blog/categories/iot-data/atom.xml index f26a47e0b5..610eb821cb 100644 --- a/blog/categories/iot-data/atom.xml +++ b/blog/categories/iot-data/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: IoT-Data | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/micropython/atom.xml b/blog/categories/micropython/atom.xml index 162d8c3a3a..11cdf7c645 100644 --- a/blog/categories/micropython/atom.xml +++ b/blog/categories/micropython/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Micropython | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index b319db0e5a..a607dfbc3c 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: MQTT | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/organisation/atom.xml b/blog/categories/organisation/atom.xml index 1c3ba7a556..c9cd7b6c15 100644 --- a/blog/categories/organisation/atom.xml +++ b/blog/categories/organisation/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Organisation | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/owntracks/atom.xml b/blog/categories/owntracks/atom.xml index 1ca00cd733..b6f12147d3 100644 --- a/blog/categories/owntracks/atom.xml +++ b/blog/categories/owntracks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: OwnTracks | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/presence-detection/atom.xml b/blog/categories/presence-detection/atom.xml index ae0420af52..6772e77a10 100644 --- a/blog/categories/presence-detection/atom.xml +++ b/blog/categories/presence-detection/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Presence-Detection | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/public-service-announcement/atom.xml b/blog/categories/public-service-announcement/atom.xml index de9dca0366..c4691e9427 100644 --- a/blog/categories/public-service-announcement/atom.xml +++ b/blog/categories/public-service-announcement/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Public-Service-Announcement | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index 024c9b7696..a3c821dbc7 100644 --- a/blog/categories/release-notes/atom.xml +++ b/blog/categories/release-notes/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Release-Notes | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index e5a77bb16d..5c79ed59de 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Survey | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/talks/atom.xml b/blog/categories/talks/atom.xml index 0a3d788698..358783186f 100644 --- a/blog/categories/talks/atom.xml +++ b/blog/categories/talks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Talks | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/technology/atom.xml b/blog/categories/technology/atom.xml index 55db990b26..3144240c30 100644 --- a/blog/categories/technology/atom.xml +++ b/blog/categories/technology/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Technology | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index fbc2e2be5f..47139ddc33 100644 --- a/blog/categories/user-stories/atom.xml +++ b/blog/categories/user-stories/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: User-Stories | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/video/atom.xml b/blog/categories/video/atom.xml index 34ae60b1bd..2ba60bbd76 100644 --- a/blog/categories/video/atom.xml +++ b/blog/categories/video/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Video | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index cc4a1a3dac..978a29850c 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Website | Home Assistant]]> - 2017-02-19T11:16:44+00:00 + 2017-02-19T17:22:54+00:00 https://home-assistant.io/ diff --git a/cookbook/apache_configuration/index.html b/cookbook/apache_configuration/index.html index f92fe49c6e..fffe8a5a85 100644 --- a/cookbook/apache_configuration/index.html +++ b/cookbook/apache_configuration/index.html @@ -207,6 +207,9 @@ Include conf/extra/hass.conf
  • Apache Configuration
    • +
  • + Certificate for SSL/TLS via domain ownership +
  • Configuration Backup to GitHub
    • diff --git a/cookbook/githubbackup/index.html b/cookbook/githubbackup/index.html index aec5f515e2..4035e3efaf 100644 --- a/cookbook/githubbackup/index.html +++ b/cookbook/githubbackup/index.html @@ -289,6 +289,9 @@ no changes added to commit (use "git add
  • Apache Configuration
    • +
  • + Certificate for SSL/TLS via domain ownership +
  • Configuration Backup to GitHub
    • diff --git a/cookbook/index.html b/cookbook/index.html index adbf4a70cf..524ab68a43 100644 --- a/cookbook/index.html +++ b/cookbook/index.html @@ -233,6 +233,9 @@ A great place to find popular configurations is on this Apache Configuration

    +
  • +

    Certificate for SSL/TLS via domain ownership

    +

  • Configuration Backup to GitHub

    • diff --git a/cookbook/owntracks_two_mqtt_broker/index.html b/cookbook/owntracks_two_mqtt_broker/index.html index 84b04963ff..334f772c8e 100644 --- a/cookbook/owntracks_two_mqtt_broker/index.html +++ b/cookbook/owntracks_two_mqtt_broker/index.html @@ -209,6 +209,9 @@ Fill out
  • Apache Configuration
    • +
  • + Certificate for SSL/TLS via domain ownership +
  • Configuration Backup to GitHub
    • diff --git a/cookbook/tls_domain_certificate/index.html b/cookbook/tls_domain_certificate/index.html new file mode 100644 index 0000000000..81f608278f --- /dev/null +++ b/cookbook/tls_domain_certificate/index.html @@ -0,0 +1,230 @@ + + + + + + + + + + Certificate for SSL/TLS via domain ownership - Home Assistant + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +
    + +
    + + + Home Assistant + +
    + +
    + +
    + +
    +
    +
    + + + +
    +
    + +
    + + +
    + + + + +
    +

    + Certificate for SSL/TLS via Domain Ownership +

    +
    +
    + + +

    If your Home Assistant instance is only accessible from your local network you can still protect the communication between your browsers and the frontend with SSL/TLS. You can use Self-sign certificate but your browser will present a warning and some https-only features might not work.

    + +

    Prerequirement for this guide

    +
      +
    • Your Home Assistant instance is not exposed to the internet. If it is - use this guide
      • +
    • You control a public domain name. The domain doesn’t have to point to a site. A domain controlled by a trusted friend will do. (A friend you trust not to MITM you)
      • +
    • Your home router supports custom DNS entries.
      • +
    + +

    Run certbot

    +
    $ mkdir certbot
+$ cd certbot
+$ wget https://dl.eff.org/certbot-auto
+$ chmod a+x certbot-auto
+$ sudo ./certbot-auto --manual certonly --preferred-challenges dns -d "mydomain.com" --email your@email.address
+
    +
    + +
      +
    • Agree to Terms of Service
      • +
    • Choose whether to share your email with Electronic Frontier Foundation.
      • +
    • Agree to your IP being logged
      • +
    + +

    You will get the following text:

    + +
    Please deploy a DNS TXT record under the name
+_acme-challenge.mydomain.com with the following value:
+
+deadbeefdeadbeefdeadbeefdeadbeefdeadbeef
+
+Once this is deployed,
+-------------------------------------------------------------------------------
+Press Enter to Continue
+
    +
    + +
      +
    • +

      Deploy the value to TXT field using your domain registar.

      +
      • +
    • Go to a site that queries domain record. For example this one and look if it sees your brand new TXT field (Don’t forget to enter the full domain: _acme-challenge.mydomain.com)
      • +
    • Press Enter at certbot prompt.
      • +
    + +

    Make mydomain.com point to your Home Assistant instance

    +

    If your router uses DNSMasq (for example DDWRT) add the following line to DNSMasq options:

    +
    address=/mydomain.com/<hass ip>
+
    +
    + +

    Edit your Home Assistant configuration to use your certificates

    +
    http:
+  api_password: YOUR_SECRET_PASSWORD
+  base_url: https://mydomain.com:8123
+  ssl_certificate: /etc/letsencrypt/live/mydomain.com/fullchain.pem
+  ssl_key: /etc/letsencrypt/live/mydomain.com/privkey.pem
+
    +
    +

    Make sure the files are accessible by the user that runs Home Assistant, eg. homeassistant for a HASSbian setup.

    + + +
    + + +
    + + + + +
    +
    + + + + + + \ No newline at end of file diff --git a/cookbook/tls_self_signed_certificate/index.html b/cookbook/tls_self_signed_certificate/index.html index d77c67eb42..6543c34856 100644 --- a/cookbook/tls_self_signed_certificate/index.html +++ b/cookbook/tls_self_signed_certificate/index.html @@ -135,6 +135,9 @@
  • Apache Configuration
    • +
  • + Certificate for SSL/TLS via domain ownership +
  • Configuration Backup to GitHub
    • diff --git a/cookbook/tor_configuration/index.html b/cookbook/tor_configuration/index.html index 92662e0e9d..256e13ff51 100644 --- a/cookbook/tor_configuration/index.html +++ b/cookbook/tor_configuration/index.html @@ -213,6 +213,9 @@ HiddenServiceAuthorizeClient stealth haremote1
  • Apache Configuration
    • +
  • + Certificate for SSL/TLS via domain ownership +
  • Configuration Backup to GitHub
    • diff --git a/sitemap.xml b/sitemap.xml index a35aa7fc9b..fee61200f9 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -2651,6 +2651,9 @@ https://home-assistant.io/cookbook/automation_telegram_presence_alert/ +https://home-assistant.io/cookbook/tls_domain_certificate/ + + https://home-assistant.io/details/webserver/ @@ -2808,62 +2811,62 @@ https://home-assistant.io/demo/frontend.html -2017-02-19T11:15:55+00:00 +2017-02-19T17:22:06+00:00 https://home-assistant.io/demo/index.html -2017-02-19T11:15:55+00:00 +2017-02-19T17:22:06+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-event.html -2017-02-19T11:15:55+00:00 +2017-02-19T17:22:06+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-info.html -2017-02-19T11:15:55+00:00 +2017-02-19T17:22:06+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-service.html -2017-02-19T11:15:55+00:00 +2017-02-19T17:22:06+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-state.html -2017-02-19T11:15:55+00:00 +2017-02-19T17:22:06+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-template.html -2017-02-19T11:15:55+00:00 +2017-02-19T17:22:06+00:00 https://home-assistant.io/demo/panels/ha-panel-history.html -2017-02-19T11:15:55+00:00 +2017-02-19T17:22:06+00:00 https://home-assistant.io/demo/panels/ha-panel-iframe.html -2017-02-19T11:15:55+00:00 +2017-02-19T17:22:06+00:00 https://home-assistant.io/demo/panels/ha-panel-logbook.html -2017-02-19T11:15:55+00:00 +2017-02-19T17:22:06+00:00 https://home-assistant.io/demo/panels/ha-panel-map.html -2017-02-19T11:15:55+00:00 +2017-02-19T17:22:06+00:00 https://home-assistant.io/googlef4f3693c209fe788.html -2017-02-19T11:15:55+00:00 +2017-02-19T17:22:06+00:00 https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html -2017-02-19T11:15:56+00:00 +2017-02-19T17:22:06+00:00 https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html -2017-02-19T11:15:56+00:00 +2017-02-19T17:22:06+00:00 https://home-assistant.io/static/mdi-demo.html -2017-02-19T11:15:56+00:00 +2017-02-19T17:22:06+00:00