LDAP

January 31, 2019 ยท View on GitHub

With the LDAP integration, you can authenticate via your LDAP server. Currently the application does need the user to be in the konga user database for the user profile page to display properly, so we currently will sync any LDAP authenticated user into the konga user database upon each login. In the future, perhaps the user profile page will be read-only for LDAP authentication? Or maybe it can sync the data back up to the LDAP server?

Configuration

Environment VariableDefaultDescription
KONGA_AUTH_PROVIDERlocalSet this to ldap to switch auth provider to LDAP
KONGA_LDAP_HOSTldap://localhost:389The location of the LDAP server
KONGA_LDAP_BIND_DNno defaultThe DN that the konga should use to login to LDAP to search users
KONGA_LDAP_BIND_PASSWORDno defaultThe password for the user konga will use to search for users
KONGA_LDAP_USER_SEARCH_BASEou=users,dc=comThe base DN used to search for users
KONGA_LDAP_USER_SEARCH_FILTER(|(uid={{username}})(sAMAccountName={{username}}))The filter expression used to search for users. Use {{username}} where you expect the username to be.
KONGA_LDAP_USER_ATTRSuid,uidNumber,givenName,sn,mailComma separated list of attributes to pull from the LDAP server for users
KONGA_LDAP_GROUP_SEARCH_BASEou=groups,dc=comThe base DN used to search for groups
KONGA_LDAP_GROUP_SEARCH_FILTER(|(memberUid={{uid}})(memberUid={{uidNumber}})(sAMAccountName={{uid}}))The filter expression used to search for groups. Use {{some-attr}} where you expect a user attribute to be or {{dn}} for the user dn.
KONGA_LDAP_GROUP_ATTRScnComma separated list of attributes to pull from the LDAP server for groups
KONGA_ADMIN_GROUP_REG^(admin|konga)$Regular expression used to determine if a group should be considered as an admin user
KONGA_LDAP_ATTR_USERNAMEuidLDAP attribute name that should be used as the konga username
KONGA_LDAP_ATTR_FIRSTNAMEgivenNameLDAP attribute name that should be used as the konga user's first name
KONGA_LDAP_ATTR_LASTNAMEsnLDAP attribute name that should be used as the konga user's last name
KONGA_LDAP_ATTR_EMAILmailLDAP attribute name that should be used as the konga user's email address