The extension to the PDAC1 provides macros to link to and transclude from pages on remote servers.
Typically links to remote servers are fully qualified when copied to a Confluence page. This makes it difficult or cumbersome to change the URL at a later time. For instance the URLs to an API documentation may contain a version information or the URL to the server providing architecture view images changes. The macros provided by this extension makes it easy to deal with such changes by externalizing path prefixes with space properties.
The URL configured with projectdoc (for example as a space property using the url- prefix) needs to find a prefix URL configured as an application link. So the URLS of the system link and the Application Link have to match, not the prefix of your defined url-property and the name of the Application Link The first match is used to authenticate to access a protected resource on the remote service.
Example Box
title
Example
Definition of the space property:
Definition of the Application Link
So the value of the property url-Jenkins mapps to the Display URL of the Application Link
Section
title
OAuth
Currently not supported.
Section
title
Basic Authentication
Basic authentication using HTTP headers is supported.
A Basic Authentication Link is also established using the Application Linksadmin page.
This time you do not create an impersonating OAuth Link but an Application Link with Basic Authentication.
Example Box
title
Example
Create an Application Link and fill in the URL → press "Continue"
Fill in the "Application Name" and press "Continue".
Edit the "Application Link" by clicking the "pencil" icon.
Choose "Outgoing Authentication" and there "Basic Access" and fill in "Username", "Password" and "Confirm Password".
Save.
Section
title
Space Properties
The extension defines the following space properties.