Update icloud.markdown with section on app specific passwords. (#18407)

Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
Christopher Nethercott 2021-07-19 16:59:20 +01:00 committed by GitHub
parent 8c39fc4602
commit bc44411ba5
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -33,9 +33,23 @@ You may receive an email and a notification from Apple saying that someone has l
For the notification, press "Allow", then "OK".
</div>
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.
## Two Factor Authentication
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.
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.
### App Specific Passwords
Apple allows you to provide an [App Specific Password](https://support.apple.com/en-gb/HT204397), which **don't require two factor authentication**, and one could argue more secure than storing your iCloud password within Home Assistant.
#### How to generate an app-specific password
1. Sign in to your [Apple ID account page](https://appleid.apple.com/account/home).
2. In the Security section, click Generate Password below App-Specific Passwords.
3. Follow the steps on your screen.
After you generate your app-specific password, enter or paste it into the password field of the integration.
Any time you change or reset your primary Apple ID password, all your app-specific passwords are revoked automatically to protect the security of your account. You'll need to generate new app-specific passwords for any apps that you want to continue using.
## In case of troubleshooting