From ab3772913cc4d27e3e501672a6ea60c1a7df3903 Mon Sep 17 00:00:00 2001 From: David De Sloovere Date: Sat, 25 Nov 2017 14:41:05 +0100 Subject: [PATCH 1/8] Fix HTML5 notify domain verification instructions Didn't say you need to restart. Can't get the internal link working --- source/_components/notify.html5.markdown | 24 ++++++++++++++---------- 1 file changed, 14 insertions(+), 10 deletions(-) diff --git a/source/_components/notify.html5.markdown b/source/_components/notify.html5.markdown index 34547169778..52f800e9a7f 100644 --- a/source/_components/notify.html5.markdown +++ b/source/_components/notify.html5.markdown @@ -33,19 +33,23 @@ Configuration variables: ### {% linkable_title Getting ready for Chrome %} -1. Create new project at [https://console.cloud.google.com/home/dashboard](https://console.cloud.google.com/home/dashboard). -2. Go to [https://console.cloud.google.com/apis/credentials/domainverification](https://console.cloud.google.com/apis/credentials/domainverification) and verify your domain. -3. After that, go to [https://console.firebase.google.com](https://console.firebase.google.com) and select import Google project, select the project you created. -4. Then, click the cogwheel on top left and select "Project settings". -5. Select 'Cloud Messaging' tab, listed beneath Project Credentials will be your 152 character 'Server Key' and 12 digit ID 'Sender ID'. +1. Make sure you can access your Home Assistant installation from outside your network over https ([see docs](https://home-assistant.io/docs/configuration/remote/)). +2. Create a new project at [https://console.cloud.google.com/home/dashboard](https://console.cloud.google.com/home/dashboard). +3. Go to [https://console.cloud.google.com/apis/credentials/domainverification](https://console.cloud.google.com/apis/credentials/domainverification) and verify your domain via Google Webmaster Central / Search Console - [hass.io instructions](#verify-your-domain-with-hassio). +4. With the domain verified, go to [https://console.firebase.google.com](https://console.firebase.google.com), select import Google project, and select the project you created. +5. Then, click the cogwheel on top left and select "Project settings". +6. Select 'Cloud Messaging' tab, listed beneath Project Credentials will be your 152 character 'Server Key' and 12 digit ID 'Sender ID'. #### {% linkable_title Verify your domain with Hass.io %} -1. For verifying your domain you need to download a file in step 2. -2. Create a dictionary named "www" in you Hass.io configuration dictionary. -3. Place the file (something like this: google*.html) in the "www" directory. -4. You can open it by going to **https://yourdomain/local/exact_file_name.html** -5. Proceed with step 3. +Follow these steps to verify domain ownership with Google Webmaster Central / Search Console: +1. Enter your domain and add **'/local'** at the end, ie. https://whitehouse.duckdns.org:8123/local +2. Select HTML file verification and download the google*.html file. +2. Create a directory named "www" in your Hass.io configuration directory (/config share from Samba add-on). +3. Place the downloaded google*.html file in the "www" directory. +4. RESTART Home Assistant - this is important! +5. Verify the file can be accessed in the browser, ie. **https://whitehouse.duckdns.org:8123/local/goole123456789.html** (change filename) - you should a plain text message saying "google-site-verification: ..." - if you see "404: Not Found" or something else, retry the above steps. +6. Go back to Google Webmaster Central / Search Console and proceed with the verification. ### {% linkable_title Requirements %} From 27bf0fa0b4a9bcac972a7cd6fe97e28cd19af6bf Mon Sep 17 00:00:00 2001 From: David De Sloovere Date: Sat, 25 Nov 2017 14:44:15 +0100 Subject: [PATCH 2/8] update on requirements --- source/_components/notify.html5.markdown | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/source/_components/notify.html5.markdown b/source/_components/notify.html5.markdown index 52f800e9a7f..2b75901d10c 100644 --- a/source/_components/notify.html5.markdown +++ b/source/_components/notify.html5.markdown @@ -54,12 +54,11 @@ Follow these steps to verify domain ownership with Google Webmaster Central / Se ### {% linkable_title Requirements %} The `html5` platform can only function if all of the following requirements are met: -(On Hass.io these requirements are already met.) * You are using Chrome and/or Firefox on any desktop platform, ChromeOS or Android. * Your Home Assistant instance is exposed to the world. * If using a proxy, HTTP basic authentication must be off for registering or unregistering for push notifications. It can be re-enabled afterwards. -* `pywebpush` must be installed. `libffi-dev`, `libpython-dev`, and `libssl-dev` must be installed prior to `pywebpush` (i.e. `pywebpush` probably won't automatically install). +* If you don't run Hass.io: `pywebpush` must be installed. `libffi-dev`, `libpython-dev`, and `libssl-dev` must be installed prior to `pywebpush` (i.e. `pywebpush` probably won't automatically install). * You have configured SSL for your Home Assistant. It doesn't need to be configured in Home Assistant though, i.e. you can be running [NGINX](/ecosystem/nginx/) in front of Home Assistant and this will still work. The certificate must be trustworthy (i.e. not self signed). * You are willing to accept the notification permission in your browser. From 52cb747bdef1a9b0ff404ff6b80acfec3c0e0f8f Mon Sep 17 00:00:00 2001 From: David De Sloovere Date: Sat, 25 Nov 2017 14:48:34 +0100 Subject: [PATCH 3/8] Update notify.html5.markdown --- source/_components/notify.html5.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/notify.html5.markdown b/source/_components/notify.html5.markdown index 2b75901d10c..8331ad249fd 100644 --- a/source/_components/notify.html5.markdown +++ b/source/_components/notify.html5.markdown @@ -38,7 +38,7 @@ Configuration variables: 3. Go to [https://console.cloud.google.com/apis/credentials/domainverification](https://console.cloud.google.com/apis/credentials/domainverification) and verify your domain via Google Webmaster Central / Search Console - [hass.io instructions](#verify-your-domain-with-hassio). 4. With the domain verified, go to [https://console.firebase.google.com](https://console.firebase.google.com), select import Google project, and select the project you created. 5. Then, click the cogwheel on top left and select "Project settings". -6. Select 'Cloud Messaging' tab, listed beneath Project Credentials will be your 152 character 'Server Key' and 12 digit ID 'Sender ID'. +6. Select 'Cloud Messaging' tab, listed beneath Project Credentials will be your 152 character 'Server Key' and 12 digit ID 'Sender ID' you need for configuring this component. #### {% linkable_title Verify your domain with Hass.io %} From 5d5dc9c0d6ffcad0de544aabe018f96444c6b15e Mon Sep 17 00:00:00 2001 From: David De Sloovere Date: Mon, 29 Jan 2018 08:14:19 +0100 Subject: [PATCH 4/8] Change hassio to Home Assistant --- source/_components/notify.html5.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_components/notify.html5.markdown b/source/_components/notify.html5.markdown index 8bf9a4c528e..4f96f0707c8 100644 --- a/source/_components/notify.html5.markdown +++ b/source/_components/notify.html5.markdown @@ -35,17 +35,17 @@ Configuration variables: 1. Make sure you can access your Home Assistant installation from outside your network over https ([see docs](https://home-assistant.io/docs/configuration/remote/)). 2. Create a new project at [https://console.cloud.google.com/home/dashboard](https://console.cloud.google.com/home/dashboard). -3. Go to [https://console.cloud.google.com/apis/credentials/domainverification](https://console.cloud.google.com/apis/credentials/domainverification) and verify your domain via Google Webmaster Central / Search Console - [hass.io instructions](#verify-your-domain-with-hassio). +3. Go to [https://console.cloud.google.com/apis/credentials/domainverification](https://console.cloud.google.com/apis/credentials/domainverification) and verify your domain via Google Webmaster Central / Search Console - [hass.io instructions](#verify-your-domain-with-home-assistant). 4. With the domain verified, go to [https://console.firebase.google.com](https://console.firebase.google.com), select import Google project, and select the project you created. 5. Then, click the cogwheel on top left and select "Project settings". 6. Select 'Cloud Messaging' tab, listed beneath Project Credentials will be your 152 character 'Server Key' and 12 digit ID 'Sender ID' you need for configuring this component. -#### {% linkable_title Verify your domain with Hass.io %} +#### {% linkable_title Verify your domain with Home Assistant %} Follow these steps to verify domain ownership with Google Webmaster Central / Search Console: 1. Enter your domain and add **'/local'** at the end, ie. https://whitehouse.duckdns.org:8123/local 2. Select HTML file verification and download the google*.html file. -2. Create a directory named "www" in your Hass.io configuration directory (/config share from Samba add-on). +2. Create a directory named "www" in your Home Assistant configuration directory (/config share from Samba add-on). 3. Place the downloaded google*.html file in the "www" directory. 4. RESTART Home Assistant - this is important! 5. Verify the file can be accessed in the browser, ie. **https://whitehouse.duckdns.org:8123/local/goole123456789.html** (change filename) - you should a plain text message saying "google-site-verification: ..." - if you see "404: Not Found" or something else, retry the above steps. From a71800bcbaeba5a98b18ddfc726639532c4e168d Mon Sep 17 00:00:00 2001 From: David De Sloovere Date: Mon, 29 Jan 2018 08:15:04 +0100 Subject: [PATCH 5/8] Update notify.html5.markdown --- source/_components/notify.html5.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/notify.html5.markdown b/source/_components/notify.html5.markdown index 4f96f0707c8..f506eb18872 100644 --- a/source/_components/notify.html5.markdown +++ b/source/_components/notify.html5.markdown @@ -35,7 +35,7 @@ Configuration variables: 1. Make sure you can access your Home Assistant installation from outside your network over https ([see docs](https://home-assistant.io/docs/configuration/remote/)). 2. Create a new project at [https://console.cloud.google.com/home/dashboard](https://console.cloud.google.com/home/dashboard). -3. Go to [https://console.cloud.google.com/apis/credentials/domainverification](https://console.cloud.google.com/apis/credentials/domainverification) and verify your domain via Google Webmaster Central / Search Console - [hass.io instructions](#verify-your-domain-with-home-assistant). +3. Go to [https://console.cloud.google.com/apis/credentials/domainverification](https://console.cloud.google.com/apis/credentials/domainverification) and verify your domain via Google Webmaster Central / Search Console - [instructions](#verify-your-domain-with-home-assistant). 4. With the domain verified, go to [https://console.firebase.google.com](https://console.firebase.google.com), select import Google project, and select the project you created. 5. Then, click the cogwheel on top left and select "Project settings". 6. Select 'Cloud Messaging' tab, listed beneath Project Credentials will be your 152 character 'Server Key' and 12 digit ID 'Sender ID' you need for configuring this component. From 5da84711b4e746ffec5b53a44ca6a64214b9aa80 Mon Sep 17 00:00:00 2001 From: David De Sloovere Date: Mon, 29 Jan 2018 08:16:40 +0100 Subject: [PATCH 6/8] Update notify.html5.markdown --- source/_components/notify.html5.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/notify.html5.markdown b/source/_components/notify.html5.markdown index f506eb18872..f53d7dc74af 100644 --- a/source/_components/notify.html5.markdown +++ b/source/_components/notify.html5.markdown @@ -35,12 +35,12 @@ Configuration variables: 1. Make sure you can access your Home Assistant installation from outside your network over https ([see docs](https://home-assistant.io/docs/configuration/remote/)). 2. Create a new project at [https://console.cloud.google.com/home/dashboard](https://console.cloud.google.com/home/dashboard). -3. Go to [https://console.cloud.google.com/apis/credentials/domainverification](https://console.cloud.google.com/apis/credentials/domainverification) and verify your domain via Google Webmaster Central / Search Console - [instructions](#verify-your-domain-with-home-assistant). +3. Go to [https://console.cloud.google.com/apis/credentials/domainverification](https://console.cloud.google.com/apis/credentials/domainverification) and verify your domain via Google Webmaster Central / Search Console - [instructions](#verify-your-domain). 4. With the domain verified, go to [https://console.firebase.google.com](https://console.firebase.google.com), select import Google project, and select the project you created. 5. Then, click the cogwheel on top left and select "Project settings". 6. Select 'Cloud Messaging' tab, listed beneath Project Credentials will be your 152 character 'Server Key' and 12 digit ID 'Sender ID' you need for configuring this component. -#### {% linkable_title Verify your domain with Home Assistant %} +#### {% linkable_title Verify your domain %} Follow these steps to verify domain ownership with Google Webmaster Central / Search Console: 1. Enter your domain and add **'/local'** at the end, ie. https://whitehouse.duckdns.org:8123/local From 6c9bacf74052e34bc910274f43033dcce6ac30cd Mon Sep 17 00:00:00 2001 From: David De Sloovere Date: Tue, 30 Jan 2018 08:06:53 +0100 Subject: [PATCH 7/8] Change domain Use an official IANA example domain: example.com - which nobody owns (except IANA) --- source/_components/notify.html5.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/notify.html5.markdown b/source/_components/notify.html5.markdown index f53d7dc74af..e43d99aa349 100644 --- a/source/_components/notify.html5.markdown +++ b/source/_components/notify.html5.markdown @@ -43,12 +43,12 @@ Configuration variables: #### {% linkable_title Verify your domain %} Follow these steps to verify domain ownership with Google Webmaster Central / Search Console: -1. Enter your domain and add **'/local'** at the end, ie. https://whitehouse.duckdns.org:8123/local +1. Enter your domain and add **'/local'** at the end, ie. https://example.com:8123/local 2. Select HTML file verification and download the google*.html file. 2. Create a directory named "www" in your Home Assistant configuration directory (/config share from Samba add-on). 3. Place the downloaded google*.html file in the "www" directory. 4. RESTART Home Assistant - this is important! -5. Verify the file can be accessed in the browser, ie. **https://whitehouse.duckdns.org:8123/local/goole123456789.html** (change filename) - you should a plain text message saying "google-site-verification: ..." - if you see "404: Not Found" or something else, retry the above steps. +5. Verify the file can be accessed in the browser, ie. **https://example.com:8123/local/goole123456789.html** (change filename) - you should a plain text message saying "google-site-verification: ..." - if you see "404: Not Found" or something else, retry the above steps. 6. Go back to Google Webmaster Central / Search Console and proceed with the verification. ### {% linkable_title Requirements %} From 1c4f1dc13d031e9e10bb1df0b928b8a67d97af0f Mon Sep 17 00:00:00 2001 From: David De Sloovere Date: Tue, 30 Jan 2018 08:07:23 +0100 Subject: [PATCH 8/8] fix typo --- source/_components/notify.html5.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/notify.html5.markdown b/source/_components/notify.html5.markdown index e43d99aa349..5081ff20138 100644 --- a/source/_components/notify.html5.markdown +++ b/source/_components/notify.html5.markdown @@ -48,7 +48,7 @@ Follow these steps to verify domain ownership with Google Webmaster Central / Se 2. Create a directory named "www" in your Home Assistant configuration directory (/config share from Samba add-on). 3. Place the downloaded google*.html file in the "www" directory. 4. RESTART Home Assistant - this is important! -5. Verify the file can be accessed in the browser, ie. **https://example.com:8123/local/goole123456789.html** (change filename) - you should a plain text message saying "google-site-verification: ..." - if you see "404: Not Found" or something else, retry the above steps. +5. Verify the file can be accessed in the browser, ie. **https://example.com:8123/local/google123456789.html** (change filename) - you should a plain text message saying "google-site-verification: ..." - if you see "404: Not Found" or something else, retry the above steps. 6. Go back to Google Webmaster Central / Search Console and proceed with the verification. ### {% linkable_title Requirements %}