Marketplace and custom app access rule coverage summary for Confluence Cloud
Marketplace and custom access rule coverage summary for Confluence Cloud
Using Marketplace and custom app access rules, customers can customize and extend Confluence while maintaining control over Marketplace, custom and other third-party app access to certain content in specific spaces.
This page should be read along with Third-party app access rule coverage summary, that provides an overview of the types of Marketplace and custom apps and content that is blocked or not blocked by a Marketplace and custom app access rule.
This page provides a summary of:
Confluence functionality that is blocked when a Marketplace and custom app access rule applies
Confluence functionality that is allowed (NOT blocked) when a Marketplace and custom app access rule applies
Confluence
You can create a Marketplace and custom app access rule to limit an installed app’s ability to access and modify certain data in a Confluence space — particularly user-generated content such as pages, blog posts, attachments, and other content that a user adds to a Confluence space.
When a Marketplace and custom app access rule doesn’t block an installed app from access to data, the installed app will almost always use only a subset of the possible actions rather than all of them. For example, an installed app may need to read but not modify existing content, so it would not use functionality that creates, updates, or deletes content. To better understand the actions your Marketplace and custom apps perform when they have access to a space, check each one’s permissions which can be found on the installed app’s Marketplace listing in the Integration Details section.
Installed apps that are blocked in a space by a Marketplace and custom app access rule may still take other actions that do not interact with user-generated content, such as updating the look and feel of Confluence. Global admin permissions may still be required to run certain installed apps. For example, if a Confluence user does not have admin permissions, they can’t use an installed app to perform administrative functions like adding users.
To view a detailed list of app functionality that is blocked or still allowed when an access rule applies, see App Access for Confluence Cloud REST APIs.
Confluence actions blocked by the Marketplace and custom app access rule
The following commonly-used Confluence functionality is blocked when an installed app is blocked by the Marketplace and custom app access rule. For the full list of blocked functionality, see App Access for Confluence Cloud REST APIs.
Reading the body of, creating, updating, or deleting specific pieces of user-generated content, including permanently deleting content that has already been moved to the trash
pages
blog posts
attachments
comments (inline or page level)
custom (app-defined) content
Retrieving a list of, and returning details about
pages matching specified criteria, such as within a space or with a particular label
blog posts matching specified criteria, such as within a space or blog posts with a particular label
the children, ancestors (parent pages), attachments, or comments for a page
versions of a piece of content, including metadata such as the creator, last update date, and current version number
spaces, with details such as the space key, icon and name, description, permissions that apply to actions on the space, look and feel settings like theme, and the home page.
content matching a CQL search query
Reading, creating, updating, or deleting content properties stored by an installed, for
pages
blog posts
attachments
comments (inline or page level)
custom (installed app-defined) content
Interacting with content in the following additional ways
reading, creating, updating, or deleting restrictions for a piece of content
moving or copying a piece of content to a new location
deleting a specific version of a piece of content, or restoring an old version as the current version of a piece of content
listing information such as
permissions for one or more pieces of content (an admin can list permissions for all pages; a non-admin user can only list their own permissions)
all pages in draft status
users who watched or liked a specific piece of content
content watched or liked by a specific user
tasks that appear on pages
archiving content
retrieving content analytics containing the total number of views and total number of unique user views for a specific piece of content.
applying or removing labels from content
adding or removing a user as a watcher of a space or label
updating the details of a specific task
moving one or more pages in draft status to published status
Confluence actions not blocked by the Marketplace and custom app access rule
There are some elements of app functionality and data that you cannot block with a Marketplace and custom app access rule. Generally, these are related to system-compiled or general data such as app look and feel customizations, Confluence templates, content “watch” information, and user and group management.
The following commonly-used Confluence functionality is not blocked when an installed app is blocked by the Marketplace and custom app access rule. For the full list of app functionality that cannot be blocked by a Marketplace and custom app access rule, see App Access for Confluence Cloud REST APIs.
Auditing
reading or creating audit records
getting or setting retention periods for audit records
Content watchers
listing all users who watched a space or label, or all spaces or labels watched by a particular user
adding or removing a particular user from the list of users watching a specific label or space
Dynamic modules
using dynamic modules that provide customized behavior to different users
listing all dynamic modules registered by this installed app
registering dynamic modules so that they can be used by this installed app, and removing them so that they can no longer be used by this installed app
Group management
listing all user groups on the installed app user’s current Confluence instance
reading information about a Confluence user group, including the group name and internal group ID
adding or removing Confluence user groups
listing the users who are members of a Confluence user group
adding and removing members from a Confluence user group
Operation management
listing the permitted operations for the space. Operations are actions that a user or API is permitted to take on a specific piece of content or space. Examples include, but are not limited to, create, read, update, delete, copy, export, and purge.
Confluence settings
reading, resetting to the system default, or updating “look and feel” settings for a Confluence space (theme in use, color used for menus, and so on)
Spaces
creating, updating the details of spaces
reading the details of a space including its name, homepage, status, type, and permissions for the space and pages, blog posts, comments, attachments, and installed apps within that space
listing the spaces in a Confluence instance
listing, adding and removing permissions for a user, group, or role to a particular space
listing, adding, updating, and removing properties of a space
Templates
listing all templates for a site or space, including blueprint templates
adding, updating, or removing a template
Themes
listing all admin-driven themes that an admin installs from the marketplace into a space or site
resetting a space’s theme to the global admin-driven theme
reading information about a theme
listing the current theme in use for a space, and updating which theme is used for a space
listing the global admin-driven theme for the Confluence instance
User management
reading the details for one or more users at a time, such as their account ID, display name, space name, email address, profile picture, and Confluence permissions
reading the details of the Confluence instance’s anonymous user account, including its display name, profile picture or icon, and Confluence permissions (the anonymous user account provides generic user details for users who are not logged in to Confluence)
getting the account ID of the user who is running the installed app and reading the details for that user
listing information for a user such as:
the Confluence groups to which that user belongs
values of user properties defined at the site level for that user
creating, updating, and deleting user properties for a specific user
Related links:
Was this helpful?