diff --git a/website/integrations/services/thelounge/index.md b/website/integrations/services/thelounge/index.md new file mode 100644 index 000000000000..620a8f60ed61 --- /dev/null +++ b/website/integrations/services/thelounge/index.md @@ -0,0 +1,48 @@ +--- +title: Integrate with The Lounge +sidebar_label: The Lounge +--- + +# The Lounge + +Support level: Community + +## What is The Lounge + +> The Lounge is a modern, web-based IRC (Internet Relay Chat) client that allows users to stay connected to IRC servers even when offline. +> +> -- https://thelounge.chat/ + +:::note +This guide assumes you already deployed an LDAP Provider, if not check [here](https://docs.goauthentik.io/docs/add-secure-apps/providers/ldap/generic_setup). +If you made any changes, e.g. using a different name for the user, make sure to apply them here as well. +::: + +## Preparation + +The following placeholders will be used: + +- `authentik.company` is the FQDN of the authentik install. +- `dc=company,dc=com` the Base DN of the LDAP outpost. If you followed the LDAP provider guide this is: `dc=goauthentik,dc=io` +- `ldap_bind_user` the username of the desired LDAP Bind User. If you followed the LDAP provider guide this is: `ldapservice` + +## LDAP Configuration + +### authentik Configuration + +Follow the [instructions](https://docs.goauthentik.io/docs/add-secure-apps/outposts/#create-and-configure-an-outpost) to create an LDAP outpost and configure access via the outpost. No additional authentik configuration needs to be configured. + +### The Lounge configuration + +In the `config.js` file find the `ldap` section and make the following changes: + +1. Set `enable` to `true` +2. Set `url` to `ldap://authentik.company` +3. Set `primaryKey` to `cn` +4. In the `searchDN` section make the following changes: + 1. Set `rootDN` to `cn=ldap_bind_user,ou=users,dc=company,dc=com` + 2. Set `rootPassword` to the password you have given to the `ldap_bind_user` + 3. Set `filter` to `(&(objectClass=user)` + 1. Alternatively, if you want to restrict access by group, you can set it to: `(&(objectClass=user)(memberOf=cn=group_name,ou=groups,dc=ldap,dc=company,dc=com))` + 4. Set `base` to `dc=ldap,dc=company,dc=com` +5. Finally, save the `config.js` file and restart The Lounge. You should be able to log in via LDAP now, as long as a user with the same name exists. diff --git a/website/sidebarsIntegrations.js b/website/sidebarsIntegrations.js index 39d1c0dca54d..d97f5698abeb 100644 --- a/website/sidebarsIntegrations.js +++ b/website/sidebarsIntegrations.js @@ -33,6 +33,7 @@ module.exports = { "services/roundcube/index", "services/sharepoint-se/index", "services/slack/index", + "services/thelounge/index", "services/vikunja/index", "services/wekan/index", "services/wiki-js/index",