SSO over ADFS Login #5023

Closed
opened 2026-02-05 09:34:25 +03:00 by OVERLORD · 9 comments
Owner

Originally created by @reddexx on GitHub (Oct 24, 2024).

Attempted Debugging

  • I have read the debugging page

Searched GitHub Issues

  • I have searched GitHub for the issue.

Describe the Scenario

After customising the user accounts, you can log in via ADFS

Unfortunately there is still a problem where I do not know where the error is
After clicking on the ‘Login with SSO’ button, you are redirected to the Microsoft ADFS login form where you have to log in instead of logging in directly, the manual login works.

Where is the Bookstack instance running?
Docker container

How can the page be accessed?
In the local network with a reverse proxy (nginx)
the ADFS is also only accessible in the local network

Exact BookStack Version

24.10

Log Content

No response

Hosting Environment

Debian VM in a Docker Container

Originally created by @reddexx on GitHub (Oct 24, 2024). ### Attempted Debugging - [X] I have read the debugging page ### Searched GitHub Issues - [X] I have searched GitHub for the issue. ### Describe the Scenario After customising the user accounts, you can log in via ADFS Unfortunately there is still a problem where I do not know where the error is After clicking on the ‘Login with SSO’ button, you are redirected to the Microsoft ADFS login form where you have to log in instead of logging in directly, the manual login works. Where is the Bookstack instance running? Docker container How can the page be accessed? In the local network with a reverse proxy (nginx) the ADFS is also only accessible in the local network ### Exact BookStack Version 24.10 ### Log Content _No response_ ### Hosting Environment Debian VM in a Docker Container
OVERLORD added the 🐕 Support label 2026-02-05 09:34:25 +03:00
Author
Owner

@ssddanbrown commented on GitHub (Oct 24, 2024):

Hi @reddexx,
Sorry, but I don't really understand what the issue is here.

After customising the user accounts, you can log in via ADFS

  • What do you mean by "customising the user accounts"?
  • What type of authentication in BookStack are you configuring for this?

you are redirected to the Microsoft ADFS login form where you have to log in instead of logging in directly, the manual login works.

  • What are your expectations here?
  • What is meant by "you have to log in instead of logging in directly"?
@ssddanbrown commented on GitHub (Oct 24, 2024): Hi @reddexx, Sorry, but I don't really understand what the issue is here. > After customising the user accounts, you can log in via ADFS - What do you mean by "customising the user accounts"? - What type of authentication in BookStack are you configuring for this? > you are redirected to the Microsoft ADFS login form where you have to log in instead of logging in directly, the manual login works. - What are your expectations here? - What is meant by "you have to log in instead of logging in directly"?
Author
Owner

@reddexx commented on GitHub (Oct 24, 2024):

Hey @ssddanbrown

What do you mean by "customising the user accounts"?

What type of authentication in BookStack are you configuring for this?

  • SAML2

That we can use SSO (SAML2 over ADFS)

What is meant by "you have to log in instead of logging in directly"?
image
after submit this button coming to ADFS Login
image

@reddexx commented on GitHub (Oct 24, 2024): Hey @ssddanbrown What do you mean by "customising the user accounts"? - https://github.com/BookStackApp/BookStack/issues/5270#issuecomment-2416483646 What type of authentication in BookStack are you configuring for this? - SAML2 That we can use SSO (SAML2 over ADFS) What is meant by "you have to log in instead of logging in directly"? ![image](https://github.com/user-attachments/assets/aba04e86-267b-4530-8383-b752e94af24a) after submit this button coming to ADFS Login ![image](https://github.com/user-attachments/assets/2ba06bfb-3709-4f32-be7c-815c8ffbe014)
Author
Owner

@ssddanbrown commented on GitHub (Oct 24, 2024):

Okay, so you're being redirect to your ADFS system for SAML2 login.
That's what I'd expect from BookStack, and any behavior while on the ADFS login screen will be down to the functionality of the auth (ADFS) system.

Are you already logged into ADFS, and therefore expecting the ADFS login to not show?
If so, then that's not really something due to BookStack behaviour as far as I'm aware.
I am not familiar enough with ADFS to know or suggestion settings/configuration for this.

@ssddanbrown commented on GitHub (Oct 24, 2024): Okay, so you're being redirect to your ADFS system for SAML2 login. That's what I'd expect from BookStack, and any behavior while on the ADFS login screen will be down to the functionality of the auth (ADFS) system. Are you already logged into ADFS, and therefore expecting the ADFS login to not show? If so, then that's not really something due to BookStack behaviour as far as I'm aware. I am not familiar enough with ADFS to know or suggestion settings/configuration for this.
Author
Owner

@reddexx commented on GitHub (Oct 24, 2024):

No, I have specifically cancelled my registration.
I tried to log in to a fresh session

Could it be due to the reverse proxy?

@reddexx commented on GitHub (Oct 24, 2024): No, I have specifically cancelled my registration. I tried to log in to a fresh session Could it be due to the reverse proxy?
Author
Owner

@ssddanbrown commented on GitHub (Oct 24, 2024):

No, I have specifically cancelled my registration.
I tried to log in to a fresh session

Oh, then I'd expect a login to show on the auth provider side (ADFS in this case).
Therefore I still don't understand what the issue is here, everything seems as expected.

@ssddanbrown commented on GitHub (Oct 24, 2024): > No, I have specifically cancelled my registration. > I tried to log in to a fresh session Oh, then I'd expect a login to show on the auth provider side (ADFS in this case). Therefore I still don't understand what the issue is here, everything seems as expected.
Author
Owner

@reddexx commented on GitHub (Oct 24, 2024):

I don't think that's how it should work.
I have set up several applications SSO only with Bookstack it is a little strange

I'm still checking a few things

@reddexx commented on GitHub (Oct 24, 2024): I don't think that's how it should work. I have set up several applications SSO only with Bookstack it is a little strange I'm still checking a few things
Author
Owner

@ssddanbrown commented on GitHub (Nov 7, 2024):

Since there's been no further progress here I'll go ahead and close this off, especially as I still don't see any indication of there being something unexpected, configurable or unexpected on the BookStack side of things.

@ssddanbrown commented on GitHub (Nov 7, 2024): Since there's been no further progress here I'll go ahead and close this off, especially as I still don't see any indication of there being something unexpected, configurable or unexpected on the BookStack side of things.
Author
Owner

@reddexx commented on GitHub (Nov 8, 2024):

sorry for the late feedback
I am still testing with another instance (Moodle) where the reverse proxy is used, only at the moment there is a lot of stress.😅

@reddexx commented on GitHub (Nov 8, 2024): sorry for the late feedback I am still testing with another instance (Moodle) where the reverse proxy is used, only at the moment there is a lot of stress.😅
Author
Owner

@awittendorff commented on GitHub (May 19, 2025):

@reddexx are you thinking of Windows Integrated Authentication with ADFS? So you don't have to type username/password on ADFS form?
Try setting the following in the .env file: SAML2_IDP_AUTHNCONTEXT=false

@awittendorff commented on GitHub (May 19, 2025): @reddexx are you thinking of Windows Integrated Authentication with ADFS? So you don't have to type username/password on ADFS form? Try setting the following in the .env file: SAML2_IDP_AUTHNCONTEXT=false
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/BookStack#5023