From 245c98b121f2fceb18da9adf06169d879be23847 Mon Sep 17 00:00:00 2001 From: Marty Cochrane Date: Mon, 15 Mar 2021 14:14:07 +0100 Subject: [PATCH 01/13] Update verisure documentation for 2fa bug --- source/_integrations/verisure.markdown | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/source/_integrations/verisure.markdown b/source/_integrations/verisure.markdown index 97a90b73d591..9c431ea40838 100644 --- a/source/_integrations/verisure.markdown +++ b/source/_integrations/verisure.markdown @@ -138,3 +138,16 @@ automation: | disable_autolock | Disables autolock function for a specific lock. | | enable_autolock | Enables autolock function for a specific lock. | | smartcam_capture | Capture a new image from a specific smartcam. | + +## 2 Factor Authentication Workaround + +In March 2021 Verisure added new 2fa rules that aren't fully support through their third party API integration. If you have 2FA enabled (which is forced as default) You might not be able to use this integration. Here are some steps for a work around. + +1. Create a specific home assistant user. (not necessary but it's not recommended to turn of 2fa for your admin user). +2. Make sure that user is admin, you've logged in & setup 2fa +3. Login as the home assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2fa + + **Note this will only be available if the user is admin and has logged in once with 2fa, logged out and in again** +4. Login as your administrator again and change the home assistant user to a restricted user +5. Change home assistant verisure config to the new user credentials in home assistant +6. Restart home assistant From a72c7bf13bd4d146a532aba9bc220430f2ac66db Mon Sep 17 00:00:00 2001 From: Marty Cochrane Date: Mon, 15 Mar 2021 14:38:30 +0100 Subject: [PATCH 02/13] fixed textlint suggestions --- source/_integrations/verisure.markdown | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/source/_integrations/verisure.markdown b/source/_integrations/verisure.markdown index 9c431ea40838..9f4d2ab54352 100644 --- a/source/_integrations/verisure.markdown +++ b/source/_integrations/verisure.markdown @@ -141,13 +141,13 @@ automation: ## 2 Factor Authentication Workaround -In March 2021 Verisure added new 2fa rules that aren't fully support through their third party API integration. If you have 2FA enabled (which is forced as default) You might not be able to use this integration. Here are some steps for a work around. +In March 2021 Verisure added new 2FA rules that aren't fully support through their third party API integration. If you have 2FA enabled (which is forced as default) You might not be able to use this integration. Here are some steps for a work around. -1. Create a specific home assistant user. (not necessary but it's not recommended to turn of 2fa for your admin user). -2. Make sure that user is admin, you've logged in & setup 2fa -3. Login as the home assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2fa +1. Create a specific Home Assistant user. (not necessary but it's not recommended to turn of 2FA for your admin user). +2. Make sure that user is admin, you've logged in & setup 2FA +3. Login as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA - **Note this will only be available if the user is admin and has logged in once with 2fa, logged out and in again** -4. Login as your administrator again and change the home assistant user to a restricted user -5. Change home assistant verisure config to the new user credentials in home assistant -6. Restart home assistant + **Note this will only be available if the user is admin and has logged in once with 2FA, logged out and in again** +4. Login as your administrator again and change the Home Assistant user to a restricted user +5. Change Home Assistant Verisure config to the new user credentials in Home Assistant +6. Restart Home Assistant From 1451aa47c8f3ba50328504cac3e95977c78dc684 Mon Sep 17 00:00:00 2001 From: Marty Cochrane Date: Mon, 15 Mar 2021 15:08:32 +0100 Subject: [PATCH 03/13] Full stops on list items --- source/_integrations/verisure.markdown | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source/_integrations/verisure.markdown b/source/_integrations/verisure.markdown index 9f4d2ab54352..ae6b96384038 100644 --- a/source/_integrations/verisure.markdown +++ b/source/_integrations/verisure.markdown @@ -144,10 +144,10 @@ automation: In March 2021 Verisure added new 2FA rules that aren't fully support through their third party API integration. If you have 2FA enabled (which is forced as default) You might not be able to use this integration. Here are some steps for a work around. 1. Create a specific Home Assistant user. (not necessary but it's not recommended to turn of 2FA for your admin user). -2. Make sure that user is admin, you've logged in & setup 2FA -3. Login as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA +2. Make sure that user is admin, you've logged in & setup 2FA. +3. Login as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA. **Note this will only be available if the user is admin and has logged in once with 2FA, logged out and in again** -4. Login as your administrator again and change the Home Assistant user to a restricted user -5. Change Home Assistant Verisure config to the new user credentials in Home Assistant -6. Restart Home Assistant +4. Login as your administrator again and change the Home Assistant user to a restricted user. +5. Change Home Assistant Verisure config to the new user credentials in Home Assistant. +6. Restart Home Assistant. From 060b5b8d10ccc8b2f096c3ef03bc7af220ac9a7d Mon Sep 17 00:00:00 2001 From: Marty Cochrane Date: Mon, 15 Mar 2021 15:16:32 +0100 Subject: [PATCH 04/13] Changed title & Removed data --- source/_integrations/verisure.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/verisure.markdown b/source/_integrations/verisure.markdown index ae6b96384038..d42609c2c97d 100644 --- a/source/_integrations/verisure.markdown +++ b/source/_integrations/verisure.markdown @@ -139,9 +139,9 @@ automation: | enable_autolock | Enables autolock function for a specific lock. | | smartcam_capture | Capture a new image from a specific smartcam. | -## 2 Factor Authentication Workaround +## 2 Factor Authentication -In March 2021 Verisure added new 2FA rules that aren't fully support through their third party API integration. If you have 2FA enabled (which is forced as default) You might not be able to use this integration. Here are some steps for a work around. +Verisure added 2FA rules to Verisure mypages that aren't supported through their third party API integration. If you have 2FA enabled (which is forced as default) You might not be able to use this integration. Here is the suggested way to use deactivate 2FA if it's allowed in your region. 1. Create a specific Home Assistant user. (not necessary but it's not recommended to turn of 2FA for your admin user). 2. Make sure that user is admin, you've logged in & setup 2FA. From 33dfd7abd2b534b103aebf7a3a98dc3821de9ad2 Mon Sep 17 00:00:00 2001 From: Marty Cochrane Date: Mon, 15 Mar 2021 15:19:49 +0100 Subject: [PATCH 05/13] Changed title and location --- source/_integrations/verisure.markdown | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/source/_integrations/verisure.markdown b/source/_integrations/verisure.markdown index d42609c2c97d..8195188f134e 100644 --- a/source/_integrations/verisure.markdown +++ b/source/_integrations/verisure.markdown @@ -104,6 +104,20 @@ giid: type: string {% endconfiguration %} +## 2 Factor Authentication Prerequisite + +Verisure added 2FA rules to Verisure mypages that aren't supported through their third party API integration. If you have 2FA enabled (which is forced as default) You might not be able to use this integration. Here is the suggested way to use deactivate 2FA if it's allowed in your region. + +1. Create a specific Home Assistant user. (not necessary but it's not recommended to turn of 2FA for your admin user). +2. Make sure that user is admin, you've logged in & setup 2FA. +3. Login as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA. + + **Note this will only be available if the user is admin and has logged in once with 2FA, logged out and in again** +4. Login as your administrator again and change the Home Assistant user to a restricted user. +5. Change Home Assistant Verisure config to the new user credentials in Home Assistant. +6. Restart Home Assistant. + + ## Alarm Control Panel The Verisure alarm control panel platform allows you to control your [Verisure](https://www.verisure.com/) Alarms. @@ -139,15 +153,3 @@ automation: | enable_autolock | Enables autolock function for a specific lock. | | smartcam_capture | Capture a new image from a specific smartcam. | -## 2 Factor Authentication - -Verisure added 2FA rules to Verisure mypages that aren't supported through their third party API integration. If you have 2FA enabled (which is forced as default) You might not be able to use this integration. Here is the suggested way to use deactivate 2FA if it's allowed in your region. - -1. Create a specific Home Assistant user. (not necessary but it's not recommended to turn of 2FA for your admin user). -2. Make sure that user is admin, you've logged in & setup 2FA. -3. Login as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA. - - **Note this will only be available if the user is admin and has logged in once with 2FA, logged out and in again** -4. Login as your administrator again and change the Home Assistant user to a restricted user. -5. Change Home Assistant Verisure config to the new user credentials in Home Assistant. -6. Restart Home Assistant. From c43e37e1c1fe0b794c748a14ced47f2d20cb1fed Mon Sep 17 00:00:00 2001 From: Marty Cochrane Date: Mon, 15 Mar 2021 15:25:12 +0100 Subject: [PATCH 06/13] Added details about why to create a new user --- source/_integrations/verisure.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/_integrations/verisure.markdown b/source/_integrations/verisure.markdown index 8195188f134e..fa45695db06e 100644 --- a/source/_integrations/verisure.markdown +++ b/source/_integrations/verisure.markdown @@ -108,6 +108,8 @@ giid: Verisure added 2FA rules to Verisure mypages that aren't supported through their third party API integration. If you have 2FA enabled (which is forced as default) You might not be able to use this integration. Here is the suggested way to use deactivate 2FA if it's allowed in your region. +You can deactivate 2FA for your admin account and use that for Home Assistant but this isn't recommended. The steps below sets up a specific Home Assistant user and gives it restricted access. + 1. Create a specific Home Assistant user. (not necessary but it's not recommended to turn of 2FA for your admin user). 2. Make sure that user is admin, you've logged in & setup 2FA. 3. Login as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA. @@ -152,4 +154,3 @@ automation: | disable_autolock | Disables autolock function for a specific lock. | | enable_autolock | Enables autolock function for a specific lock. | | smartcam_capture | Capture a new image from a specific smartcam. | - From bbdedd549f3aac8618e8276a207cfbadbe6b08bc Mon Sep 17 00:00:00 2001 From: Marty Cochrane Date: Mon, 15 Mar 2021 15:28:12 +0100 Subject: [PATCH 07/13] reword steps --- source/_integrations/verisure.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/verisure.markdown b/source/_integrations/verisure.markdown index fa45695db06e..ded013929d60 100644 --- a/source/_integrations/verisure.markdown +++ b/source/_integrations/verisure.markdown @@ -110,8 +110,8 @@ Verisure added 2FA rules to Verisure mypages that aren't supported through their You can deactivate 2FA for your admin account and use that for Home Assistant but this isn't recommended. The steps below sets up a specific Home Assistant user and gives it restricted access. -1. Create a specific Home Assistant user. (not necessary but it's not recommended to turn of 2FA for your admin user). -2. Make sure that user is admin, you've logged in & setup 2FA. +1. Login to Verisure mypages as your admin user and create a new admin user for Home Assistant +2. Login in as your newly created Home Assistant user, you'll be prompted to set up 2DA, do that and then log out. This will make sure the options below are available. 3. Login as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA. **Note this will only be available if the user is admin and has logged in once with 2FA, logged out and in again** From be6734f36544ea486a3471a5f0d6ac1f66c8d335 Mon Sep 17 00:00:00 2001 From: Marty Cochrane Date: Mon, 15 Mar 2021 15:32:46 +0100 Subject: [PATCH 08/13] added recommended note style --- source/_integrations/verisure.markdown | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/source/_integrations/verisure.markdown b/source/_integrations/verisure.markdown index ded013929d60..3916647ff1f1 100644 --- a/source/_integrations/verisure.markdown +++ b/source/_integrations/verisure.markdown @@ -112,14 +112,11 @@ You can deactivate 2FA for your admin account and use that for Home Assistant bu 1. Login to Verisure mypages as your admin user and create a new admin user for Home Assistant 2. Login in as your newly created Home Assistant user, you'll be prompted to set up 2DA, do that and then log out. This will make sure the options below are available. -3. Login as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA. - - **Note this will only be available if the user is admin and has logged in once with 2FA, logged out and in again** +3. Login as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA.
This will only be available if the user is admin and has logged in once with 2FA, logged out and in again.
4. Login as your administrator again and change the Home Assistant user to a restricted user. 5. Change Home Assistant Verisure config to the new user credentials in Home Assistant. 6. Restart Home Assistant. - ## Alarm Control Panel The Verisure alarm control panel platform allows you to control your [Verisure](https://www.verisure.com/) Alarms. From b509872bb5a7beca437e679c55e389799f87e0fe Mon Sep 17 00:00:00 2001 From: Marty Cochrane Date: Mon, 15 Mar 2021 15:37:09 +0100 Subject: [PATCH 09/13] Change login to be an action --- source/_integrations/verisure.markdown | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/_integrations/verisure.markdown b/source/_integrations/verisure.markdown index 3916647ff1f1..6651a198197c 100644 --- a/source/_integrations/verisure.markdown +++ b/source/_integrations/verisure.markdown @@ -110,10 +110,10 @@ Verisure added 2FA rules to Verisure mypages that aren't supported through their You can deactivate 2FA for your admin account and use that for Home Assistant but this isn't recommended. The steps below sets up a specific Home Assistant user and gives it restricted access. -1. Login to Verisure mypages as your admin user and create a new admin user for Home Assistant -2. Login in as your newly created Home Assistant user, you'll be prompted to set up 2DA, do that and then log out. This will make sure the options below are available. -3. Login as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA.
This will only be available if the user is admin and has logged in once with 2FA, logged out and in again.
-4. Login as your administrator again and change the Home Assistant user to a restricted user. +1. `Login` to Verisure mypages as your admin user and create a new admin user for Home Assistant +2. `Login` in as your newly created Home Assistant user, you'll be prompted to set up 2FA, do that and then log out. This will make sure the options below are available. +3. `Login` as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA.
This will only be available if the user is admin and has logged in once with 2FA, logged out and in again.
+4. `Login` as your administrator again and change the Home Assistant user to a restricted user. 5. Change Home Assistant Verisure config to the new user credentials in Home Assistant. 6. Restart Home Assistant. From 9b389dfe03911a6a5dedf05e27db08673fe67175 Mon Sep 17 00:00:00 2001 From: Marty Cochrane Date: Mon, 15 Mar 2021 15:40:11 +0100 Subject: [PATCH 10/13] typo --- source/_integrations/verisure.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/verisure.markdown b/source/_integrations/verisure.markdown index 6651a198197c..95fd405d5cb6 100644 --- a/source/_integrations/verisure.markdown +++ b/source/_integrations/verisure.markdown @@ -106,11 +106,11 @@ giid: ## 2 Factor Authentication Prerequisite -Verisure added 2FA rules to Verisure mypages that aren't supported through their third party API integration. If you have 2FA enabled (which is forced as default) You might not be able to use this integration. Here is the suggested way to use deactivate 2FA if it's allowed in your region. +Verisure added 2FA rules to Verisure mypages that aren't supported through their third party API integration. If you have 2FA enabled (which is forced as default) You might not be able to use this integration. Here is the suggested way to deactivate 2FA if it's allowed in your region. You can deactivate 2FA for your admin account and use that for Home Assistant but this isn't recommended. The steps below sets up a specific Home Assistant user and gives it restricted access. -1. `Login` to Verisure mypages as your admin user and create a new admin user for Home Assistant +1. `Login` to Verisure mypages as your admin user and create a new admin user for Home Assistant. 2. `Login` in as your newly created Home Assistant user, you'll be prompted to set up 2FA, do that and then log out. This will make sure the options below are available. 3. `Login` as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA.
This will only be available if the user is admin and has logged in once with 2FA, logged out and in again.
4. `Login` as your administrator again and change the Home Assistant user to a restricted user. From 2f414c672505693b8d43ec01ad35112a56130cad Mon Sep 17 00:00:00 2001 From: Marty Cochrane Date: Mon, 15 Mar 2021 15:42:09 +0100 Subject: [PATCH 11/13] changed login to log in as it's an action --- source/_integrations/verisure.markdown | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/_integrations/verisure.markdown b/source/_integrations/verisure.markdown index 95fd405d5cb6..45a3424cb833 100644 --- a/source/_integrations/verisure.markdown +++ b/source/_integrations/verisure.markdown @@ -110,10 +110,10 @@ Verisure added 2FA rules to Verisure mypages that aren't supported through their You can deactivate 2FA for your admin account and use that for Home Assistant but this isn't recommended. The steps below sets up a specific Home Assistant user and gives it restricted access. -1. `Login` to Verisure mypages as your admin user and create a new admin user for Home Assistant. -2. `Login` in as your newly created Home Assistant user, you'll be prompted to set up 2FA, do that and then log out. This will make sure the options below are available. -3. `Login` as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA.
This will only be available if the user is admin and has logged in once with 2FA, logged out and in again.
-4. `Login` as your administrator again and change the Home Assistant user to a restricted user. +1. Log in to Verisure mypages as your admin user and create a new admin user for Home Assistant. +2. Log in in as your newly created Home Assistant user, you'll be prompted to set up 2FA, do that and then log out. This will make sure the options below are available. +3. Log in as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA.
This will only be available if the user is admin and has logged in once with 2FA, logged out and in again.
+4. Log in as your administrator again and change the Home Assistant user to a restricted user. 5. Change Home Assistant Verisure config to the new user credentials in Home Assistant. 6. Restart Home Assistant. From 509e04f7de0ebc1ad52d17d276fdcf55b6434aaf Mon Sep 17 00:00:00 2001 From: Marty Cochrane Date: Mon, 15 Mar 2021 16:11:12 +0100 Subject: [PATCH 12/13] Changed mypages to My Pages --- source/_integrations/verisure.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/verisure.markdown b/source/_integrations/verisure.markdown index 45a3424cb833..58611afda057 100644 --- a/source/_integrations/verisure.markdown +++ b/source/_integrations/verisure.markdown @@ -106,11 +106,11 @@ giid: ## 2 Factor Authentication Prerequisite -Verisure added 2FA rules to Verisure mypages that aren't supported through their third party API integration. If you have 2FA enabled (which is forced as default) You might not be able to use this integration. Here is the suggested way to deactivate 2FA if it's allowed in your region. +Verisure added 2FA rules to Verisure My Pages that aren't supported through their third party API integration. If you have 2FA enabled (which is forced as default) You might not be able to use this integration. Here is the suggested way to deactivate 2FA if it's allowed in your region. You can deactivate 2FA for your admin account and use that for Home Assistant but this isn't recommended. The steps below sets up a specific Home Assistant user and gives it restricted access. -1. Log in to Verisure mypages as your admin user and create a new admin user for Home Assistant. +1. Log in to Verisure My Pages as your admin user and create a new admin user for Home Assistant. 2. Log in in as your newly created Home Assistant user, you'll be prompted to set up 2FA, do that and then log out. This will make sure the options below are available. 3. Log in as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA.
This will only be available if the user is admin and has logged in once with 2FA, logged out and in again.
4. Log in as your administrator again and change the Home Assistant user to a restricted user. From e5e213c8a925a2667a92f3c35d478490531bcf27 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Tue, 16 Mar 2021 00:38:51 +0100 Subject: [PATCH 13/13] Small Tweaks --- source/_integrations/verisure.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/verisure.markdown b/source/_integrations/verisure.markdown index 58611afda057..0d20e8bcae40 100644 --- a/source/_integrations/verisure.markdown +++ b/source/_integrations/verisure.markdown @@ -106,12 +106,12 @@ giid: ## 2 Factor Authentication Prerequisite -Verisure added 2FA rules to Verisure My Pages that aren't supported through their third party API integration. If you have 2FA enabled (which is forced as default) You might not be able to use this integration. Here is the suggested way to deactivate 2FA if it's allowed in your region. +Verisure added 2FA rules to Verisure My Pages that aren't supported through their third-party API integration. If you have 2FA enabled, which is forced by default, you might not be able to use this integration. Here is the suggested way to deactivate 2FA (if it's allowed in your region). You can deactivate 2FA for your admin account and use that for Home Assistant but this isn't recommended. The steps below sets up a specific Home Assistant user and gives it restricted access. 1. Log in to Verisure My Pages as your admin user and create a new admin user for Home Assistant. -2. Log in in as your newly created Home Assistant user, you'll be prompted to set up 2FA, do that and then log out. This will make sure the options below are available. +2. Log in as your newly created Home Assistant user, you'll be prompted to set up 2FA, do that and then log out. This will make sure the options below are available. 3. Log in as the Home Assistant user, browse to Account and subscription -> Account -> Login Credentials -> Disable 2FA.
This will only be available if the user is admin and has logged in once with 2FA, logged out and in again.
4. Log in as your administrator again and change the Home Assistant user to a restricted user. 5. Change Home Assistant Verisure config to the new user credentials in Home Assistant.