SharePoint を Rovo に接続する
ドキュメントから回答を得たり、ファイルを会社のナレッジとともに管理したりできます。
What is indexed?
The SharePoint connector indexes these objects:
Word Documents (.doc, .docx)
Excel Spreadsheets (.xls, .xlsx)
PowerPoint Presentations (.ppt, .pptx)
PDFs (maximum 10 MB)
For each object, it indexes these attributes:
名前
URL
createdDate
最終更新日
作成者
協力者
Document body
はじめる前に
SharePoint を Rovo に接続するには、SharePoint のグローバル管理者権限が必要です。
Rovo は常に権限を遵守します。ユーザーには、すでにアクセス権があるファイルのみが表示されます。
SharePoint に接続する
アトラシアンの管理で SharePoint のセットアップ画面を開きます。
Go to admin.atlassian.com. Select your organization if you have more than one.
Select Apps > AI settings > Rovo.
Under Sites, next to the site you want to connect, select Add connector.
[Microsoft SharePoint] を選択して [次へ] を押します。
Azure ポータル
1. Log in to your Azure portal (portal.azure.com) and navigate to Microsoft Entra ID.
2. サイド ナビゲーションの [管理] で、[アプリの登録] > [新規登録] を選択します。
3. Azure ポータルの [アプリケーションの登録] ページで、Rovo への接続に名前 (たとえば「Atlassian Rovo」) を付け、[この組織ディレクトリのみに含まれるアカウント] を選択して、[登録] を選択します。
4. サイド・ナビゲーションの [管理] で [API 権限] を選択し、[API のアクセス許可] ページで [アクセス許可の追加] を選択し、次に [Microsoft Graph] を選択します。
5. [アプリケーションの許可] を選択し、[すべて表示] を選択します。
6. 以下の権限を 1 つずつコピーして、検索行に貼り付けます。チェックボックスをクリックします。すべての権限について繰り返します。
Directory.Read.All
Files.Read.All
Group.Read.All
GroupMember.Read.All
User.Read.All
Reports.Read.All
Sites.Read.All
AuditLogsQuery-SharePoint.Read.All7. [権限を追加] を選択します。
8. 追加する権限がもう 1 つありますが、それは別の API にあります。もう一度 [権限を追加] を選択して、今度は [Office 365 管理 API] を選択します。
9. [アプリの権限] を選択して ActivityFeed.Read を探します。チェックボックスを選び、[権限を追加] を選択します。
10. [<workspaceName> に対する管理者の同意を付与] を選択します。
11. これが完了すると、[管理] > [API 権限] 画面に戻ります。テーブルの [ステータス] 列に緑色のチェックマークと「<workspace> に付与されています」と表示されるはずです (管理者の同意を必要としない User.Read 権限を除く)。
12. Navigate to Manage > Certificates & secrets, and select New client secret and fill in the form.
13. Once you’ve created a secret, copy the Value field (not the Secret ID, note the screenshot below). You’ll need this soon.
14. Go to Overview and copy the following details back into the Admin screen for Rovo Connector:
アプリ ID
ディレクトリ ID
15. Copy the SharePoint domain name from your login. For example, copy the <domain> section of aaaa.bbbb@<domain>.onmicrosoft.com.
16. Enter the Client secret value you copied earlier as Client secret.
Microsoft 365 管理センター
1. Go to the Microsoft 365 admin center at https://admin.microsoft.com/.
2. ナビゲーションで、[SharePoint 管理者センター] を選択します。
3. 新しく作成したプリンシパルに権限を付与する必要があります。テナントをスコープとした権限の付与なので、テナント管理サイトの appinv.aspx ページからのみ実行することができます。ブラウザで次の URL を開くと、このサイトにアクセスできます。
<your-sharepoint-domain>-admin.sharepoint.com/_layouts/15/appinv.aspx
There is no other way to navigate to this page. For more information, see the Azure documentation on granting permissions.
4. 先ほど Azure ポータルでコピーしたアプリケーション ID を使用して、 [ アプリ ID ] フィールドに値を貼り付けて [検索] を選択します。
5.次に、SharePointの権限を設定する必要があります。[アプリ ドメイン] と [リダイレクト URL] に任意の値を入力してください (これらは使用されません)。
[アプリ ドメイン] に「
www.localhost.com」と入力します。[リダイレクト URL] に「
https://www.localhost.com/」と入力します。[アプリの権限要求 XML] に次の内容を貼り付けます。
<AppPermissionRequests AllowAppOnlyPolicy="true"> <AppPermissionRequest Scope="http://sharepoint/content/tenant" Right="Read" /> <AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="Read" /> <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read" /></AppPermissionRequests>
6. [作成] を選択し、次の画面で権限を読んで [信頼する] を選択します。
In Atlassian Administration
最後に、アトラシアンの管理に戻ります。
(Optional) Choose content to include. You can choose to limit SharePoint content by:
Allowlist and blocklist: Specifying site or subsite URLs to block or allow. More on blocking and allowing content
Limiting by date: Only content modified or created since a specified date will be added.
免責事項を確認します。
[保存] を選択します。
新しい SharePoint テナント
If your SharePoint tenant was recently created (post-2019), you also need to enable apps to use ACS app-only access tokens. You must run on your local Windows machine. If you only have a Mac, follow these steps to install the latest version of PowerShell on MacOS.
マイクロソフト Powershell を開きます。
1. 次のコマンドを実行して PnP Powershell モジュールをインストールします。
Install-Module PnP.PowerShell -Scope CurrentUser
2. 次に、以下を実行します。Register-PnPEntraIDApp -ApplicationName "PnP PowerShell" -Tenant <your-sharepoint-domain>.onmicrosoft.com -Interactive
これにより、ログインするためのブラウザ ウィンドウが開きます。
ログインすると、コマンドは正常に完了します。
3. 新しいウィンドウで、[Microsoft Entra] > [アプリケーション] > [アプリ登録] で新しく作成された PnP Powershell アプリケーションに移動し、アプリケーション リストから [PnP Powershell] を選択します。
4. [管理] > [認証] の [モバイルとデスクトップ アプリケーションのリダイレクト URI] の見出しの下に「http://localhost:55592」を追加します。
5. [概要] に移動して、Application (client) ID をコピーします。これは次のステップで必要になります。
6. PowerShell で、SharePoint ドメインと、先ほどコピーしたばかりのApplication (client) IDを使って、以下を実行します。Connect-PnPOnline -Url https://<your-sharepoint-domain>-admin.sharepoint.com -ClientId <Application (client) ID> -Interactive
これにより、ログインするためのブラウザ ウィンドウが開きます。
ログインすると、コマンドは正常に完了します。
7. PowerShell で以下を実行します。Set-PnPTenant -DisableCustomAppAuthentication $false
ACS アプリ専用アクセス トークンに関する Microsoft のドキュメントを参照してください。
次のステップ
SharePoint との接続が完了したら、次の手順に従います。
ドキュメントは、数時間かけて徐々に検索に表示されるようになります。
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.
SharePoint のドキュメント数によっては、SharePoint のすべてのコンテンツがインデックス化されて検索に表示されるまでに時間がかかる場合があります。
この内容はお役に立ちましたか?