SharePoint を Rovo に接続する
ドキュメントから回答を得たり、ファイルを会社のナレッジとともに管理したりできます。
このコネクターは Rovo 検索でのみサポートされています。Rovo チャットとエージェントにおいて、このコネクターのサポートに積極的に取り組んでいます。
はじめる前に
SharePoint を Rovo に接続するには、SharePoint のグローバル管理者権限が必要です。
Rovo で利用できるのは、Microsoft Excel、PowerPoint、Word 文書だけです。
SharePoint に接続する
アトラシアンの管理で SharePoint のセットアップ画面を開きます。
admin.atlassian.com に移動します。複数の組織がある場合は、組織を選択します。
設定 > Rovo を選択します。
[サイト] タブで、接続するサイトの横にある [その他のアクション] (•••) を選択し、[コネクタを追加] を選択します。
[Microsoft SharePoint] を選択して [次へ] を押します。
Azure ポータル
1. Azure ポータルにログインし、Microsoft Entra ID に移動します。
2. サイド ナビゲーションの [管理] で、[アプリの登録] > [新規登録] を選択します。
3. Azure ポータルの [アプリケーションの登録] ページで、Rovo への接続に名前 (たとえば「Atlassian Rovo」) を付け、[この組織ディレクトリのみに含まれるアカウント] を選択して、[登録] を選択します。
4. サイド・ナビゲーションの [管理] で [API 権限] を選択し、[API のアクセス許可] ページで [アクセス許可の追加] を選択し、次に [Microsoft Graph] を選択します。
5. [アプリケーションの許可] を選択し、[すべて表示] を選択します。
6. 以下の権限を 1 つずつコピーして、検索行に貼り付けます。チェックボックスをクリックします。すべての権限について繰り返します。
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.All7. [アクセス許可の追加] を選択します。
8. [<workspaceName> に管理者の同意を与えます] を選択します。
9. これが完了すると、[管理] > [API のアクセス許可] 画面に戻ります。テーブルの [状態] 列に緑色のチェックマークと「<workspace> に付与されています」と表示されるはずです (管理者の同意を必要としない User.Read 権限を除く)。
10. [管理] > [証明書とシークレット] に移動し、[新しいクライアント シークレット] を選択してフォームに入力します。
11. シークレットを作成したら、[値] フィールドにコピーします。これはすぐに必要になります。
12. [概要] に移動し、次の詳細を Rovo コネクタの管理画面にコピーします。
アプリ ID
ディレクトリ ID
13. ログイン情報から SharePoint のドメイン名をコピーします。たとえば、aaaa.bbbb@<domain>.onmicrosoft.com から <domain> のセクションをコピーします。
14. 先ほどコピーしたクライアント シークレットの値を、クライアント シークレットとして入力します。
Microsoft 365 管理センター
1. https://admin.microsoft.com/ にある Microsoft 365 管理者センターにアクセスします。
2. ナビゲーションで、[SharePoint 管理者センター] を選択します。
3. 新しく作成したプリンシパルに権限を付与する必要があります。テナントをスコープとした権限の付与なので、テナント管理サイトの appinv.aspx ページからのみ実行することができます。ブラウザで次の URL を開くと、このサイトにアクセスできます。
<your-sharepoint-domain>-admin.sharepoint.com/_layouts/15/appinv.aspx
他の方法ではこのページに移動できません。詳細については、権限の付与に関する Azure のドキュメントを参照してください。
4. 先ほど Azure ポータルでコピーしたアプリケーション ID を使用して、 [ アプリ ID ] フィールドに値を貼り付けて [検索] を選択します。
5.次に、SharePointの権限を設定する必要があります。アプリ ドメイン とリダイレクト URL に任意の内容を入力します (これらは使用されません)。
[アプリ ドメイン] に「www.localhost.com」と入力します。
[リダイレクト先の URL に「https://www.localhost.com/」と入力します。
[アプリの権限要求 XML] に次の内容を貼り付けます。
1
<AppPermissionRequests AllowAppOnlyPolicy="true"> <AppPermissionRequest Scope="http://sharepoint/content/tenant" Right="FullControl" /> <AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="FullControl" /> <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="FullControl" /></AppPermissionRequests>6. [作成] を選択し、次の画面で権限を読んで [信頼する] を選択します。
アトラシアンの管理に戻る
最後に、アトラシアンの管理に戻ります。
免責事項を確認します。
[保存] を選択します。
新しい SharePoint テナント
SharePoint テナントが最近 (2019 年以降) 作成されたものである場合は、アプリが ACS アプリ専用アクセス トークンを使用できるようにする必要もあります。ローカルの Windows マシンで実行する必要があります。Mac しかない場合は、次の手順に従って MacOS に PowerShell をインストールしてください。
マイクロソフト 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 との接続が完了したら、次の手順に従います。
ドキュメントは、数時間かけて徐々に検索に表示されるようになります。
チーム メンバーには、検索のフィルター オプションとして SharePoint が表示されます。Atlassian アカウントから SharePoint に接続していない場合は、結果を確認する前に接続を求められることがあります。これは、Rovo においてチームメイトに表示する結果をそれぞれのアクセス権に基づいて制限するのに必要です。
SharePoint のドキュメント数によっては、SharePoint のすべてのコンテンツがインデックス化されて検索に表示されるまでに時間がかかる場合があります。
この内容はお役に立ちましたか?