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

# Confluence データセンターのデータソースを接続する
<a name="kb-managed-ds-confluence-onprem-connect"></a>

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

**注記**  
最初に VPC 設定と認証設定を完了します。「[データソースの VPC 接続を設定する](kb-managed-vpc-configuration.md)」および「[Confluence データセンターの基本的な認証または PAT 認証を設定する](kb-managed-confluence-onprem-auth-setup.md)」を参照してください。VPC 設定 ID とシークレット ARN が必要です。

## データソースを作成する
<a name="kb-managed-ds-confluence-onprem-create"></a>

------
#### [ Console ]

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

1. **データソース**で、データソースの名前を指定します。

1. データソースドロップダウンから **Confluence データセンター**を選択します。

1. **VPC 設定**で、Confluence データセンターインスタンスに到達する VPC 設定を選択するか、VPC **設定の追加**を選択して作成します。詳細については、「[データソースの VPC 接続を設定する](kb-managed-vpc-configuration.md)」を参照してください。

1. (オプション) **アプリケーションコンテキストパス**に、Confluence データセンター REST API が提供される**コンテンツパス**を入力します (例: `/wiki`)。REST API がウェブルートで提供されている場合は、空のままにします。

1. (オプション、HTTPS のみ) **TLS 証明書**で、Confluence データセンターインスタンスの TLS 証明書の Amazon S3 URI を指定します。

1. **認証**で、**基本認証**または**個人用アクセストークン**を選択し、一致する認証情報を保持する AWS Secrets Manager シークレットを選択します。

1. (オプション) **同期スコープ**を展開して、クロールするエンティティタイプ (ページ、ページアタッチメント、ブログ、ブログアタッチメント、個人スペース) を選択します。

1. (オプション) **エンティティ URLs** を展開して、URL ベースのフィルタリングを使用して特定の Confluence スペース、ページ、ブログを同期します。

1. (オプション) **Mime タイプ**を展開して、特定の MIME タイプを含めるか除外します。

------
#### [ API ]

Confluence データセンターのデータソースを作成するには、Amazon Bedrock エージェントのビルドタイムエンドポイントを使用して [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) リクエストを送信します。次の の 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`します。

------

## コネクタパラメータ
<a name="kb-managed-config-confluence-onprem"></a>

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


**connectionConfiguration**  

| フィールド | 必要 | 説明 | 
| --- | --- | --- | 
| authType | はい | 認証タイプ を BASICまたは に設定しますPERSONAL\_TOKEN。「[認証方法](kb-managed-ds-confluence-onprem.md#kb-managed-confluence-onprem-auth-methods)」を参照してください。 | 
| secretArn | はい | Confluence データセンターの認証情報を含む AWS Secrets Manager シークレットの ARN。 | 
| vpcConfiguration | はい | Confluence データセンターインスタンスへのプライベートネットワークパス。ナレッジベースの VPC 設定の ID に設定されたvpcConfigurationIdフィールドが含まれます。「[データソースの VPC 接続を設定する](kb-managed-vpc-configuration.md)」を参照してください。 | 
| 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")。 | 

## 認証方法を変更する
<a name="kb-managed-ds-confluence-onprem-change-auth"></a>

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

## 次の手順
<a name="kb-managed-ds-confluence-onprem-connect-next"></a>

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