public/openhab-addons
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

[tesla] Remove (broken) options to obtain refresh token through credentials (#12537)

Browse Source 
* Remove (broken) option to obtain refresh token through credentials
* Remove outdated event streaming code
* Update README

Signed-off-by: Kai Kreuzer <kai@openhab.org>
This commit is contained in:
Kai Kreuzer
2022-03-31 09:11:55 +02:00
committed by GitHub
parent 8c6534300a
commit 9d2b04de33
10 changed files with 12 additions and 668 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
bundles/org.openhab.binding.tesla/README.md
View File

@@ -5,7 +5,8 @@ The integration happens through the Tesla Owners Remote API.
## Supported Things
All current Tesla models are supported by this binding. Access is established through a Tesla account as a bridge.
All current Tesla models are supported by this binding.
Access is established through a Tesla account as a bridge.
| Thing Type | Description |
|------------|----------------------------------------------|
@@ -19,42 +20,17 @@ All current Tesla models are supported by this binding. Access is established th
## Auto Discovery
If the authentication with the Tesla Account is done through the openHAB console (see "Bridge Configuration" option 1 below), the account is automatically added to the Inbox.
The account cannot be automatically discovered, but has to be created manually.
Once an account is configured, it is automatically queried for associated vehicles and an Inbox entry is created for each of them.
Note: Vehicles that are asleep might not be discovered, so you might want to wake it up through the Tesla app first.
Furthermore, once an account is configured, it is automatically queried for associated vehicles and an Inbox entry is created for each of them.
## Bridge Configuration
The `account` bridge requires an OAuth2 refresh token as the only parameter `refreshToken`.
There are three different ways of obtaining the token.
NOTE: Tesla has introduced some captcha mechanism, which might prevent options 1 and 2 from working as expected.
In case you are only receiving error messages, please make use of option 3!
1. Use the openHAB console
Run the following command on the console and provide your Tesla account credentials (the same that you use in the official Tesla app):
```
openhab> openhab:tesla login
Username (email): mail@example.com
Password: topsecret
Attempting login...Attempting login...
Refresh token: xxxxxxxxxx
```
When successfully doing the login through the console, openHAB will automatically create an Inbox entry that is preconfigured with the refresh token, which you can now simply approve.
Alternatively, you can use the refresh token to textually configure your `account` bridge or enter it in a manually created "Tesla Account" thing in the UI.
2. Provide your credentials in the UI
If you do not want to use the openHAB console, you can also manually create a "Tesla Account" thing in the UI by providing your username and password as parameters (to show them, use the "Show More" button) in the "Edit Thing" view and leaving the refresh token parameter field empty.
openHAB will use the provided credentials to retrieve and set the refresh token and automatically delete your password from the configuration afterwards for safety reasons.
3. Use external tools
There are a few 3rd party tools available that have specialized on getting hold of refresh tokens for the Tesla API.
Please note that we in general consider it dangerous to enter your credentials into some 3rd party app - you will have to trust the author not to send or store those credentials anywhere.