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 ポータルにログインし、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 つずつコピーして、検索行に貼り付けます。チェックボックスをクリックします。すべての権限について繰り返します。

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. [アクセス許可の追加] を選択します。

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

8. [<workspaceName> に管理者の同意を与えます] を選択します。

[<workspacename> に管理者の同意を与えます] が強調表示されている API 権限画面のスクリーンショット

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

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

10. [管理] > [証明書とシークレット] の順に移動して、[新しいクライアント シークレット] を選択してフォームに入力します。

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

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

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

12. [概要] に移動し、次の詳細を Rovo コネクタの管理画面にコピーします。

  • アプリ ID

  • ディレクトリ ID

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

13. ログイン情報から SharePoint のドメイン名をコピーします。たとえば、aaaa.bbbb@<domain>.onmicrosoft.com から <domain> のセクションをコピーします。 

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

14. 先ほどコピーしたクライアント シークレットの値を、クライアント シークレットとして入力します。

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] に任意の値を入力してください (これらは使用されません)。

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

  • Redirect URL with 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. Under Manage > Authentication, under the Mobile Desktop and Application Redirect URIs heading, add http://localhost:55592

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

5. Navigate to Overview and copy the Application (client) ID. You’ll need this for the next step.

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 のすべてのコンテンツがインデックス化されて検索に表示されるまでに時間がかかる場合があります。

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

アトラシアン コミュニティをご利用ください。