jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 09:17:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add more specific SimpliSafe authorization code instructions (#20164)

Browse Source
This commit is contained in:
Aaron Bach 2021-11-15 06:57:01 -07:00 committed by GitHub
parent 5074288aa6
commit 6898782ccb
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 17 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
source/_integrations/simplisafe.markdown
View File

@ -38,6 +38,14 @@ There is currently support for the following device types within Home Assistant:
## Getting an Authorization Code
<div class="note info">
You must have multi-factor authentication set up in your SimpliSafe account to install the integration.
</div>
<div class="note info">
You must use a "standard" operating system (Windows, macOS, Linux) to perform the below instructions. Indications are that non-standard OS's, like Chrome OS, will not work.
</div>
<div class="note warning">
Because of a technical limitation, the below instructions will not work for iOS users as-is. It is recommended that you set up the SimpliSafe integration from a desktop browser. If you must use an iOS device, please ensure that the SimpliSafe app is not installed before beginning; the app can be re-installed after the integration is set up.
</div>
@ -47,10 +55,16 @@ Starting in 2021, SimpliSafe has moved to a new authentication mechanism via its
1. Initiate adding the integration via the instructions above.
2. When prompted, click the link that opens the SimpliSafe web app.
3. Input your SimpliSafe credentials. You will see "Verification Pending" – leave this browser tab open.
4. Check your email for a message from SimpliSafe. When you have received that email, click "Verify Device" – note that this will open a second browser tab/window.
5. After the verification is successful, return to the first browser tab/window. The browser will show an error about not being able to navigate to the page; ignore it.
4. You will receive a multi-factor authentication prompt, either via SMS or email. Regardless of the type, use this message to verify the access request.
5. After the verification is successful, return to the first browser tab/window.
At this stage, take a look at the address bar and note the `code` parameter at the very end of the URL:
Retrieving the access code is different depending on which browser you are using:
* Chrome: Navigate to `Developer -> Developer Tools -> Console Tab` and look for a `Failed to launch` error.
* Edge: Navigate to `Developer -> Developer Tools -> Console Tab` and look for a `Failed to launch` error.
* Safari: Navigate to `Develop -> Show Web Inspector -> Network Tab` and look for a reference to `ErrorPage.html`.
Look for a reference to a URL that starts with `com.simplisafe.mobile://` and note the code at the end:
```txt
com.simplisafe.mobile://auth.simplisafe.com/ios/com.simplisafe.mobile/callback?code=<CODE>