Scopes

Home Connect Scopes

Home Connect uses Authorisation Scopes to limit the permissions for monitoring or controlling different types of appliance.

When the Home Connect API was first made available the standard developer accounts did not grant access to all scopes, which restricted the functionality that this plugin could provide. Specifically, the inability to authorise the Oven-Control scope meant that it was not possible to use this plugin to control Oven appliances, other than switching their power on or off.

However, the restriction on Oven-Control and Hob-Control scopes was removed on 31st March 2021, allowing full control of all appliance types. (The FridgeFreezer-Images scope still requires an "Additional Partner Agreement" but that is not relevant to this plugin.)

Scopes can only be changed during the initial authorisation process. To enable the ability to control Oven programs follow these steps:

1. Upgrade this plugin to version 0.20.0 or later.
2. Stop Homebridge (if running).
3. Delete the ~/.homebridge/homebridge-homeconnect/persist/94a08da1fecbb6e8b46990538c7b50b2 file which stores the previous OAuth tokens.
4. Start Homebridge.
5. Use the URL from the Homebridge log output to re-authorise access to the Home Connect account.