기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Confluence 데이터 센터 데이터 소스 연결
<a name="kb-managed-ds-confluence-onprem-connect"></a>

VPC 연결을 설정하고 보안 인증 정보를 AWS Secrets Manager 보안 암호에 저장한 후 지식 기반에 Confluence 데이터 센터 데이터 소스를 생성합니다. 이 페이지에서는 AWS Management Console 또는 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 데이터 센터 데이터 소스를 생성하려면 Agents for 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`는 비동기식입니다. 작업이 완료되면 데이터 소스 상태가에서 `AVAILABLE` `CREATING`로 전환됩니다.

------

## 커넥터 파라미터
<a name="kb-managed-config-confluence-onprem"></a>

데이터 소스 구성은 다음 커넥터 파라미터를 사용합니다. Confluence 데이터 센터에 연결하려면에서 커넥터 유형`CONFLUENCEONPREM`으로를 지정합니다`connectorParameters`. 래핑되는 필드`connectorParameters`(예: `deletionProtectionConfiguration` 및 `mediaExtractionConfiguration`)는 섹션을 참조하세요[데이터 소스 연결](kb-managed-connect-ds.md).


**connectionConfiguration**  

| Field | 필수 | 설명 | 
| --- | --- | --- | 
| 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 | 아니요 | HTTPS를 통해 연결할 때 사용되는 Confluence 데이터 센터 인스턴스의 TLS 인증서 위치입니다. s3BucketName 및를 포함합니다s3KeyName. | 


**dataEntityConfiguration(선택 사항)**  

| Field | 필수 | 설명 | 
| --- | --- | --- | 
| crawlPage | 아니요 | 페이지를 크롤링할지 여부입니다. | 
| crawlBlog | 아니요 | 블로그 게시물을 크롤링할지 여부입니다. | 
| crawlPageAttachment | 아니요 | 페이지 첨부 파일을 크롤링할지 여부입니다. crawlPage 도 인 경우에만 크롤링됩니다true. | 
| crawlBlogAttachment | 아니요 | 블로그 게시물 첨부 파일을 크롤링할지 여부입니다. crawlBlog 도 인 경우에만 크롤링됩니다true. | 
| crawlPersonalSpace | 아니요 | 개인 공간을 크롤링할지 여부입니다. | 

**참고**  
Confluence 클라우드와 달리 Confluence 데이터 센터는 아카이브된 스페이스 또는 아카이브된 페이지 크롤링을 지원하지 않습니다.


**filterConfiguration(선택 사항)**  

| Field | 필수 | 설명 | 
| --- | --- | --- | 
| inclusionSpaceUrls | 아니요 | 포함할 스페이스 URLs. | 
| inclusionPageUrls | 아니요 | 포함할 페이지 URLs. | 
| inclusionMimeTypes | 아니요 | 포함할 MIME 유형입니다. | 
| exclusionMimeTypes | 아니요 | 제외할 MIME 유형입니다. | 
| maxFileSizeInMegaBytes | 아니요 | 커넥터가 수집하는 단일 파일의 최대 크기입니다. 를 숫자 문자열로 입력합니다(예: "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 Management Console.

## 다음 단계
<a name="kb-managed-ds-confluence-onprem-connect-next"></a>

데이터 소스를 생성한 후 이를 동기화하여 지식 기반에 콘텐츠를 수집합니다. 자세한 내용은 [데이터 소스 동기화](kb-managed-sync.md) 섹션을 참조하십시오.