heisenberg2980 / authenticated

A platform which allows you to get information about sucessfull logins to Home Assistant.

authenticated

A platform which allows you to get information successful logins to Home Assistant.

Note that this integration is a very minor update from the depreciated custom component by @ludeeus. At this stage, it's simply an update of the development environment only.

It works for me, but hasn't gone through thorough testing or updates.

If that doesn't worry you, then you should know what to get from this repo, or use HACS.

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/

Changelog

v0.0.1

• Initial fork of custom-components/authenticated by @ludeeus.
• Updated development environment for 2024.5.5 including Python 3.12

Old Readme (may or may not be accurate)

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

---