Setup Confluence Graph Connector in Microsoft 365 Admin Center

A guide for administrators to connect Confluence Cloud with Microsoft Graph

1. Add a connector in the Microsoft 365 admin center.

Go to settings > Microsoft search > connectors > Add

Select Confluence connector from list.

2. Name the connection

• Name (required)
• Connection ID (unique)
• Description (optional)
• Select check box (required)

3. Configure the connection settings.
   1. To connect to your Confluence site, use your site URL. A Confluence cloud site URL   typically looks like https://<organization_name>.atlassian.net/. 
   2. Choose OAuth 2.0 to authenticate to your Confluence site.
   3. Register an app in Confluence Cloud so that the Microsoft Search app can access the instance. To learn more, see Atlassian Support documentation on how to Enable OAuth 2.0.
   4. The following steps provide guidance on how to register the app:
      • Sign in to Atlassian Developer console with your Atlassian Confluence admin account.
      • Click on Create and select OAuth 2.0 integration.
      • Provide an appropriate name for the application and create the new app.
      • Navigate to Permissions from the navigation pane on left. Click Add for Confluence API. Once added, click on Configure, Edit Scopes and select the following scopes.

• Click Save.
• Navigate to Authorization from the navigation pane on the left. Add the callback URL,

for M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback

for M365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback

and save the changes.

• Navigate to Settings from the navigation pane on left. You'll get the Client ID and Secret from this page.
• Complete the connection settings step using the Client ID and Secret.

4. Select properties and filter data.
   1. Keep the default or select as per your requirement.
5. Manage search permissions
   1. Select Only people with access to this data source.
   2. To identify which option is suitable for your organization:
      • Choose the Microsoft Entra ID option if the email ID of Confluence users is same as the UserPrincipalName (UPN) of users in Microsoft Entra ID.
      • Choose the Non-AAD option if the email ID of Confluence users is different from the UserPrincipalName (UPN) of users in Microsoft Entra ID.
      • Note :- Basically we have to map a confluence user to Microsoft user.
      • If you chose "Non-AAD" for the identity type see Map your non-Azure AD Identities for instructions on mapping the identities. You can use this option to provide the mapping regular expression from Email ID to UPN.

6. Assign property labels.

Keep default or change label if you found inappropriate mapping.

7. Manage schema.

Select checkbox as per requirements.

8. Choose refresh settings

Keep default or you can change as per requirements.

9. Review Connection & Publish

For more information, you can visit the following links:

• Confluence Graph Connector documentation
• Implementing open enterprise search with Microsoft Graph connectors
• Microsoft Graph Connector for ServiceNow explained user mapping.