Confluence Cloud Access Requirements

Confluence Cloud Access Needs

For Confluence Cloud, Moveworks requires a dedicated Service Account. API access is done via basic auth and requires a username and token, which needs to be generated by logging in as the Service Account user.

The Service Account must have read access to the necessary Confluence spaces where end-user knowledge articles reside.

It is okay to have SSO in the case of cloud, as Moveworks will be able to use the API token without requiring the local password of the user. Please note that Global API tokens will not work for the integration.

Here are the steps to create an API token for a Confluence Service Account:

  1. Log in to https://id.atlassian.com/manage/api-tokens using the Service Account user credentials.
  2. Click Create API token.
  3. From the dialog that appears, enter a label for the token (Moveworks) and click Create.
  4. Click Copy to clipboard and store the token for the next steps

More detailed information here: https://confluence.atlassian.com/cloud/api-tokens-938839638.html

After creating the token, you can use the curl command below to test that the access is working as expected:

curl -v https://company.atlassian.net/rest/servicedeskapi/servicedesk --user moveworksaccount@company.com:my-api-token

Create the Connector in Moveworks Setup

Navigate to Core Platform > System Connectors and create a new connector. Select Confluence and enter the information below:

  • Connection Name: confluence (recommended)
  • Base Url: Enter the URL of your Atlassian instance
  • Authentication Type: Basic Auth
  • Username: Enter the username of the service account created earlier
  • Password: Enter the API token created earlier