Search Results :

×

Bookstack Single Sign-On with WordPress as OAuth Server

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.

  • 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.
  • Go to miniOrange OAuth Server on the left side menu and Select the Custom openid connect client button to create a New client.
OAuth server Single Sign-On(SSO)WordPress- Bookstack add 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.
OAuth server Single Sign-On(SSO)WordPress- Bookstack Authorized Redirect URI

  • Note down Client ID, Client Secret and Issuer endpoint to configure in your OAuth Client.
OAuth server Single Sign-On(SSO)WordPress- Bookstack client credentials

  • Add the following key values to your .env file
 
  
     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
OAuth server Single Sign-On(SSO)WordPress- Bookstack client credentials

  • 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.



ADFS_sso ×
Hello there!

Need Help? We are right here!

support