Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[miio] Cloud login issues improvement #13715

Merged
merged 9 commits into from
Nov 29, 2022
Merged

Conversation

marcelrv
Copy link
Contributor

  • Small change in debug loggin is login issues are expected
  • Additional trouble shooting steps in readme
  • Fix duplicate name in device list preventing readme maker running
  • Catch a json exception in readme maker

close #13611
close #7459

Signed-off-by: Marcel Verpaalen marcel@verpaalen.com

* Small change in debug loggin is login issues are expected
* Additional trouble shooting steps in readme
* Fix duplicate name in device list preventing readme maker running
* Catch a json exception in readme maker

close openhab#13611
close openhab#7459


Signed-off-by: Marcel Verpaalen <marcel@verpaalen.com>
@marcelrv marcelrv requested a review from lolodomo November 14, 2022 16:07
@jlaur jlaur added the bug An unexpected problem or unintended behavior of an add-on label Nov 14, 2022
The most common problem is a wrong userId/password. Try to fix your userId/password. The login userId & password are entered in the binding config page.
If the problem persists you can try the following:

* Your ip might need to be validated/confirmed. Logon to https://account.xiaomi.com/ **from the ip of your openHAB server** with a browser.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I do not understand the second sentence.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I rephrased it. Hope it is more clear this time

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jlaur : do you understand what means "Logon to https://account.xiaomi.com/ from the ip of your openHAB server with a browser."?

Copy link
Contributor

@jlaur jlaur Nov 17, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure I understand it, but let me explain how I understand it: Xiaomi need a kind of verification that a specific IP address is assigned to the user claiming it. Or, more specifically, that the IP address is currently assigned (dynamically or statically) by the ISP to the users router. So I assume we are talking about the public IP address. In this case I would assume that a browser on any computer within the LAN behind the router (assuming only one public IP address) can be used to perform this "validation". So I don't understand it like I would need to install and try to run some browser on my openHABian installation running on a Raspberry Pi.

In other words, back to my intro: No, I'm not sure I understand it, I would need some more context, and I think it could be further rewritten after that.

Copy link
Contributor Author

@marcelrv marcelrv Nov 18, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jlaur I think your understanding is right. (at least in line with how I understand it myself and what i was intended to document as workaround)

For some time now we have occasionally folks where the cloud connection is not working and it remains unclear why not. As there are no really useful messages produced when it fails, these issues remained open.

For some it appears that they can overcome the matter by resetting their password, but for others this remains an issue and indeed no solution (that I can provide)

In the latest instance of such an issue #13611 it was found that it indeed seems some additional authentication step is required, to validate the ip. We still don't know when/why (as most users don't experience the issue) but it might be just the thing that is missing for these users.

Hence the PR is to document this special case in the readme / problem resolving section.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The sentence I did not understand is still there, unchanged ; I am not sure the added screen capture is really helpful to understand it.
But ok, I will not insist more, let's assume the users will understand better than me what you mean.

Copy link
Contributor Author

@marcelrv marcelrv Nov 26, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I did one more attempt to clarify it better, and trying to understand in which scenario's there might be issues.
The vast majority won't face this as their (external) ip is equal for both the OH server and their regular pc/browser ip.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok thank you, I finally understood.
Maybe you could replace "connect from the ip of your openHAB server with a browser" by "connect with your browser while no VPN is enabled (to not hide your external IP address)". WDYT ?

And the screen capture is no more necessary. WDYT ?

Copy link
Contributor Author

@marcelrv marcelrv Nov 28, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe you could replace "connect from the ip of your openHAB server with a browser" by "connect with your browser while no VPN is enabled (to not hide your external IP address)". WDYT ?

I think that is the most likely usecase indeed, but I think the user creating the issue actually was hosting his OH server somewhere else (on a VPS), why I understood he made a bridge to that server and was running a browser from the ip of his hosting provider. (He was by running some vpn docker with port forwarding, he also could have used some SSH tunneling I think)
this is why I was emphasizing the ' from the ip of your openHAB server ' part...

Do you think it is more clear if i change it to something like "browse with the same external ip address as your openHAB server to...http etc"

