mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-23 09:17:06 +00:00
Documentation for the haveibeenpwned sensor platform (#1023)
* Documentation for the haveibeenpwned sensor platform * add ha_release and fix a few typo's / linebreaks * Update version of haveibeenpwned to be in HA 0.31
This commit is contained in:
parent
983cb9cbab
commit
ee72edd162
46
source/_components/sensor.haveibeenpwned.markdown
Normal file
46
source/_components/sensor.haveibeenpwned.markdown
Normal file
@ -0,0 +1,46 @@
|
|||||||
|
---
|
||||||
|
layout: page
|
||||||
|
title: "HaveIBeenPwned Sensor"
|
||||||
|
description: "Instructions how to integrate HaveIBeenPwned sensor into Home Assistant."
|
||||||
|
date: 2016-09-29 18:00
|
||||||
|
sidebar: true
|
||||||
|
comments: false
|
||||||
|
sharing: true
|
||||||
|
footer: true
|
||||||
|
logo: haveibeenpwned.png
|
||||||
|
ha_category: Sensor
|
||||||
|
ha_release: 0.31
|
||||||
|
---
|
||||||
|
|
||||||
|
The `haveibeenpwned` sensor platform creates sensors that check for breached email accounts on [haveibeenpwned](https://haveibeenpwned.com).
|
||||||
|
To enable this sensor, add the following lines to your `configuration.yaml`, it will list every specified email address as a sensor showing
|
||||||
|
the number of breaches on that email account:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# Example configuration.yaml entry using cloud based emoncms
|
||||||
|
sensor:
|
||||||
|
platform: haveibeenpwned
|
||||||
|
email:
|
||||||
|
- your_email1@domain.com
|
||||||
|
- your_email2@domain.com
|
||||||
|
```
|
||||||
|
|
||||||
|
## {% linkable_title Breach meta data %}
|
||||||
|
|
||||||
|
If one of your email accounts is breached the sensor will display breach meta data. It will list the title of the site where your email
|
||||||
|
account has been breached as well as the added date of the breach data. This data is displayed in descending order so that the state attribute
|
||||||
|
`breach 1` will always contain the last known breach for the specific email account, if there are any breaches detected.
|
||||||
|
|
||||||
|
<p class='img'>
|
||||||
|
<img src='/images/components/haveibeenpwned/sensor.png' />
|
||||||
|
</p>
|
||||||
|
|
||||||
|
## {% linkable_title Configuration variables %}
|
||||||
|
|
||||||
|
- **email** (*Required*): List of email addresses.
|
||||||
|
|
||||||
|
<p class='note warning'>
|
||||||
|
The sensor will scan all email addresses specified with a 5 second delay between all breach data requests on Home Assistant startup.
|
||||||
|
After this initial startup scanning, the sensor will only scan one email account per 15 minutes to prevent abuse, and not hammer "the
|
||||||
|
Have I been Pwned" service, as this breach data almost never changes.
|
||||||
|
</p>
|
BIN
source/images/components/haveibeenpwned/sensor.png
Normal file
BIN
source/images/components/haveibeenpwned/sensor.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 21 KiB |
BIN
source/images/supported_brands/haveibeenpwned.png
Normal file
BIN
source/images/supported_brands/haveibeenpwned.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 50 KiB |
Loading…
x
Reference in New Issue
Block a user