About the Administrator Settings
As the name implies, these settings are only visible to users with Administrator privileges. All the settings on this page are accessible by entering Confluence settings and clicking on the "SharePoint Connector" link on the sidebar under the "Configuration" section.
Allowed storage places
By default, users can connect folders from all the storage places supported by the SharePoint Connector app.
Administrators can easily restrict the usage of specific storage places to ensure that the usage of the SharePoint Connector aligns with the company policies.
Disable a storage place for all users
Click the "Places" tab on the SharePoint Connector settings page.
Click the switch on the storage places you want to disable.
The switch changes to the off position to indicate the storage place was disabled, and users can no longer connect folders from that storage place.
Changes to these settings save automatically and apply immediately.
What happens to places the users connected before the Admin disabled them?
If a user connected a folder from a storage place that the Admin later disables, it is blocked inside the SharePoint Connector app. All connected folders from that place are blocked too, and if there are attached folders and files from a blocked storage place, the content won't be visible, and they'll display a warning mentioning the Admin blocked the access.
Re-enable a storage place for all users
Click the "Places" tab on the SharePoint Connector settings page.
Click the switch on the disabled storage place you want to re-enable.
The switch changes to the on position to indicate the storage place is enabled, and users can connect folders from that storage place again.
Changes to these settings save automatically and apply immediately.
Authentication method
The SharePoint Connector app requires user authentication by default to view connected folders and preview and edit attached items. Admins can change this to simplify sharing if there aren't specific user permissions from the cloud storage that need to be replicated on Confluence.
Changing this setting removes connected folders in the file manager. You'll have to connect them again. If you switch to "Require storage authentication," attached files and folders in macros still appear, but you'll need to authenticate with the appropriate account to view the content.
Learn more
Require storage authentication for all storage places
This option is the default setting for new Confluence instances, and admins can apply it to existing ones.
Users need to authenticate to browse connected folders and preview and edit files. Permissions set for users on storage places are applied on Confluence.
Require SharePoint and OneDrive authentication for edit (Legacy)
By selecting this option, admins can set the SharePoint Connector app to apply editing permissions for users from SharePoint and OneDrive.
Users can browse connected folders and preview files, but they must sign in with their Office 365 accounts to edit files so each user has the correct permissions.
Simplified sharing, no authentication required
Admins can select this setting to simplify sharing if there aren't advanced permissions requirements.
Users can browse connected folders and preview and edit files without authenticating on the original storage. Only permissions set on SharePoint Connector and Confluence are applied.
Switching between “Require SharePoint and OneDrive authentication for edit” and the “Simplified sharing” is immediate and saves automatically. Switching to or from “Require storage authentication” opens a dialog with a resume of what will change. The admin needs to confirm to apply the new setting.
Learn more
Attachments layout options
By default, the files and folders attached to Confluence pages use a regular header and appear in the collapsed view to use less space on the screen. It’s easy to preview the file by clicking the arrow to open the expanded view, which uses the width of the page and is 464px tall by default.
The Admin can set different defaults for new macros.
Attachment header
Select the default size for the header of new macros:
Regular: The standard size for the header of attached files and folders. It shows a big icon and additional details;
Compact: Uses a smaller icon and only shows the name of the file or folder;
Hidden for files: Completely hides the header for files and forces the expanded preview option. Moving the mouse over the file will show a compact header.
Preview width
Select the default width for the preview:
Auto: The standard width for previews uses the available space;
Custom: Define a value for the width of the preview area.
Preview height
Select the default height for the preview:
Regular: The standard height for previews (464px);
Custom: Define a value for the height of the preview area.
Preview default visibility
Select the default behavior for the preview:
Collapsed: The standard option that hides the preview;
Expanded: Automatically shows the preview of files and folders. This option is required when selecting the “Hidden for files” header.
Changes to these settings save automatically and apply immediately.
Troubleshooting
The SharePoint Connector app needs access to our services to work correctly, which is an external URL. If you’re experiencing problems accessing the SharePoint Connector app, you can open the “Troubleshoot” tab to check if there’s an issue with the connection to the SharePoint Connector services.
When this tab is accessed, two tests are run:
License Status: checks if your instance has a valid license. If this test fails, please check if you have a valid license for SharePoint Connector on the “Manage apps” page.
Accessing service: checks if your instance can connect to the SharePoint Connector services. If this test fails, please check if the address is whitelisted, as described here. If the problem persists, don't hesitate to get in touch with our support team.
Wrap-up
On this page, you learned about all the Admin settings currently available.
If you still have questions or require other global settings, visit our support portal to send us your questions or feature requests. Our team is always happy to help.