| Excerpt |
|---|
Administrators can adjust how the SharePoint Connector app works to meet your team's needs and comply with company policies. |
...
Administrators can easily restrict the usage use of specific storage places to ensure that the usage of the SharePoint Connector's use aligns with the company policies.
...
Turn off a storage place for all users
...
| Info |
|---|
Changes to these settings are saved automatically and applied immediately. |
Replicate storage permissions
...
. |
Admins can change this to simplify sharing if specific user permissions from the cloud storage don't need to be replicated on Confluence.
...
| Note |
|---|
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. |
What changes
Remember that this option requires users to sign in to each connected folder to view and edit the files and apply the correct permissions for each user. Learn more
Applying "Replicate storage permissions"
Click the "Simplified sharing (…)" section on the SharePoint & OneDrive settings page;
Click the toggle to turn on the option “Replicate storage permissions.”
| Info |
|---|
Changing this setting saves automatically and applies immediately. |
Deactivating "Replicate storage permissions"
Click the "Cloud storage access and permissions required" section on the SharePoint & OneDrive settings page;
Click the toggle to turn off the option “Replicate storage permissions.”
| Info |
|---|
Changing this setting saves automatically and applies immediately. |
...
Attachments layout options
...
| Info |
|---|
Changes to these settings are saved automatically and applied immediately. |
Troubleshooting
If you don’t have the “Replicate Storage permissions” option active, the SharePoint Connector app needs access to our services, which are an external URL, to work correctly. 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.
...
Enable advanced SharePoint authentication
With this configuration active, the end user's client (i.e., browser) handles all communication between Confluence and SharePoint. Therefore, to use this mode in the app, the user needs access to both systems and a browser running on the local machine. The same principle applies to administration and the initial setup.
| Info |
|---|
Confluence must be accessed via HTTPS (SSL) |
...
Prerequisites for searching documents and lists from Confluence macros
Signed in users should have at least read access to the SharePoint site collection to perform search queries on SharePoint files and folders.
...
Create an Application on Azure Active Directory
Display Name and Application ID
| Info |
|---|
This step is required for the Confluence SharePoint Connector app to send authenticated requests to SharePoint. |
To access SharePoint, the SharePoint Connector App must be registered as an Azure Active Directory (Azure AD) application. After a user is authenticated, this registration process involves giving Azure AD details about the SharePoint Connector, such as the address to which replies should be sent.
| Info |
|---|
The Azure portal's current look might differ from this guide, as Microsoft frequently updates its user interface screenshots. |
Register Application in Azure AD
| Info |
|---|
Make sure to choose the right Azure AD if your account can access multiple directories on the Azure Portal |
Go to All Services > App registrations;
...
Select New registration;
In the Register an application view, enter the Name and choose Supported account types;
Click Register.
You successfully registered a new application.
Configure Application in Azure AD
Just select the application you created in the previous step.
| Info |
|---|
If you are unable to find your application, make sure you have selected the "All applications" tab. |
Note: the Display Name and Application ID might be different for you.
The application's Overview page will open.
...
Make note of the Application (client) ID. You'll need it later.
Add Redirect URIs
Go to the Authentication tab and click on Add a platform;
...
On Configure platforms, select Web;
...
Next, add the SharePoint Connector App Redirect URIs and click on Configure;
...
Samples for Redirect URIs (use your instance URL):
Click on Save to save the changes.
Set API Permissions
You can go to the application's API Permissions page;
Request API permissions
...
Note: The Microsoft Graph API permission: "User.Read" should already be present.
Select Add Permission. The Request API permissions panel will open on the right;
...
In Microsoft APIs tab, find and select the SharePoint box. Choose Delegated Permissions as the type of permissions your application requires;
| Info |
|---|
Delegated means the permission needs a signed-in user and actions are performed in the context of this user. The user will just be able to access data that he is already allowed to access in SharePoint directly. Our app is not able to access any data without a user. |
Expand AllSites and select the following permissions:
AllSites.Manage
...
Confirm by clicking Add permissions button on the bottom of the panel;
The permissions are now listed in the application's API Permissions table.
...
In the Grant consent section of the API Permissions page, click the "Grant admin consent for ..." button;
...
Confirm by selecting Yes on the confirmation dialog at the top of the page.
| Info |
|---|
Granting consent means a user authorizes an application to access protected resources on their behalf. Granting admin consent to all users ensures that every user can use the SharePoint macros in Confluence. |
Now, you can go to Certificates & Secrets and create a New client secret. Give the name you like to it.
...
Client secret values cannot be viewed except immediately after creation. Be sure to save the secret when created before leaving the page.
...
Note the Application ID
You'll need the application ID that you got in step Configure Application in Azure AD.
Note the Directory ID
On the Azure portal, check for Directories and save the Directory ID.
...
Note: Hovering sometimes fails in specific browsers. You can use another browser if this happens.
| Info |
|---|
You can avoid typing this ID by navigating to Azure Active Directory -> Properties where you can copy the Directory ID to the clipboard |
After following above steps, you should now have the following information noted and available for upcoming configuration steps:
Application ID
Azure Active Directory ID
...
Configuration of the SharePoint Connector App for Confluence
Navigate to Global Administration (cog icon) > Configuration > SharePoint & OneDrive Settings > Configure SharePoint connection and enter the required values.
| Info |
|---|
You get the required configuration values by following the configuration steps described above. |
Afterward, you can Submit the entered values and go to the app File Manager in any Confluence Space to test the connection.
...
Wrap-up
On this page, you learned about all the Admin settings currently available.
...