Confluence コネクタ V1.0 - Amazon Kendra
サポートされている機能前提条件接続手順詳細はこちら

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

Confluence コネクタ V1.0

Confluence は、プロジェクト計画、ソフトウェア開発、製品管理の共有、保存、作業を目的とした共同作業管理ツールです。Amazon Kendraを使用して、Confluence スペース、ページ (ネストされたページを含む）、ブログ、およびコメントと添付ファイルのインデックスを、インデックス付きページとブログに作成できます。

注記

Confluence Connector V1.0 / ConfluenceConfiguration API は 2023 年に終了しました。Confluence コネクタ V2.0/TemplateConfiguration API に移行するか、こちらを使用することをお勧めします。

Amazon KendraConfluence データソースコネクタのトラブルシューティングについては、「」を参照してくださいデータソースのトラブルシューティング。

サポートされている機能

Amazon KendraConfluence データソースコネクタは、次の機能をサポートしています。

  • フィールドマッピング

  • ユーザーアクセスコントロール

  • 包含/除外フィルター

  • (Confluence サーバーのみ) 仮想プライベートクラウド (VPC)

前提条件

Amazon Kendraを使用して Confluence データソースのインデックスを作成する前に、Confluence とAWSアカウントでこれらの変更を行います。

Confluence で以下を確認してください。

  • Confluence インスタンス内のすべてのコンテンツを表示するアクセスAmazon Kendra許可を付与します。

    • confluence-administrators グループのメンバーAmazon Kendraを作成する。

    • 既存のすべてのスペース、ブログ、ページにサイト管理者アクセス許可を付与する。

  • Confluence インスタンスの URL をコピーしました。

  • SSO (シングルサインオン) ユーザー向け: Confluence データセンターで Confluence 認証方法を設定するときに、ユーザー名とパスワードの [ログインページに表示] をアクティブ化しました。

  • Confluence サーバー用

    • Amazon Kendra に接続するための Confluence 管理アカウントのユーザー名とパスワードを含む基本認証情報を記録しました。

      注記

      認証情報とシークレットは、定期的に更新またはローテーションすることをお勧めします。セキュリティに必要なアクセスレベルのみを提供してください。認証情報とシークレットを、データソース、コネクタバージョン 1.0 と 2.0 (該当する場合) で再利用することは推奨しません。

    • オプション: Amazon Kendra に接続するための個人アクセストークンが Confluence アカウントで生成されました。詳細については、「個人用アクセストークンの生成に関する Confluence ドキュメント」を参照してください。

  • Confluence クラウド用

    • Amazon Kendra に接続するための Confluence 管理アカウントのユーザー名とパスワードを含む基本認証情報を記録しました。

  • 各ドキュメントが Confluence および同じインデックスに使用する予定の他のデータソース間で一意であることを確認しました。インデックスに使用する各データソースには、データソース全体に同じドキュメントが含まれていてはなりません。ドキュメント ID はインデックス全体に適用され、インデックスごとに一意である必要があります。

でAWS アカウント、以下があることを確認します。

  • Amazon Kendraインデックスを作成し、 API を使用している場合はインデックス ID を記録しました。

  • データソースの IAMロールを作成し、 API を使用している場合はロールの ARN を記録しましたIAM。

    注記

    認証タイプと認証情報を変更する場合は、IAMロールを更新して正しいAWS Secrets Managerシークレット ID にアクセスする必要があります。

  • Confluence の認証情報を AWS Secrets Manager シークレットに保存し、API を使用している場合は、シークレットの ARN を記録済み。

    注記

    認証情報とシークレットは、定期的に更新またはローテーションすることをお勧めします。セキュリティに必要なアクセスレベルのみを提供してください。認証情報とシークレットを、データソース、コネクタバージョン 1.0 と 2.0 (該当する場合) で再利用することは推奨しません。

既存のIAMロールまたはシークレットがない場合は、Confluence データソースを接続するときに コンソールを使用して新しいIAMロールとSecrets Managerシークレットを作成できますAmazon Kendra。API を使用している場合は、既存のIAMロールとSecrets Managerシークレットの ARN とインデックス ID を指定する必要があります。

接続手順

Confluence データソースAmazon Kendraに接続するには、 がデータAmazon Kendraにアクセスできるように Confluence 認証情報の詳細を指定する必要があります。Confluence をまだ設定していない場合は、Amazon Kendra「」を参照してください前提条件。

Console

Confluence Amazon Kendraに接続するには

  1. AWSマネジメントコンソールにサインインし、Amazon Kendraコンソールを開きます。

  2. 左側のナビゲーションペインで、[インデックス] を選択し、インデックスのリストから使用するインデックスを選択します。

    注記

    [インデックスの設定] で、[ユーザーアクセスコントロール] 設定を設定または編集できます。

  3. [使用開始] ページで、[データソースを追加] を選択します。

  4. [データソースを追加] ページで、[Confluence コネクタ V1.0] を選択し、[データソースを追加] を選択します。

  5. [データソースの詳細を指定] ページで、次の情報を入力します。

    1. [名前と説明] の [データソース名] に、データソースの名前を入力します。ハイフン (-) は使用できますが、スペースは使用できません。

    2. (オプション) [説明] - オプションで、データソースの説明を入力します。

    3. [デフォルト言語] - インデックス用にドキュメントをフィルターするための言語。特に指定しない限り、言語はデフォルトで英語に設定されます。ドキュメントのメタデータで指定された言語は、選択した言語よりも優先されます。

    4. タグで新しいタグを追加する - リソースを検索してフィルタリングしたり、AWSコストを追跡したりするためのオプションのタグを含めます。

    5. [次へ] を選択します。

  6. [アクセスとセキュリティの定義] ページで、次の情報を入力します。

    1. [Confluence Cloud] と [Confluence Server] のどちらかを選択します。

    2. [Confluence Cloud] を選択した場合は、次の情報を入力します。

      1. [Confluence URL] - ユーザーの Confluence URL。

      2. AWS Secrets Managersecret — 既存のシークレットを選択するか、Confluence 認証情報を保存する新しいSecrets Managerシークレットを作成します。新しいシークレットの作成を選択すると、[AWS Secrets Manager シークレット] ウィンドウが開きます。

        1. [AWS Secrets Manager シークレットウィンドウを作成] に次の情報を入力します。

          1. [シークレット名] - シークレットの名前。シークレット名に、プレフィックス「AmazonKendra-Confluence-」が自動的に追加されます。

          2. [ユーザー名] と [パスワード] - Confluence のユーザー名とパスワードを入力します。

          3. [認証を保存] を選択します。

    3. [Confluence Server] を選択した場合は、次の情報を入力します。

      1. [Confluence URL] - お客様の Confluence ユーザー名とパスワード。

      2. (オプション) [ウェブプロキシ] には次の情報を入力します。

        1. [ホスト名] - Confluence アカウントのホスト名。

        2. [ポート番号] - ホスト URL トランスポートプロトコルが使用するポート。

      3. [認証] には、[基本認証] または [個人用アクセストークン] (Confluence Server のみ) を選択します。

      4. AWS Secrets Managersecret — 既存のシークレットを選択するか、Confluence 認証情報を保存する新しいSecrets Managerシークレットを作成します。新しいシークレットの作成を選択すると、[AWS Secrets Manager シークレット] ウィンドウが開きます。

        1. [AWS Secrets Manager シークレットウィンドウを作成] に次の情報を入力します。

          1. [シークレット名] - シークレットの名前。シークレット名に、プレフィックス「AmazonKendra-Confluence-」が自動的に追加されます。

          2. [ユーザー名] と [パスワード] - Confluence で設定した認証情報値を入力します。基本認証を使用の場合は、Confluence のユーザー名 (E メール ID) とパスワード (API トークン) を使用します。個人用アクセストークンを使用の場合は、Confluence アカウントで設定した [個人用アクセストークン] の詳細を入力します。

          3. シークレットを保存して追加します。

    4. IAMrole — 既存のIAMロールを選択するか、新しいIAMロールを作成してリポジトリ認証情報にアクセスし、コンテンツにインデックスを作成します。

      注記

      IAMインデックスに使用される ロールは、データソースには使用できません。インデックスやよくある質問に既存のロールが使用されているかどうかが不明な場合は、エラーを避けるため、[新しいロールを作成] を選択してください。

    5. [次へ] を選択します。

  7. [同期設定の構成] ページで、次の情報を入力します。

    1. [個人用スペースを含める] と [アーカイブされたスペースを含む] の場合 - このデータソースに含めるオプションのスペースタイプを選択します。

    2. [追加設定] の場合: 特定のコンテンツを含めるか除外する正規表現パターンを指定します。最大 100 のパターンを追加できます。

    3. 選択したスペース内の添付ファイルをクロールすることもできます。

    4. 同期実行スケジュールで、頻度 - Amazon Kendraがデータソースと同期する頻度を選択します。

    5. [次へ] を選択します。

  8. [フィールドマッピングを設定] ページで、次の情報を入力します。

    1. スペース、ページ、ブログ - Amazon Kendra生成されたデフォルトのデータソースフィールドまたは追加の推奨フィールドマッピングから選択して、インデックスフィールドを追加します。

    2. [フィールドを追加] - カスタムデータソースフィールドを追加して、マッピング先のインデックスフィールド名とフィールドデータタイプを作成します。

    3. [次へ] を選択します。

  9. [確認と作成] ページで、入力した情報が正しいことを確認し、[データソースを追加] を選択します。このページで情報の編集を選択することもできます。データソースが正常に追加されると、データソースが [データソース] ページに表示されます。

API

Confluence Amazon Kendraに接続するには

ConfluenceConfiguration API を使用して以下を指定する必要があります。

  • Confluence バージョン - CLOUD または SERVER として使用している Confluence インスタンスのバージョンを指定します。

  • Secret Amazon Resource Name (ARN) — Confluence 認証情報を含む Secrets Managerシークレットの Amazon リソースネーム (ARN) を指定します。

    Confluence Server を使用している場合は、Confluence のユーザー名とパスワード、または個人アクセストークンのいずれかを認証情報として使用できます。

    Confluence のユーザー名とパスワードを認証情報として使用する場合、以下の認証情報を JSON 構造として Secrets Manager のシークレットに保存します。

    {
    "username": "user name",
    "password": "password"
}

    個人用アクセストークンを使用して Confluence Server を に接続する場合Amazon Kendra、次の認証情報を JSON 構造としてシークレットにSecrets Manager保存します。

    {
    "patToken": "personal access token"
}

    Confluence Cloud を使用する場合は、Confluence で設定された Confluence のユーザー名、および API トークンをパスワードとして使用します。次の認証情報を JSON 構造としてSecrets Managerシークレットに保存します。

    {
    "username": "user name",
    "password": "API token"
}

  • IAMrole - を呼び出しCreateDataSourceて、シーSecrets Managerクレットにアクセスするためのアクセス許可を IAMロールに提供し、Confluence コネクタと に必要なパブリック APIs を呼び出すRoleArnタイミングを指定しますAmazon Kendra。詳細については、「IAM roles for Confluence data sources」を参照してください。

オプションで、次の機能を追加することもできます。

  • ウェブプロキシ - ウェブプロキシ経由で Confluence URL インスタンスに接続するかどうか。このオプションは Confluence サーバーに使用できます。

  • (Confluence サーバーのみ) [仮想プライベートクラウド (VPC)] - データソース設定の一部として VpcConfiguration を指定します。「VPC を使用するAmazon Kendraように を設定する」を参照してください。

  • 包含フィルターと除外フィルター - 特定のスペース、ブログ投稿、ページ、スペース、および添付ファイルを含めるか除外する正規表現パターンを指定します。添付ファイルのインデックスを作成する場合は、インデックスで指定されたページおよびブログへの添付ファイルのみがインデックス作成されます。

    注記

    ほとんどのデータソースは、フィルターと呼ばれる包含または除外パターンである正規表現パターンを使用しています。包含フィルターを指定すると、包含フィルターに一致するコンテンツのみのインデックスが作成されます。包含フィルターに一致しないドキュメントのインデックスは作成されません。包含フィルターと除外フィルターを指定した場合、除外フィルターに一致するドキュメントは、包含フィルターと一致してもインデックスは作成されません。

  • フィールドマッピング - 選択すると、Confluence データソースフィールドを Amazon Kendra インデックスフィールドにマッピングします。詳細については、「データソースフィールドのマッピング」を参照してください。

    注記

    がドキュメントAmazon Kendraを検索するには、ドキュメント本文フィールドまたはドキュメントと同等のドキュメント本文が必要です。データソースのドキュメント本文フィールド名をインデックスフィールド名 _document_body にマッピングする必要があります。その他のすべてのフィールドはオプションです。

  • [ユーザーコンテキストのフィルタリングとアクセスコントロール] — ドキュメントの ACL がある場合は、Amazon Kendra がドキュメントのアクセスコントロールリスト (ACL) をクロールします。ACL 情報は、ユーザーまたはそのグループのドキュメントへのアクセスに基づいて、検索結果をフィルタリングするために使用されます。詳細については、「User context filtering」を参照してください。

詳細はこちら

Confluence データソースAmazon Kendraとの統合の詳細については、以下を参照してください。