User permissions for publishing setting

In the source space publishing dashboard, a space administrator can select the user permissions in the target space that are used for single-page publishing and space publishing actions:

cpc_publishingdashboard_selectuserpermissionsforpublishingoption_targetspace productdevelopmentpubliccontent.png

By default, for a new space publishing configuration, the Comala Publishing for Confluence Cloud app add-on user permissions in the target space are used for publishing actions.

The choice of user permissions for publishing is set using the Select user performing publishing action dropdown.

cpc_selectuserforpublishing_appuser_selected_dropdownoptions.png

Pages are published using the selected user’s permissions in the target space.

Why use the app add-on user as the user responsible for the publishing action?

Screenshot 2024-11-05 at 14.28.03.png

When publishing is configured to use the app add-on user, only the app add-on user requires edit permission in the target space.

There is no need for a Confluence user who publishes content (a page editor or a space administrator) to have edit permissions in the target space.

Removing user edit permissions in the target space can support compliance with published documents.

Comala Publishing for Confluence Cloud app add-on user space permissions

On installation of Comala Publishing, the app add-on user is automatically added with edit permission in all the spaces on the Confluence site.

cpc_confluencespace_user_publishinguser_permissions_highlighed_min.png

Using the app add-on user permissions to publish pages can support compliance, as a user undertaking a single page or space publishing action does not require edit permission in the target space.

If the app add-on user permissions are not selected, the publishing user must have the required permissions in the target space.

note

The app user permissions are used when publishing occurs using an applied Comala workflow, irrespective of the selected publishing configuration for User publishing permissions.

The app user permissions are used when publishing occurs using an applied Comala workflow, irrespective of the selected publishing configuration for User publishing permissions.

Target space page history

When the Select user performing publishing action option is set as Comala Publishing for Confluence Cloud, the add-on user is recorded in the target space page history.

Initial publish and sync of a page

If the page has not been previously published, publishing and syncing add the app add-on user as the page's owner and creator in the target space.

cpc_onpage_targetspacepage_adonuser_published_owner_creator.png

The Confluence target space page history displays the Comala Publishing for Confluence Cloud app add-on user in the Changed By entry.

cpc_targetspacepage_publishedusing_app_addon_user-permissions_pagecreator.png

Publish and sync a page after the initial publish using the user permissions

If the page has been previously published using the publishing user permissions, the app-add-on user is added as the user who last changed the page in the target space.

cpc_targetspacepage_onpage_addonuserpublishing_previousconfluenceuserpublish.png

The Confluence target space page history displays the Comala Publishing app add-on user in the Changed By entry each time the page is published and synced. The latest Changed By entry also displays the user who initially published the page and is the page creator.

cpc_pagehistory_targetspacepage_initialusepublish_later_addonuserpublish.pngnote

When using a Comala workflow to publish a page and the app add-on user permissions are used for publishing, the add-on user is added to the Changed By entry in the target space page history.

When using a Comala workflow to publish a page and the app add-on user permissions are used for publishing, the add-on user is added to the Changed By entry in the target space page history.

Publishing reports

When the Select user performing publishing action option is set as the app add-on user:

cpc_publishingreport_targetspace_5pages_allsynced_anystate_filter_app_addon_user_lastupdatedby.png

In the source space, the Last updated by and Last synced by values are the Confluence user who triggered the publishing action.

Page analysis tool

In the page analysis diagnostic tool, when the Select user performing publishing action option is set as the app add-on user:

cpc_pageanalysistool_overview_publishasaddonuser_yes.png

When the Publish as add-on user value is NO, the space publishing action uses the current Confluence user permissions for publishing.

The exportable Manifest screen includes a true value for addonUser in the source manifest and isPublishedAsAddon in the space configuration.

cpc_pageanalysistool_manifest_publishasaddonuser_true.png

If the Confluence user permissions are used, the values are set as false.

Page level restrictions

When the app add-on user permissions are used for the publish action on a page with page-level restrictions, the Comala app user must have permission to view and edit the page.

note

A warning message is displayed for a page that cannot be published due to page-level restrictions or space permissions.

A warning message is displayed for a page that cannot be published due to page-level restrictions or space permissions.

Related pages