The Confluence integration with Staffbase makes it easier than ever to find content across platforms. With this integration for Front Door Intranet, you can search not only content that lives in the Staffbase platform but also access your Confluence content.
The process to set up the integration is detailed below in the order. It includes:
- Generating an Endpoint for Staffbase to Access the Confluence Instance
- Adjusting the Distribution Status
- Adding the User Identity and Confluence APIs
- Configuring the Confluence API
- Authorizing the API
Prerequisite
You are an Atlassian admin.
Generating an Endpoint for Staffbase to Access the Confluence Instance
- In the Atlassian developer console, click Create > OAuth 2.0 integration.
The page to create a new OAuth 2.0 integration (3LO) opens. - Give the OAuth 2.0 integration a name.
- Select the checkbox to agree with Atlassian’s developer terms.
- Click Create.
You have created an endpoint for Staffbase to access the Confluence instance. Now, you need to adjust the distribution status of your newly created app.
Adjusting the Distribution Status
Your newly created Atlassian app needs to meet a set of requirements regarding the distribution status. Follow these steps to ensure your app is properly configured.
-
In the Atlassian developer console, navigate to My Apps > the app you just created.
-
Navigate to Distribution.
-
Click Edit.
-
Under Distribution Status, select Sharing.
-
Under Personal Data Declaration, select No.
-
Click Save Changes.
You have adjusted the distribution settings. Next, you can add the User Identity API and Confluence API.
Adding the User Identity and Confluence APIs
- In the Atlassian developer console, navigate to My Apps > the app you just created.
- Navigate to Permissions.
- Under User Identity API, click Add.
- Under Confluence API, click Add.
You have added the User Identity API and Confluence API. Now, you need to configure the Confluence API.
Configuring the Confluence API
To properly set up the Confluence Search integration, you need to configure the necessary API scopes in the Atlassian developer console. Follow these steps to enable searching Confluence content.
-
In the Atlassian developer console, navigate to My Apps > the app you just created.
-
Under Confluence API, click Configure.
The page to configure the Confluence API opens.
-
Click Edit Scopes.
-
Select the checkbox Search Confluence content and space summaries.
-
Click Save.
You have configured the Confluence API. Now, you need to authorize the API.
Authorizing the API
To complete the setup, you need to add the callback URL in the Atlassian developer console. Follow these steps to ensure proper authorization with Staffbase.
-
In the Atlassian developer console, navigate to My Apps > the app you just created.
-
Navigate to Authorization.
-
Click Add.
-
In the Callback URL field, enter the following: https://[YOUR_STAFFBASE_DOMAIN]/api/integrations/auth/atlassian/callback.
For example, if your domain is called my_staffbase, enter https://my_staffbase/api/integrations/auth/box/callback
-
Click Save Changes.
You have added the callback URL. Now, you need to copy the Client ID and Client Secret.
Copying the Client ID and Client Secret
Your integration is now properly configured. To add the connection to Staffbase, you need to enter the Client ID and Client Secret. Follow these steps to copy the necessary information from the Atlassian developer console.
-
In the Atlassian developer console, navigate to My Apps > the app you just created.
-
Navigate to Settings.
-
Copy the Client ID and Client Secret.
You have copied the Client ID and Client Secret. Now, you can add the Confluence connection to Staffbase.
Comments
0 comments
Please sign in to leave a comment.