Search Results :

×

Bookstack Single Sign-On with WordPress as OAuth Server

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

2. Configure Bookstack as OAuth Client.

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

Additional Resources

Need Help?

Mail us on oauthsupport@xecurify.com for quick guidance(via email/meeting) on your requirement and our team will help you to select the best suitable solution/plan as per your requirement.


Hello there!

Need Help? We are right here!

support
Contact miniOrange Support
success

Thanks for your inquiry.

If you dont hear from us within 24 hours, please feel free to send a follow up email to info@xecurify.com