mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-22 16:56:50 +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