From bc44411ba5e04030e7c65305f756804783b7e3d9 Mon Sep 17 00:00:00 2001 From: Christopher Nethercott Date: Mon, 19 Jul 2021 16:59:20 +0100 Subject: [PATCH] Update icloud.markdown with section on app specific passwords. (#18407) Co-authored-by: Franck Nijhof --- source/_integrations/icloud.markdown | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/source/_integrations/icloud.markdown b/source/_integrations/icloud.markdown index 1d571a5ae67..be5c4cd38f4 100644 --- a/source/_integrations/icloud.markdown +++ b/source/_integrations/icloud.markdown @@ -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". +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