[HELP] Migrate AUTH_METHOD from Standard to LDAP #1246

Closed
opened 2026-02-05 00:23:57 +03:00 by OVERLORD · 4 comments
Owner

Originally created by @dusatvoj on GitHub (Jul 3, 2019).

Hello, is there any way to migrate existing BookStack from standard to ldap AUTH_METHOD (in the best case with some link option to existing accounts)?
Thanks for help

BookStackApp v0.26.2 with MySQL

Originally created by @dusatvoj on GitHub (Jul 3, 2019). Hello, is there any way to migrate existing BookStack from _standard_ to _ldap_ AUTH_METHOD (in the best case with some link option to existing accounts)? Thanks for help BookStackApp v0.26.2 with MySQL
OVERLORD added the 🐕 Support🚪 Authentication Question labels 2026-02-05 00:23:57 +03:00
Author
Owner

@ssddanbrown commented on GitHub (Jul 3, 2019):

Hi @dusatvoj,

BookStack links BookStack users to LDAP users via the uid LDAP attribute. Upon LDAP login, BookStack checks the users table to see if that UID already exists and, if so, logs the submitter into BookStack as that user.

When LDAP is enabled and you view an existing user, as an admin or manage-users account, you'll be able to see the "External Authentication ID" field in their profile. You can fill this in to set the uid for an existing non-LDAP user.

image

If you have many users to match up you may find it quicker to directly edit in the database. You can set the external_auth_id column of the users table to achieve the same thing.

Hope that helps!

@ssddanbrown commented on GitHub (Jul 3, 2019): Hi @dusatvoj, BookStack links BookStack users to LDAP users via the `uid` LDAP attribute. Upon LDAP login, BookStack checks the users table to see if that UID already exists and, if so, logs the submitter into BookStack as that user. When LDAP is enabled and you view an existing user, as an admin or `manage-users` account, you'll be able to see the "External Authentication ID" field in their profile. You can fill this in to set the `uid` for an existing non-LDAP user. ![image](https://user-images.githubusercontent.com/8343178/60619247-1efa7680-9dd0-11e9-80e6-cedda33dc41d.png) If you have many users to match up you may find it quicker to directly edit in the database. You can set the `external_auth_id` column of the `users` table to achieve the same thing. Hope that helps!
Author
Owner

@dusatvoj commented on GitHub (Jul 8, 2019):

Thank you @ssddanbrown,
I will try it.

@dusatvoj commented on GitHub (Jul 8, 2019): Thank you @ssddanbrown, I will try it.
Author
Owner

@ssddanbrown commented on GitHub (Jul 10, 2019):

Okay, Now that the original question has been answered I will close this.

@ssddanbrown commented on GitHub (Jul 10, 2019): Okay, Now that the original question has been answered I will close this.
Author
Owner

@davidnateberg commented on GitHub (Jun 9, 2020):

hello @ssddanbrown I am having this exact same issue, I was wondering what exactly you would put in the External Authentication ID field. As in uid=(users ID), or just the uid? a uid would be most likely be in the format of jsmith, correct?

@davidnateberg commented on GitHub (Jun 9, 2020): hello @ssddanbrown I am having this exact same issue, I was wondering what exactly you would put in the External Authentication ID field. As in uid=(users ID), or just the uid? a uid would be most likely be in the format of jsmith, correct?
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/BookStack#1246