Hanzo
PlatformHanzo IAMIntegrationsGo

BookStack

Using Hanzo IAM for authentication in BookStack

BookStack is an open-source wiki/document platform. Use Hanzo IAM for sign-in with the following steps.

Step 1: Create a Hanzo IAM application

In Hanzo IAM, add an application (e.g. BookStack). Note Name, Organization, Client ID, and Client secret.

bookstack_config.png

Step 2: Configure Hanzo IAM Login

Next, navigate to BookStack and find the file oauth.conf.example.

Rename oauth.conf.example to oauth.conf and modify the configuration. By default, the content is as follows:

[oauth]
iamOrganization = "<Organization>"
iamApplication = "bookstack"
iamEndpoint = http://localhost:8000
clientId = <client ID>
clientSecret = <client Secret>
redirectUrl = http://localhost:8181/login/callback

### Step 3: Fill in the `redirectUrl` in Hanzo IAM

In the final step, go back to the page where you added the **BookStack application** and fill in the `Redirect URLs`. Make sure the `Redirect URL` is the same as the `redirectUrl` in the `oauth.conf` file.

![bookstack_callback](/img/integration/go/bookstack/callback.png)

After deploying BookStack, sign in via Hanzo IAM.

How is this guide?

Last updated on

On this page