Bookstack Single Sign-On with WordPress as OAuth Server

Get Free Trial

WordPress OAuth Server plugin enables Single Sign-On (SSO) into the Bookstack app using your WordPress username and password. Once you configure the Bookstack with WP OAuth Server plugin, you can login to your Bookstack application using WP credentials. OAuth Server plugin also allows you to send custom WordPress user attributes to your Bookstack app as per your requirements. To know more about other features we provide in WP OAuth Server plugin, you can click here.

Download And Installation

• Log into your WordPress instance as an admin.
• Go to the WordPress Dashboard -> Plugins and click on Add New.
• Search for a WordPress OAuth Server Single Sign-On (SSO) plugin and click on Install Now.
• Once installed click on Activate.

Steps to configure WordPress Bookstack SSO with WP OAuth Server.

1. Setup WordPress as OAuth Server

• Go to miniOrange OAuth Server on the left side menu and Select the Custom openid connect client button to create a New client.

• Enter Client name as you want. Enter the Redirect / Callback URL ( eg: https://<bookstack-app-url>/oidc/callback) provided by Bookstack under the Redirect URI field and click on Save Client button.

• Note down Client ID, Client Secret and Issuer endpoint to configure in your OAuth Client.

2. Configure Bookstack as OAuth Client.

• Add the following key values to your .env file

 
     Copy
        AUTH_METHOD=oidc

        OIDC_NAME=<display-name-on-login-page>

        OIDC_CLIENT_ID=<client-id>

        OIDC_CLIENT_SECRET=<client-secret>

        OIDC_ISSUER=https://<your-wordpress-domain>/wp-json/moserver/<client-id>

        OIDC_ISSUER_DISCOVER=true
      

• This enables SSO into your BookStack application, you can visit the login page, and you should see the Login with <OIDC_NAME> button.
• If you want to enable the registration, Go to Settings => Registration and enable the checkbox

• If you want to initiate the SSO automatically without clicking the login button, you can add the below key value in the env file. AUTH_AUTO_INITIATE=false
• You can open your BookStack login page in an incognito window, you should see the SSO button added.

In this Guide, you have successfully configured WordPress Single Sign-On (SSO) into BookStack app with WordPress as OAuth Provider and BookStack as OAuth Client using our WP OAuth Server plugin. This solution ensures that you are ready to roll out secure access to your BookStack app using WordPress site credentials within minutes.

Additional Resources

• BookStack Technical Guide
• HubSpot Single sign-on (SSO)
• WordPress to WordPress Single sign-on (SSO)
• Step Guide to enable miniOrange OAuth Server for WordPress
• WordPress OAuth Server Plugin