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-15 13:26:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

Updated iCloud to support 2FA (#16375)

Browse Source 
Co-authored-by: Quentame <polletquentin74@me.com>
This commit is contained in:
Niccolo Zapponi 2021-02-05 11:55:10 +00:00 committed by GitHub
parent 8041407e87
commit 9267e660f7
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
source/_integrations/icloud.markdown
View File

@ -29,9 +29,9 @@ There is two ways to integrate iCloud in Home Assistant
Menu: *Configuration* -> *Integrations*. Search for "iCloud", add your credentials, click submit. Menu: *Configuration* -> *Integrations*. Search for "iCloud", add your credentials, click submit.
If you add the integration for the first time for an account: If you add the integration for the first time for an account, and two-factor authentication is enabled:
1. Choose a trusted device from the list and submit. 1. After clicking submit, you will receive a verification code on your trusted iCloud devices.
2. It will send you a text message on your trusted device, add the received code to the next form and submit (if you missed the right code, you will be back to the previous step, and retry). 2. Press Allow on your device, and enter the 6 digit code in Home Assistant. Finally, click Submit.
3. You are done! 3. You are done!
If you already added the integration before, you are done! If you already added the integration before, you are done!
@ -83,9 +83,7 @@ You may receive an email and a notification from Apple saying that someone has l
For the notification, press "Allow", then "OK". For the notification, press "Allow", then "OK".
</div> </div>
If two-step authentication is enabled for your iCloud account, some time after Home Assistant startup the integration will ask which device you want to use as the Trusted Device via a notification in the Home Assistant UI. The integration will send an SMS prompt to that device with the auth code to enter in Home Assistant. The duration of this authentication is determined by Apple, but is currently 2 months, so you will only need to verify your account every two months. If two-step authentication is enabled for your iCloud account, some time after Home Assistant startup the integration will ask to enter the verification code you receive on your device via a notification in the Home Assistant UI. The duration of this authentication is determined by Apple, so you will need to verify your account every now and then.
2 Factor Authentication is the improved version of two-step authentication and is still not supported by the pyicloud library. Therefore it's not possible to use it with the device_tracker yet.
To prevent excessive battery drainage, a dynamic interval is used for each individual device instead of a fixed interval for all devices linked to one account. The dynamic interval is based on the current zone of a device, the distance towards home and the battery level of the device. To prevent excessive battery drainage, a dynamic interval is used for each individual device instead of a fixed interval for all devices linked to one account. The dynamic interval is based on the current zone of a device, the distance towards home and the battery level of the device.