• 関連ドキュメント

SharePoint を Rovo に接続する

ドキュメントから回答を得たり、ファイルを会社のナレッジとともに管理したりできます。

このコネクターは Rovo 検索でのみサポートされています。Rovo チャットとエージェントにおいて、このコネクターのサポートに積極的に取り組んでいます。

はじめる前に

  • SharePoint を Rovo に接続するには、SharePoint のグローバル管理者権限が必要です。

  • Rovo で利用できるのは、Microsoft Excel、PowerPoint、Word 文書だけです。

SharePoint に接続する

アトラシアンの管理で SharePoint のセットアップ画面を開きます。

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

  2. 設定 > Rovo を選択します。

  3. [サイト] タブで、接続するサイトの横にある [その他のアクション] (•••) を選択し、[コネクタを追加] を選択します。

  4. [Microsoft SharePoint] を選択して [次へ] を押します。

Azure ポータル

1. Azure ポータル (portal.azure.com) にログインして、[Microsoft Entra ID] に移動します。

Azure 管理の [Microsoft Entra ID の管理] オプションのスクリーンショット

2. サイド ナビゲーションの [管理] で、[アプリの登録] > [新規登録] を選択します。

新規登録が強調表示されている [Azure ポータルのアプリ登録] 画面のスクリーンショット

3. Azure ポータルの [アプリケーションの登録] ページで、Rovo への接続に名前 (たとえば「Atlassian Rovo」) を付け、[この組織ディレクトリのみに含まれるアカウント] を選択して、[登録] を選択します。

アプリケーションを登録し、Rovo アプリを設定するための Azure ポータル フォームのスクリーンショット

4. サイド・ナビゲーションの [管理] で [API 権限] を選択し、[API のアクセス許可] ページで [アクセス許可の追加] を選択し、次に [Microsoft Graph] を選択します。

Microsoft Graph が強調表示されている Azure 管理の [API 権限] 画面のスクリーンショット

5. [アプリケーションの許可] を選択し、[すべて表示] を選択します。

[アプリケーション権限] が選択されている API 権限のリクエスト画面のスクリーンショット

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.All

7. [権限を追加] を選択します。

[権限を追加] ボタンが強調表示されている [API権限のリクエスト] 画面のスクリーンショット

8. 追加する権限がもう 1 つありますが、それは別の API にあります。もう一度 [権限を追加] を選択して、今度は [Office 365 管理 API] を選択します。

「権限の追加」と「Office 365 管理 API」がハイライトされている Azure のスクリーンショット

9. [アプリの権限] を選択して ActivityFeed.Read を探します。チェックボックスを選び、[権限を追加] を選択します。

ActivityFeed.Read 権限がチェックされたアプリ権限のスクリーンショット

10. [<workspaceName> に対する管理者の同意を付与] を選択します。

Screenshot of API permissions screen, with Grant admin consent for <workspacename> highlighted

11. これが完了すると、[管理] > [API 権限] 画面に戻ります。テーブルの [ステータス] 列に緑色のチェックマークと「<workspace> に付与されています」と表示されるはずです (管理者の同意を必要としない User.Read 権限を除く)。

各権限タイプに対して「付与」が表示されている Azure の権限リストのスクリーンショット

12. Navigate to Manage > Certificates & secrets, and select New client secret and fill in the form.

Azure ポータルの [クライアント シークレットの追加] 画面のスクリーンショット

13. シークレットを作成したら、"値" フィールドにコピーします。これはすぐに必要になります。

Azure Portal の新しいクライアント シークレットの [値] フィールドのスクリーンショット

14. Go to Overview and copy the following details back into the Admin screen for Rovo Connector:

  • アプリ ID

  • ディレクトリ ID

[ディレクトリ ID] と [アプリケーション (クライアント) ID] のフィールドが強調表示されている、アプリの概要のスクリーンショット

15. Copy the SharePoint domain name from your login. For example, copy the <domain> section of aaaa.bbbb@<domain>.onmicrosoft.com. 

アプリの詳細を入力するアトラシアンの管理の SharePoint のセットアップ画面のスクリーンショット

16. Enter the Client secret value you copied earlier as Client secret.

Microsoft 365 管理センター

1. https://admin.microsoft.com/ にある Microsoft 365 管理者センターにアクセスします。

2. ナビゲーションで、[SharePoint 管理者センター] を選択します。

SharePoint へのナビゲーションが強調表示されている Microsoft 365 管理センターのスクリーンショット

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] に次の内容を貼り付けます。

<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>
SharePoint の権限の要求 XML を追加するフォームのスクリーンショット

6. [作成] を選択し、次の画面で権限を読んで [信頼する] を選択します。

アトラシアンの管理に戻る

最後に、アトラシアンの管理に戻ります。

  1. 免責事項を確認します。

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

新しい 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」を追加します。

リダイレクト URI を追加した PnP Powershell の認証画面のスクリーンショット

5. [概要] に移動して、Application (client) ID をコピーします。これは次のステップで必要になります。

PnP PowerShell の概要画面のスクリーンショット

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 との接続が完了したら、次の手順に従います。

  1. ドキュメントは、数時間かけて徐々に検索に表示されるようになります。

  2. チーム メンバーには、検索のフィルター オプションとして SharePoint が表示されます。Atlassian アカウントから SharePoint に接続していない場合は、結果を確認する前に接続を求められることがあります。これは、Rovo においてチーム メイトに表示する結果をそれぞれのアクセス権に基づいて制限するために必要となります。

  3. SharePoint のドキュメント数によっては、SharePoint のすべてのコンテンツがインデックス化されて検索に表示されるまでに時間がかかる場合があります。

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。
コミュニティに質問
このページの内容はじめる前にSharePoint に接続するAzure ポータルMicrosoft 365 管理センターアトラシアンの管理に戻る新しい SharePoint テナント次のステップ
コミュニティ質問、ディスカッション、記事