What does this connector do?

The confluence content widget allows users to create a connection between confluence and ControlMap and then use that connection to embed content directly from Confluence pages into ControlMap.

This connection allows teams to maintain their policy, procedure, and governance documents in Confluence while maintaining the controls mapping and other relationships for audit purposes in ControlMap.

Connecting to Confluence

ControlMap uses an API token and a Username (preferably a service account) for a Confluence user to connect to confluence. ControlMap uses the permissions granted to this user to connect to ControlMap.

Step 1 - Creating an API Token in Confluence

Browse to the following link https://id.atlassian.com/manage-profile/security/api-tokens and click on Create API token button.

Name the token 'controlmap-api-token'

On the next screen, COPY the token. You will provide 

Step 2 - Configuring ControlMap

Once you record the API token, In ControlMap, go to Integrations > Create New Integration > Confluence

Provide the following details 

1. Name of the connection (Something you can relate to, i.e. IT Confluence for Policy Documents)  

2. The base URL of your confluence instance. For example, https://controlmap.atlassian.net

3. Email address of the users with which you logged in to Confluence to create the connection 

4. API token created in the previous steps  

Click Save Connection to connect and exit. 

Step 3 - Setting up the widget.

You can create a policy, procedure or a governance document by embedding content from Confluence.  

To create a policy with Confluence content, go to Policies > Actions > Add from Confluence

In the confluence content viewer provide the Page ID of a confluence page 

How to find the ID of a confluence page 
Page Id is an 8-digit number allocated to each Confluence page. (Some newer pages have 6 digits) There are more than one ways to find the page of the confluence page 

1. From the Page Information screen

2. From the  page URL