authenticated
authenticated copied to clipboard
A platform which allows you to get information about sucessfull logins to Home Assistant.
At this point this integtration is considered deprecated.
Parts of it can probably be added to core by someone, if its usefull.
For general info about securing your instance:
- https://www.home-assistant.io/docs/authentication/
- https://www.home-assistant.io/docs/authentication/multi-factor-auth
- https://www.home-assistant.io/docs/configuration/securing/
old readme
authenticated
A platform which allows you to get information successful logins to Home Assistant.
To get started you should know what to get from this repo, or use HACS.
Example configuration.yaml:
sensor:
- platform: authenticated
Configuration variables:
key | required | default | description |
---|---|---|---|
platform | yes | The sensor platform name. | |
enable_notification | no | true |
Turn on/off persistant_notifications when a new IP is detected, can be true /false . |
exclude | no | A list of IP addresses you want to exclude. | |
provider | no | 'ipapi' | The provider you want to use for GEO Lookup, 'ipapi', 'extreme', 'ipvigilante'. |
log_location | no | Full path to the logfile. |
Sample overview:
If a new IP is detected, it will be added to a .ip_authenticated.yaml
file in your configdir, with this information:
8.8.8.8:
city: Mountain View
country: US
hostname: google-public-dns-a.google.com
last_authenticated: '2018-07-26 09:27:01'
previous_authenticated_time: '2018-07-26 09:27:01'
region: california
If not disabled, you will also be presented with a persistent_notification
about the event:
Debug logging
In your configuration.yaml
logger:
default: warn
logs:
custom_components.sensor.authenticated: debug