mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-18 23:06:58 +00:00
Add docs for SimpliSafe OAuth flow (#19637)
This commit is contained in:
parent
965f525242
commit
190648c618
@ -36,6 +36,28 @@ There is currently support for the following device types within Home Assistant:
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
## Getting an Authorization Code
|
||||
|
||||
<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>
|
||||
|
||||
Starting in 2021, SimpliSafe has moved to a new authentication mechanism via its web app. Below are instructions on retrieving the authorization code needed to finish setting the integration up.
|
||||
|
||||
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.
|
||||
|
||||
At this stage, take a look at the address bar and note the `code` parameter at the very end of the URL:
|
||||
|
||||
```txt
|
||||
com.simplisafe.mobile://auth.simplisafe.com/ios/com.simplisafe.mobile/callback?code=<CODE>
|
||||
```
|
||||
|
||||
Copy/paste this code parameter into Home Assistant to finish setting up the integration.
|
||||
|
||||
## Services
|
||||
|
||||
Note that the `system_id` parameter required by the below service calls can be discovered
|
||||
|
Loading…
x
Reference in New Issue
Block a user