1. Overview

We continue our series of articles about the integration of the ONLYOFFICE online editors into open-source web services. This office suite has recently got a new name: it’s called now ONLYOFFICE Docs. In the previous articles, you have learned how to connect online editors to Alfresco, Nextcloud, and Moodle instances.

As a reminder, you can bring collaborative document editing to your favorite sync&share platform like ownCloud, SharePoint, Seafile, Liferay, Plone, Nuxeo, and many others via ready-to-use connectors developed by ONLYOFFICE or its official technology partners. It’s also possible to integrate ONLYOFFICE Docs into the solution you’re building yourself. To learn more about available editing and co-editing features, refer to this article.

In this tutorial, we will describe how you can enable ONLYOFFICE Docs in Confluence, a collaborative software developed by Atlassian. With a focus on content management and sharing, Confluence allows organizing project work around files and build collaborative content creation environment combined with knowledge platform with wiki, discussions, blogs and calendars.

What you’ll learn

This guide will describe how to connect ONLYOFFICE Docs and Confluence to each other via the integration app that enables multiple users to edit office documents from Confluence using ONLYOFFICE Docs, and allows multiple users to collaborate in real time and to save back those changes to Confluence

What you’ll need

  • ONLYOFFICE Docs
  • Confluence environment (There are a number of ways to install Confluence. To choose the method that that suits you better, check the installation guide.)
  • ONLYOFFICE connector for Confluence

2. Installing ONLYOFFICE Docs

You will need an instance of ONLYOFFICE Docs that is resolvable and connectable both from Confluence and any end clients. ONLYOFFICE Docs must also be able to POST to Confluence directly.

To install ONLYOFFICE, read this article to check the software requirements and instructions.


3. Installing the ONLYOFFICE connector for Confluence

The ONLYOFFICE connector for Confluence is distributed now under the Apache License 2.0. You can download its latest version from the official Atlassian Marketplace. To install the integration app, follow these instructions:

  • Log into your Confluence instance as an administrator.
  • Click the admin drop-down box and choose Manage apps. The Manage apps screen loads.
  • Click Find new apps from the left-hand side of the page.
  • Locate ONLYOFFICE Connector for Confluence via search. Results will include the versions of the app compatible with your Confluence instance.
  • Click Install to download and install your app
  • Now you can click Close in the Installed and ready to go dialog.

You are also able to compile the connector yourself by performing these easy steps or get the latest compiled package files from GitHub.


4. Configuring the ONLYOFFICE connector for Confluence

Find the uploaded ONLYOFFICE Confluence plugin on the Manage apps page.

Specify the URL of ONLYOFFICE Document Editing Service: enter the inner address (the address that Confluence will use to access the service) and the public address (the address that you will use to access the editors).

You can also protect your data and secure your traffic using JSON Web Tokens (JWT) standard. To do that, set up a JWT Secret key to be used for generating a token that the Document Editing Service will use to verify commands from the client/editor. In the ONLYOFFICE Docs config file specify the same secret key and enable the validation.


5. Using ONLYOFFICE Docs within your Confluence environment

Once installed, the ONLYOFFICE Connector for Confluence will create a new Edit in ONLYOFFICE action within the document library for office documents.

Now, you are able to:

  • Create and edit DOCX, XLSX, PPTX documents.
    1-Pivot-tables

  • Convert ODT, DOC, ODP, PPT, ODS, XLS files to the corresponding Office Open XML formats.

  • Share documents with other users using flexible document permissions (read-only, review, comment, fill forms, modify filters).

  • Co-edit documents in real-time with two co-editing modes (real-time and paragraph-locking co-editing modes), track changes, comments, built-in chat, document comparison, and version history.