Bookstack NC authentication

putt1ck · August 10, 2023, 7:15am

Has anyone had success getting Bookstack to use NC auth via plugin or otherwise?

Obviously can use a separate SSO provider for both services, but for micro-deployments it seems more sensible to have NC provide the auth and reduce the number of dependencies. Looked at the OIDC option but it seems Bookstack devs are focused on basic auth as “the more significant/spec-required option” but the only plugin found doesn’t seem to support that option.

putt1ck · August 18, 2023, 8:14am

While OIDC seems a neater option for installs that are using NC as the only auth source, this PR shows a way of making OAuth work between NC and Bookstack:

and states but does not provide that the documentation here:

github.com

BookStackApp/BookStack/blob/release/dev/docs/logical-theme-system.md

# Logical Theme System

BookStack allows logical customization via the theme system which enables you to add, or extend, functionality within the PHP side of the system without needing to alter the core application files.

WARNING: This system is currently in alpha so may incur changes. Once we've gathered some feedback on usage we'll look to removing this warning. This system will be considered semi-stable in the future. The `Theme::` system will be kept maintained but specific customizations or deeper app/framework usage using this system will not be supported nor considered in any way stable. Customizations using this system should be checked after updates.

## Getting Started

*[Video Guide](https://www.youtube.com/watch?v=YVbpm_35crQ)*

This makes use of the theme system. Create a folder for your theme within your BookStack `themes` directory. As an example we'll use `my_theme`, so we'd create a `themes/my_theme` folder.
You'll need to tell BookStack to use your theme via the `APP_THEME` option in your `.env` file. For example: `APP_THEME=my_theme`.

Within your theme folder create a `functions.php` file. BookStack will look for this and run it during app boot-up. Within this file you can use the `Theme` facade API, described below, to hook into certain app events.

## `Theme` Facade API

Below details the public methods of the `Theme` facade that are considered stable:

### `Theme::listen`

This file has been truncated. show original

offers a solution without the PR