The screenshot does not contribute much, no problem removing it...

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you think it is more clear if i change it to something like "browse with the same external ip address as your openHAB server to...http etc"

Yes, I believe

Signed-off-by: Marcel Verpaalen <marcel@verpaalen.com>
Signed-off-by: Marcel Verpaalen <marcel@verpaalen.com>
Signed-off-by: Marcel Verpaalen <marcel@verpaalen.com>
@marcelrv marcelrv requested a review from lolodomo November 15, 2022 08:28
Signed-off-by: Marcel Verpaalen marcel@verpaalen.com
* resolve merge conflict readme
* minor reformatting by the automated json tooling.

Signed-off-by: Marcel Verpaalen <marcel@verpaalen.com>
@marcelrv
Copy link
Contributor Author

@lolodomo saw there was some merge conflict in the readme after merging of #13724
This is resolved now

Signed-off-by: Marcel Verpaalen <marcel@verpaalen.com>
Signed-off-by: Marcel Verpaalen <marcel@verpaalen.com>
Signed-off-by: Marcel Verpaalen <marcel@verpaalen.com>
Copy link
Contributor

@lolodomo lolodomo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thank you

@lolodomo lolodomo merged commit ac546de into openhab:main Nov 29, 2022
@lolodomo lolodomo added this to the 3.4 milestone Nov 29, 2022
@kaikreuzer kaikreuzer changed the title [miio] cloud login issues improvement [miio] Cloud login issues improvement Dec 11, 2022
andrasU pushed a commit to andrasU/openhab-addons that referenced this pull request Dec 24, 2022
* [miio] cloud login issues improvement

* Small change in debug loggin is login issues are expected
* Additional trouble shooting steps in readme
* Fix duplicate name in device list preventing readme maker running
* Catch a json exception in readme maker

close openhab#13611
close openhab#7459

* [miio] fix strange/foreign characters in readme

Signed-off-by: Marcel Verpaalen <marcel@verpaalen.com>
Signed-off-by: Andras Uhrin <andras.uhrin@gmail.com>
borazslo pushed a commit to borazslo/openhab-mideaac-addon that referenced this pull request Jan 8, 2023
* [miio] cloud login issues improvement

* Small change in debug loggin is login issues are expected
* Additional trouble shooting steps in readme
* Fix duplicate name in device list preventing readme maker running
* Catch a json exception in readme maker

close openhab#13611
close openhab#7459

* [miio] fix strange/foreign characters in readme

Signed-off-by: Marcel Verpaalen <marcel@verpaalen.com>
psmedley pushed a commit to psmedley/openhab-addons that referenced this pull request Feb 23, 2023
* [miio] cloud login issues improvement

* Small change in debug loggin is login issues are expected
* Additional trouble shooting steps in readme
* Fix duplicate name in device list preventing readme maker running
* Catch a json exception in readme maker

close openhab#13611
close openhab#7459

* [miio] fix strange/foreign characters in readme

Signed-off-by: Marcel Verpaalen <marcel@verpaalen.com>
nemerdaud pushed a commit to nemerdaud/openhab-addons that referenced this pull request Feb 28, 2023
* [miio] cloud login issues improvement

* Small change in debug loggin is login issues are expected
* Additional trouble shooting steps in readme
* Fix duplicate name in device list preventing readme maker running
* Catch a json exception in readme maker

close openhab#13611
close openhab#7459

* [miio] fix strange/foreign characters in readme

Signed-off-by: Marcel Verpaalen <marcel@verpaalen.com>
andrasU pushed a commit to andrasU/openhab-addons that referenced this pull request Jan 6, 2024
* [miio] cloud login issues improvement

* Small change in debug loggin is login issues are expected
* Additional trouble shooting steps in readme
* Fix duplicate name in device list preventing readme maker running
* Catch a json exception in readme maker

close openhab#13611
close openhab#7459

* [miio] fix strange/foreign characters in readme

Signed-off-by: Marcel Verpaalen <marcel@verpaalen.com>
Signed-off-by: Andras Uhrin <andras.uhrin@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug An unexpected problem or unintended behavior of an add-on
Projects
None yet
3 participants