Backstage Plugin LDAP Auth

This monorepo containing two Backstage plugins to add LDAP authentication to your Backstage instance. It provides a sign-in page, token management, and server-side auth logic for your LDAP server.

Important

Breaking Change: Starting with version 5.x, this plugin has fully migrated to support the New Backstage Backend and Frontend Systems (Backstage version >= 1.48.3).

We have also migrated from ldapjs (which is deprecated and unmaintained) to ldapts. While most options remain the same, please refer to the new project for connection options and troubleshooting.

Legacy Support: If you are still using the old Backstage systems and cannot migrate yet, please continue using version 4.x.x of these plugins.

Quick Start

1. Install the packages in your Backstage repository:

   yarn workspace app add @immobiliarelabs/backstage-plugin-ldap-auth
   yarn workspace backend add @immobiliarelabs/backstage-plugin-ldap-auth-backend

2. Configure Backend: Add the LDAP module to your backend in packages/backend/src/index.ts.
3. Configure Frontend: Add createLdapAuthModule to your app features in packages/app/src/App.tsx.

Tip

This project is meant to be used in pair with the official @backstage/plugin-catalog-backend-module-ldap to keep your LDAP users in sync.

Plugins

Check the corrisponding README for both packages

• packages/ldap-auth-backend - Back to back authentication and token validation and management
• packages/ldap-auth- Frontend Login Page and token usage and retention logics

Powered Apps

Backstage Plugin LDAP Auth was created by the Node.js team at ImmobiliareLabs, the Tech dept of Immobiliare.it, the #1 real estate company in Italy.

We are currently using Backstage Plugin LDAP Auth in our products as well as our internal toolings.

If you are using Backstage Plugin LDAP Auth in production drop us a message.

Support & Contribute

Made with ❤️ by ImmobiliareLabs & Contributors

We'd love for you to contribute to Backstage Plugin LDAP Auth! If you have any questions on how to use Backstage Plugin LDAP Auth, bugs and enhancement please feel free to reach out by opening a GitHub Issue.

License

Backstage Plugin LDAP Auth is licensed under the MIT license.
See the LICENSE file for more information.