View a markdown version of this page

管理者管理のセットアップ (サービス認証情報) - Amazon Quick

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

管理者管理のセットアップ (サービス認証情報)

管理者が管理する設定では、管理者は証明書ベースの認証情報を使用してAWS KMS 署名キーと Microsoft Entra ID アプリ登録を設定します。個々のユーザーは、サインインを通じて を承認する必要はありません。Amazon Quick は、組織内のすべてのユーザーの OneDrive コンテンツをクロールします。

管理者管理のセットアップには、ドキュメントレベルのアクセスコントロールリスト (ACL) のサポートが組み込まれています。管理者管理の設定はすべてのユーザーの OneDrive コンテンツをクロールするため、ACL は常に有効になっており、オフにすることはできません。Amazon Quick は、クロールのたびに OneDrive から ACLs同期し、クエリ時に各ユーザーのアクセス許可を検証するため、ユーザーはアクセスが許可されているドキュメントからの回答のみを表示できます。詳細については、「ドキュメントレベルのアクセスコントロール」を参照してください。

前提条件

作業を開始する前に、以下の準備が整っていることを確認します。

  • Amazon Quick 管理コンソールへの管理者アクセス。

  • アプリケーションを登録し、API アクセス許可を付与するための Microsoft Entra ID への管理者アクセス。

  • インデックスを作成する OneDrive コンテンツを持つ Microsoft 365 テナント。

設定の概要

セットアップには以下のフェーズが含まれます。

  1. サービス認証情報の設定 – KMS 署名キーを作成し、証明書を生成して Entra にアプリケーションを登録し、そのキーを使用するためのアクセス許可を Amazon Quick に付与します。詳細については、「サービス認証情報の設定」を参照してください。

  2. Amazon Quick でナレッジベースを作成する – フェーズ 1 のサービス認証情報を使用して OneDrive ナレッジベースを作成します。詳細については、「Amazon Quick でナレッジベースを作成する」を参照してください。

ドキュメントレベルのアクセスコントロールは、すべての管理者管理ナレッジベースで自動的に有効になります。アクセスコントロールの仕組みの詳細については、「」を参照してくださいドキュメントレベルのアクセスコントロール

既知の制限事項

  • OneNote ファイルは、管理者管理のセットアップではクロールされません。Microsoft は、2025 年 3 月 31 日に OneNote APIs のアプリケーション専用トークンを廃止しました。OneNote コンテンツのインデックスを作成するには、 を使用しますユーザー管理のセットアップ

  • 共有フォルダはクロールされません。ユーザーと共有されているフォルダは SharePoint に保存され、管理者管理のセットアップに使用されるアプリケーション認証情報を使用してアクセスすることはできません。共有コンテンツを同期するには、 を作成することをお勧めしますMicrosoft SharePoint ナレッジベースの統合

管理者マネージド接続の管理とトラブルシューティング

統合を編集、共有、または削除するには、「」を参照してください既存の統合の管理

  • KMS キーにアクセスできない – KMS キー ARN とリージョンを検証します。KMS キーが Amazon Quick 管理コンソールの「アカウント、AWSリソースの管理」、AWS「キー管理サービス」で追加されていることを確認します。キーが有効で、削除がスケジュールされていないことを確認します。マルチリージョンキーは現在サポートされていません。

  • 証明書の検証に失敗しました – 証明書生成ステップの base64url エンコードされた SHA-1 値を使用してサムプリントを検証します。Entra にアップロードされた証明書の有効期限が切れていないことを確認します。

  • ACL が適用されない – Microsoft Graph GroupMember.Read.Allで Entra アプリに Files.Read.AllSites.Read.AllUser.Read.All、、Group.Read.All、 があることを確認します。アクセス許可を修正した後、完全同期を再実行します。ドキュメントアクセスの検証の詳細については、「」を参照してくださいドキュメントアクセスの確認 (ACL 検証)

  • クロールされた項目ゼロ — 同期は完了しましたが、インデックスが作成されたドキュメントはありません。これは通常、アクセス許可の問題を示します。Amazon Quick が SharePoint でホストされている OneDrive ドライブを列挙Sites.Read.Allできるように、Entra アプリに正しい API アクセス許可があることを確認します。また、ユーザーに OneDrive コンテンツがあり、管理者の同意が付与されていることを確認します。

  • 証明書の有効期限が切れた後に同期が失敗する – 同じデータソース接続を共有する複数のナレッジベースで同期が失敗した場合、Entra にアップロードされた証明書の有効期限が切れている可能性があります。新しい証明書を生成し (「」を参照ステップ 2: 自己署名証明書を生成する)、Entra アプリ登録にアップロードして、接続の詳細を更新します。Amazon Quick 管理者は、元の作成者が利用できない場合、アセットの管理を通じてデータソースの所有権を再割り当てできます。詳細については、「データソース接続の共有」を参照してください。

  • ACL 対応ナレッジベースからの結果なし – ユーザーが管理ナレッジベースから結果を受信しない場合、リアルタイム ACL アプリケーションの管理者同意が付与されていない可能性があります。テナントはユーザーの同意をブロックすることもできます。Amazon Quick コンソールで提供されているリンクを使用して管理者の同意を付与するか、「」を参照してください管理者の同意

同期モニタリング、レポート、ACL 検証などのその他のトラブルシューティングについては、「」を参照してくださいOneDrive ナレッジベースのトラブルシューティング