Confluence データセンターのデータソースを接続する

VPC 接続を設定し、認証情報を AWS Secrets Manager シークレットに保存したら、ナレッジベースに Confluence データセンターデータソースを作成します。このページでは、 AWS マネジメントコンソールまたは API を使用してデータソースを作成し、次に設定できるコネクタパラメータのリファレンスを作成する方法について説明します。

注記

最初に VPC 設定と認証設定を完了します。「データソースの VPC 接続を設定する」および「Confluence データセンターの基本的な認証または PAT 認証を設定する」を参照してください。VPC 設定 ID とシークレット ARN が必要です。

データソースを作成する

Console

Confluence データセンターをマネージドナレッジベースに接続するには

データソースで、データソースの名前を指定します。
データソースドロップダウンから Confluence データセンターを選択します。
VPC 設定で、Confluence データセンターインスタンスに到達する VPC 設定を選択するか、VPC 設定の追加を選択して作成します。詳細については、「データソースの VPC 接続を設定する」を参照してください。
(オプション) アプリケーションコンテキストパスに、Confluence データセンター REST API が提供されるコンテンツパスを入力します (例: /wiki)。REST API がウェブルートで提供されている場合は、空のままにします。
(オプション、HTTPS のみ) TLS 証明書で、Confluence データセンターインスタンスの TLS 証明書の Amazon S3 URI を指定します。
認証で、基本認証または個人用アクセストークンを選択し、一致する認証情報を保持する AWS Secrets Manager シークレットを選択します。
(オプション) 同期スコープを展開して、クロールするエンティティタイプ (ページ、ページアタッチメント、ブログ、ブログアタッチメント、個人スペース) を選択します。
(オプション) エンティティ URLs を展開して、URL ベースのフィルタリングを使用して特定の Confluence スペース、ページ、ブログを同期します。
(オプション) Mime タイプを展開して、特定の MIME タイプを含めるか除外します。

API

Confluence データセンターのデータソースを作成するには、Amazon Bedrock エージェントのビルドタイムエンドポイントを使用して CreateDataSource リクエストを送信します。次のの AWS Command Line Interface 例では、基本認証を使用するデータソースを作成します。代わりに個人用アクセストークンを使用するには、 authTypeをに変更しますPERSONAL_TOKEN。各フィールドの説明については、以下のコネクタパラメータリファレンスを参照してください。


aws bedrock-agent create-data-source \
 --name "Confluence-DataCenter-connector" \
 --knowledge-base-id "your-knowledge-base-id" \
 --data-source-configuration file://confluence-onprem-connector.json

confluence-onprem-connector.json ファイルには以下が含まれます。


{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "CONFLUENCEONPREM",
            "version": "1",
            "aclEnabled": false,
            "connectionConfiguration": {
                "authType": "BASIC",
                "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-confluence-onprem-creds",
                "contextPath": "/wiki",
                "vpcConfiguration": {
                    "vpcConfigurationId": "your-vpc-configuration-id"
                },
                "certificateS3Path": {
                    "s3BucketName": "my-cert-bucket",
                    "s3KeyName": "confluence-dc-cert.pem"
                }
            },
            "dataEntityConfiguration": {
                "crawlPage": true,
                "crawlBlog": true,
                "crawlPageAttachment": true,
                "crawlBlogAttachment": true
            },
            "filterConfiguration": {
                "inclusionSpaceUrls": ["https://confluence.example.com/spaces/ENG/"]
            }
        }
    }
}

マネージドナレッジベースの場合、 CreateDataSourceは非同期です。オペレーションが完了すると、データソースのステータスはから CREATING に移行AVAILABLEします。

コネクタパラメータ

データソース設定では、次のコネクタパラメータを使用します。Confluence データセンターに接続するには、でコネクタタイプCONFLUENCEONPREMとしてを指定しますconnectorParameters。ラップするフィールド connectorParameters ( deletionProtectionConfigurationやなどmediaExtractionConfiguration) については、「」を参照してくださいデータソースを接続する。

connectionConfiguration
フィールド	必要	説明
`authType`	はい	認証タイプを `BASIC`またはに設定します`PERSONAL_TOKEN`。「認証方法」を参照してください。
`secretArn`	はい	Confluence データセンターの認証情報を含む AWS Secrets Manager シークレットの ARN。
`vpcConfiguration`	はい	Confluence データセンターインスタンスへのプライベートネットワークパス。ナレッジベースの VPC 設定の ID に設定された`vpcConfigurationId`フィールドが含まれます。「データソースの VPC 接続を設定する」を参照してください。
`contextPath`	いいえ	Confluence データセンター REST API が提供されるアプリケーションコンテキストパス ( など`/wiki`)。REST API がウェブルートで提供されている場合は省略します。
`certificateS3Path`	いいえ	Confluence データセンターインスタンスの TLS 証明書の場所。HTTPS 経由で接続するときに使用されます。`s3BucketName` とが含まれます`s3KeyName`。

dataEntityConfiguration (オプション)
フィールド	必要	説明
`crawlPage`	いいえ	ページをクロールするかどうか。
`crawlBlog`	いいえ	ブログ投稿をクロールするかどうか。
`crawlPageAttachment`	いいえ	ページの添付ファイルをクロールするかどうか。`crawlPage` がでもある場合にのみクロールされます`true`。
`crawlBlogAttachment`	いいえ	ブログ投稿の添付ファイルをクロールするかどうか。`crawlBlog` がでもある場合にのみクロールされます`true`。
`crawlPersonalSpace`	いいえ	個人用スペースをクロールするかどうか。

注記

Confluence Cloud とは異なり、Confluence データセンターはアーカイブされたスペースやアーカイブされたページのクローリングをサポートしていません。

filterConfiguration (オプション)
フィールド	必要	説明
`inclusionSpaceUrls`	いいえ	含めURLs。
`inclusionPageUrls`	いいえ	含めURLs。
`inclusionMimeTypes`	いいえ	含める MIME タイプ。
`exclusionMimeTypes`	いいえ	除外する MIME タイプ。
`maxFileSizeInMegaBytes`	いいえ	コネクタが取り込む 1 つのファイルの最大サイズ、メガバイト単位。数値文字列としてを指定します (例: `"50"`)。

認証方法を変更する

UpdateDataSource オペレーションまたはを使用して、新しい authTypeと一致する認証情報を含むシークレットでデータソースを更新することで、データソースの認証方法 (ベーシックから個人用アクセストークンなど) を変更できます AWS マネジメントコンソール。

次の手順

データソースを作成したら、それを同期してナレッジベースにコンテンツを取り込みます。詳細については、データソースを同期するを参照してください

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

基本/PAT 認証を設定する

カスタム