Confluence Custom Widget for ServiceDesk Plus On-Premise

Overview:

The Confluence custom widget is designed to seamlessly integrate Confluence with ServiceDesk Plus. This widget enables users to access Confluence pages directly from within ServiceDesk Plus, allowing for quick and efficient referencing of documentation, solutions, and other relevant content.

Installation Guide:

Step 1: Create a Connection in ServiceDesk Plus

Go to Admin -> Developer Space -> Connection.

Create a New Service:

Under Custom Services - > Click on Create Service.

Name the service confluence.

Set the Authentication Type to Basic Auth.

Create a Connection:

After creating the service, click on Create Connection.

Name the connection confluence and click on Create and Connect to authorise the Connection:

Use your Confluence credentials for authorization:

Username: Your Confluence username.

Password: Your Confluence API key. (You can check/create your API keys here)

Step 2: Configure the Widget

1. Download the confluence custom widget zip from here and unzip it.

2. Open the conf.json file in a text editor.

3. Locate the confDomain parameter and update it with your Confluence instance's domain.

Example: "confDomain": "https://your-confluence-instance.atlassian.net"

4. After editing the configuration, re-zip all the files of the widget.

(Important note: Select all the files individually and zip it instead of selecting the folder and zipping it)

Step 3: Upload the Custom Widget

1. Go to Admin -> Developer Space -> Custom Widget.

2.Upload the zipped widget file.

Once uploaded, the widget will be available for use.

Access the Confluence Tab:

1. Navigate to an existing request in ServiceDesk Plus.

2. You should now see a Confluence tab added to the request.

3. Use the widget to search for and view Confluence pages directly within ServiceDesk Plus.

You can search for pages by title or view details of specific pages.

Troubleshooting:

1. If the pages don't load, ensure your Confluence domain is correctly set in the conf.json file and that your connection is authorized.

2. Ensure that your ServiceDesk Plus instance's security settings doesn't contain any CSP headers that might be blocking the widget. If those headers are necessary, please include your Confluence domain as a header as well under Content Security Policy and check the widget.

3. The widget requires an active connection to Confluence with proper authorization. Make sure your API key is valid and has the necessary permissions to access Confluence content.