mirror/lldap
1
0
Fork 0
mirror of https://github.com/nitnelave/lldap.git synced 2023-04-12 14:25:13 +00:00
Code Issues Projects Releases Wiki Activity
9a30cac7b0
lldap/example_configs/home-assistant.md
Austin Alvarado 8eb27c5267
docs: Create Home Assistant config (#535)
2023-04-07 14:59:21 -06:00

1.5 KiB
Raw Blame History

Home Assistant Configuration

Home Assistant configures ldap auth via the Command Line Auth Provider. The wiki mentions a script that can be used for LDAP authentication, but it doesn't work in the container version (it is lacking both ldapsearch and curl ldap protocol support). Thankfully LLDAP has a graphql API to save the day!

Graphql-based Auth Script

The auth script attempts to authenticate a user against an LLDAP server, using credentials provided via username and password environment variables. The first argument must be the URL of your LLDAP server, accessible from Home Assistant. You can provide an additional optional argument to confine allowed logins to a single group. The script will output the user's display name as the name variable, if not empty.

  1. Copy the auth script to your home assistant instance. In this example, we use /config/lldap-auth.sh.
  2. Add the following to your configuration.yaml in Home assistant:
homeassistant:
  auth_providers:
    # Ensure you have the homeassistant provider enabled if you want to continue using your existing accounts
    - type: homeassistant
    - type: command_line
      command: /config/lldap-auth.sh
      # Only allow users in the 'homeassistant_user' group to login.
      # Change to ["https://lldap.example.com"] to allow all users
      args: ["https://lldap.example.com", "homeassistant_user"]
      meta: true
  1. Reload your config or restart Home Assistant