Skip to main content
C1 provides identity governance for Bookstack. Integrate your Bookstack instance with C1 for unified visibility and governance over who can access your knowledge base and the roles they hold.

​
Capabilities

The connector syncs Bookstack users and roles, and the role membership graph that grants each user their roles.

​
Gather Bookstack credentials

The Bookstack user that owns the API token must hold both the Access System API and Manage Users and Permissions / Roles permissions. Without them, the connector cannot read users or roles and the sync fails.
Bookstack authenticates the REST API with a token pair: a public Token ID and a secret Token Secret. C1 takes these as a single value, joined with a colon.
1
In Bookstack, sign in as a user that holds the Access System API and Manage Users and Permissions / Roles permissions.
2
Open Edit Profile > API Tokens and click Create Token. Give it a name (and optionally an expiry date) and save.
3
Bookstack shows the Token ID and Token Secret together once, at creation time. Copy both halves. You will not be able to see the secret again.
4
Join the two halves with a single colon, in the order TokenID:TokenSecret — for example aBcDeFgHiJkLmNoPqRsTuVwX:YzAxMjM0NTY3ODlhYmNkZWZnaGlqa2w. This joined string is the value C1 needs.

​
Configure the Bookstack connector

Follow these instructions to use a built-in, no-code connector hosted by C1.
1
In C1, navigate to Apps > Connectors and click Add connector.
2
Search for Bookstack and click Add.
3
Choose where to add the connector: Create a new app, or Add to an existing app (then select the app).If you’re creating a new app, choose whether to link it to an application discovered from your identity provider: select Yes and pick the IdP application, or No to continue with just the connector.
4
Set the connector’s Name and, optionally, a Description.
5
Click the pencil icon next to Owners to choose who can configure and manage this connector.
6
Click Add. The connector is created and its configuration page opens.
7
Find the Settings area of the page and click Edit.
8
Enter the Bookstack credentials:
  • BookStack Base URL: the origin of your Bookstack instance, with no trailing slash — for example https://bookstack.example.com.
  • BookStack API Token: the Token ID and Token Secret joined with a colon, as TokenID:TokenSecret.
9
Click Save.
10
The connector’s label changes to Syncing, followed by Connected. You can view the logs to ensure that information is syncing.
Done. Your Bookstack connector is now pulling access data into C1.