companion.home-assistant/docs/notifications/details.md

2.0 KiB

title id
Privacy, rate limiting and security notification-details

Privacy

No notification content is stored on remote servers. Only the required push registration data and a simple counter of the total number of push notifications sent per day per device (for rate-limiting purposes) is kept.

Architecture

To provide the notification service, the app uses Google's Firebase cloud messaging service. For more information about Firebase, please click here.

iOS
If you wish to not exchange data with Google's servers, you can opt out of the Firebase services in the Privacy section of the Companion App settings in Configuration when using the app. Doing so will stop notifications from functioning.

Rate limiting

Currently, you are allowed to send a maximum of 500 push notifications per day per device. The rate limit resets at midnight UTC daily. This is to ensure that the service remains cheap to maintain. In the future we may add support for upgrading to allow more notifications.

The in-app Notifications settings screen in the iOS app displays your current rate limits for the day broken out into the following categories: Attempts, Delivered, Errors, Total, and the exact time until next daily reset. For Android you can find these details on the Companion App Screen with Configuration. Alternatively, you can also view them by setting homeassistant.components.mobile_app.notify: info for the logger integration.

If an error occurs while sending a notification, it does not count towards your rate limit. Critical Alerts and Notification Commands also do not count towards your rate limit.

Security

All traffic between your Home Assistant instance, the push infrastructure, and Apple, is encrypted with SSL.