Connect SharePoint to Rovo

はじめる前に

• You need SharePoint global admin permissions to connect SharePoint to Rovo.

• Only Microsoft Excel, PowerPoint, and Word documents are available to Rovo.

Connecting to SharePoint

To get to the setup screen for SharePoint in Atlassian Admin:

1. admin.atlassian.com に移動します。複数の組織がある場合は、組織を選択します。

2. Select Settings > Rovo.

3. Under the Sites tab, next to the site you want to connect, select More actions ( ••• ) and select Add connector.

4. Select Microsoft SharePoint and press Next.

In the Azure portal:

1. Log in to your Azure portal and navigate to Microsoft Entra ID.

2. In the side navigation, under Manage, select App registrations, then New registration.

3. On the Register an application page in the Azure portal, name the connection to Rovo (for example, “Atlassian Rovo”), select Accounts in this organizational directory only, and then select Register.

4. In the side navigation, under Manage, select API permissions.

5. Select Add a permission on the API permissions page, then Microsoft Graph.

6. Select Application permissions and add these permissions:

   1 2 3 4 5 6 7 8 User.Read.All Group.Read.All GroupMember.Read.All Directory.Read.All Files.Read.All Reports.Read.All Sites.Read.All AuditLogsQuery-SharePoint.Read.All

    

7. Select Add permissions.

8. In the side navigation, under Security, select Permissions.

9. Select Grant admin consent for <workspaceName>.

10. Once this is done, back on the Manage > API permissions screen, in the Status column of the table, you should see green ticks and Granted for <workspace> (except the permission User.Read, which doesn't require Admin consent).

11. Go to Overview and copy the following details back into the Atlassian Administration modal:

    1. SharePoint domain name.

    2. Your application ID.

    3. The directory ID.

Next, we need to setup SharePoint permissions:

1. Navigate to <your-sharepoint-domain>-admin.sharepoint.com/_layouts/15/appinv.aspx

2. Using the application ID from above, paste the value in the App ID field and select Lookup.

3. Fill in the next two fields with whatever you would like (these will not be used)

   1. Fill in the App Domain with www.localhost.com

   2. Redirect URL with https://www.localhost.com/

4. Paste the following into the App's Permission request XML:

1. Select Create, and on the next screen read the permissions and select Trust it.

Next, back in the Azure portal create a client secret:

1. Back in your created app in Azure, in the side navigation, under Manage, select Certificates & secrets.

2. Select New client secret.

3. Enter a description for the secret, select an expiry time, and then select Add.

4. Copy the client secret Value.

Finally, back in Atlassian Administration:

1. Enter your copied secret into the Client secret field

2. Review the disclaimer.

3. [保存] を選択します。

Newer SharePoint tenants

If your SharePoint tenant was recently created (post-2019), you also need to enable apps to use ACS app-only access tokens.

In Powershell:

1. Install PnP Powershell Module by running:
   ​Install-Module PnP.PowerShell -Scope CurrentUser

1. Connect to your SharePoint admin domain:
   ​Connect-PnPOnline -Url https://<your-sharepoint-domain>-admin.sharepoint.com

1. If not already registered, register PnP Azure App:
   ​Register-PnPAzureADApp -Interactive

1. Disable enable app authentication:
   ​Set-PnPTenant -DisableCustomAppAuthentication $false

See Microsoft's documentation on ACS app-only access tokens

次のステップ

After you’ve finished Connecting SharePoint:

1. Documents will start to show in Search incrementally over the next few hours.

2. Your team members will see SharePoint show up as a filter option in Search. If they haven’t connected to SharePoint from their Atlassian account, they may be asked to connect before they can see results. This is required so Rovo can make sure your teammates only see results they usually have access to.

3. Depending on the number of documents in SharePoint, it may take some time for all your SharePoint content to be indexed and appear in Search.