How can I integrate external HTML pages in Confluence?

I have some HTML pages generated by a tool from source code that describe APIs for in-house usage. It would be great if I could integrate these HTML pages into Confluence so that users that are logged in to Confluence can see the pages and non-authenticated users cannot.

How can I integrate these external pages? Is it possible with plugins?

Background:

My team tries to replace our current MediaWiki instance with Confluence. In MediaWiki we used a simple Special-Pages plugin to integrate external pages.

The external HTML pages that I try to include are generated by NaturalDocs. See http://www.naturaldocs.org/documentation/html/for an example of how the HTML output is structured (relative links, stylesheets, javascript).

2 answers

1 accepted

0 vote
Davin Studer Community Champion Dec 10, 2013

You can use the HTML Include macro for this. You will need to also configure your whitelist (Confluence Admin->Configuration->Configure Whitelist) to allow you to pull in content from the other site.

I have tested both the "HTML Include" Macro that comes with Confluence and the "HTML Include Replace" plugin from the marketplace.

The built-in macro has the problem that relative links are not handled properly (see CONF-6567) and the third-party plugin requires the user to already have access to the external HTML pages. But this is why I wanted to integrate the pages in the first place (a catch-22).

If your tool generated HTML content is not protected, just obscurely served, then would including the content from Confluence, and making the space/page not visible to people who aren't logged in address the visibility?

What do you mean with "obscurely served"? Just not mentioning the URL outside of the protected Confluence pages? That would be a bit too weak, I guess.

My current thinking is about writing an Apache auth module for the external HTML pages which connects to the Confluence SQL database backend directly.

Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Published Thursday in Confluence

Three common content challenges + how to manage them

An efficient enterprise content management system, or ECM, is a must-have for companies that create work online (cough   cough, all companies). If content calendars, marketing plans, and bu...

86 views 0 6
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you