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

# Confluence 커넥터 V1.0
<a name="data-source-v1-confluence"></a>

Confluence는 프로젝트 계획, 소프트웨어 개발 및 제품 관리를 공유, 저장 및 작업하도록 설계된 협업 작업 관리 도구입니다. Amazon Kendra 를 사용하여 Confluence 스페이스, 페이지(중첩 페이지 포함), 블로그, 인덱싱된 페이지 및 블로그에 대한 설명 및 첨부 파일을 인덱싱할 수 있습니다.

**참고**  
Confluence 커넥터 V1.0/ConfluenceConfiguration API는 2023년에 지원이 종료되었습니다. Confluence 커넥터 V2.0 / TemplateConfiguration API로 마이그레이션하거나 이를 사용하는 것이 좋습니다.

 Amazon Kendra Confluence 데이터 소스 커넥터의 문제 해결은 섹션을 참조하세요[데이터 소스 문제 해결](troubleshooting-data-sources.md).

**Topics**
+ [지원되는 기능](#supported-features-v1-confluence)
+ [사전 조건](#prerequisites-v1-confluence)
+ [연결 지침](#data-source-procedure-v1-confluence)
+ [자세히 알아보기](#confluence-v1-learn-more)

## 지원되는 기능
<a name="supported-features-v1-confluence"></a>

Amazon Kendra Confluence 데이터 소스 커넥터는 다음 기능을 지원합니다.
+ 필드 매핑
+ 사용자 액세스 제어
+ 포함/제외 필터
+ (Confluence 서버에만 해당) Virtual Private Cloud(VPC)

## 사전 조건
<a name="prerequisites-v1-confluence"></a>

 Amazon Kendra 를 사용하여 Confluence 데이터 소스를 인덱싱하려면 먼저 Confluence 및 AWS 계정에서 이러한 변경을 수행합니다.

**Confluence에서 다음을 충족해야 합니다.**
+ 다음을 통해 Confluence 인스턴스 내의 모든 콘텐츠를 볼 수 있는 Amazon Kendra 권한을 부여했습니다.
  + `confluence-administrators` 그룹의 멤버 Amazon Kendra 가 됩니다.
  + 모든 기존 스페이스, 블로그 및 페이지에 대한 사이트 관리자 권한 부여.
+ Confluence 인스턴스의 URL을 복사했습니다.
+ **SSO(Single Sign-On) 사용자의 경우:** Confluence 데이터 센터에서 Confluence **인증 방법**을 구성할 때 사용자 이름 및 암호에 대해 **로그인 시 표시 페이지**를 활성화했습니다.
+ **Confluence 서버의 경우**
  +  Amazon Kendra에 연결할 Confluence 관리 계정 사용자 이름과 암호가 들어 있는 기본보안 인증 정보를 기록했습니다.
**참고**  
보안 인증 정보와 보안 암호를 정기적으로 새로 고치거나 교체하는 것이 좋습니다. 보안을 위해 필요한 액세스 수준만 제공하세요. 데이터 소스, 커넥터 버전 1.0 및 2.0(해당하는 경우) 간에 보안 인증 정보와 보안 암호를 재사용하지 **않는** 것이 좋습니다.
  + **선택 사항:** Confluence 계정에서 Amazon Kendra에 연결할 개인용 액세스 토큰을 생성했습니다. 자세한 내용은 [개인용 액세스 토큰 생성에 대한 Confluence 설명서](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html)를 참조하세요.
+ **Confluence 클라우드의 경우**
  +  Amazon Kendra에 연결할 Confluence 관리 계정 사용자 이름과 암호가 들어 있는 기본보안 인증 정보를 기록했습니다.
+ Confluence 및 동일한 인덱스에 사용할 다른 여러 데이터 소스에서 각 문서가 고유한지 확인했습니다. 인덱스에 사용하려는 각 데이터 소스에는 데이터 소스 전체에서 동일한 문서가 포함되어서는 안 됩니다. 문서 ID는 인덱스 전체에 적용되며 인덱스별로 고유해야 합니다.

**에 다음이 있는지 AWS 계정확인합니다.**
+ [Amazon Kendra 인덱스를 생성하고](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) API를 사용하는 경우 인덱스 ID를 기록했습니다.
+ 데이터 소스에 대한 [IAM 역할을 생성](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds)했으며 API를 사용하는 경우 IAM 역할의 ARN을 기록했습니다.
**참고**  
인증 유형과 자격 증명을 변경하는 경우 올바른 AWS Secrets Manager 보안 암호 ID에 액세스하도록 IAM 역할을 업데이트해야 합니다.
+ Confluence 보안 인증 정보를 AWS Secrets Manager 보안 암호에 저장했고 API를 사용하는 경우 보안 암호의 ARN을 기록했습니다.
**참고**  
보안 인증 정보와 보안 암호를 정기적으로 새로 고치거나 교체하는 것이 좋습니다. 보안을 위해 필요한 액세스 수준만 제공하세요. 데이터 소스, 커넥터 버전 1.0 및 2.0(해당하는 경우) 간에 보안 인증 정보와 보안 암호를 재사용하지 **않는** 것이 좋습니다.

기존 IAM 역할이나 보안 암호가 없는 경우 Confluence 데이터 소스를 연결할 때 콘솔을 사용하여 새 IAM 역할 및 Secrets Manager 보안 암호를 생성할 수 있습니다 Amazon Kendra. API를 사용하는 경우 기존 IAM 역할 및 Secrets Manager 보안 암호의 ARN과 인덱스 ID를 제공해야 합니다.

## 연결 지침
<a name="data-source-procedure-v1-confluence"></a>

Confluence 데이터 소스 Amazon Kendra 에 연결하려면가 데이터에 액세스할 Amazon Kendra 수 있도록 Confluence 자격 증명의 세부 정보를 제공해야 합니다. 에 대해 Confluence를 아직 구성하지 않은 경우 섹션을 Amazon Kendra 참조하세요[사전 조건](#prerequisites-v1-confluence).

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

**Confluence Amazon Kendra 에 연결하려면** 

1.  AWS Management Console에 로그인하고 [Amazon Kendra 콘솔](https://console.aws.amazon.com/kendra/)을 엽니다.

1. 왼쪽 탐색 창에서 **인덱스**를 선택한 다음 인덱스 목록에서 사용할 인덱스를 선택합니다.
**참고**  
**인덱스 설정**에서 **사용자 액세스 제어** 설정을 구성하거나 편집할 수 있습니다.

1. **시작하기** 페이지에서 **데이터 소스 추가**를 선택합니다.

1. **데이터 소스 추가** 페이지에서 **Confluence 커넥터 V1.0**을 선택한 다음 **데이터 소스 추가**를 선택합니다.

1. **데이터 소스 세부 정보 지정** 페이지에서 다음 정보를 입력합니다.

   1. **이름 및 설명**에서 **데이터 소스 이름**에 데이터 소스의 이름을 입력합니다. 하이픈은 포함할 수 있지만 공백은 포함할 수 없습니다.

   1. (선택 사항) **설명** - 데이터 소스에 대한 선택적 설명을 입력합니다.

   1. **기본 언어** - 인덱스에 사용할 문서를 필터링할 언어를 선택합니다. 달리 지정하지 않는 한, 언어는 영어로 기본 설정됩니다. 문서 메타데이터에 지정된 언어가 선택한 언어보다 우선합니다.

   1. **태그**에서 **새 태그 추가** - 리소스를 검색 및 필터링하거나 AWS 비용을 추적하는 선택적 태그를 포함합니다.

   1. **다음**을 선택합니다.

1. **액세스 및 보안 정의** 페이지에서 다음 정보를 입력합니다.

   1. **Confluence 클라우드**와 **Confluence 서버** 중에서 선택합니다.

   1. **Confluence 클라우드**를 선택하는 경우 다음 정보를 입력합니다.

      1. **Confluence URL** - 사용자의 Confluence URL.

      1. **AWS Secrets Manager 보안** 암호 - 기존 보안 암호를 선택하거나 새 Secrets Manager 보안 암호를 생성하여 Confluence 인증 자격 증명을 저장합니다. 새 암호를 만들기로 선택하면 AWS Secrets Manager 보안 암호 창이 열립니다.

         1. ** AWS Secrets Manager 보안 암호 생성 창**에 다음 정보를 입력합니다.

           1. **보안 암호 이름** - 보안 암호의 이름. 'AmazonKendra-Confluence-'라는 접두사가 보안 암호 이름에 자동으로 추가됩니다.

           1. **사용자 이름** 및 **암호**의 경우 - Confluence 사용자 이름과 암호를 입력합니다.

           1. **인증 저장**을 선택합니다.

   1. **Confluence 서버**를 선택하는 경우 다음 정보를 입력합니다.

      1. **Confluence URL** - Confluence 사용자 이름 및 암호.

      1. (선택 사항) **웹 프록시**의 경우 다음 정보를 입력합니다.

         1.  **호스트 이름** - Confluence 계정의 호스트 이름.

         1.  **포트 번호** - 호스트 URL 전송 프로토콜에서 사용하는 포트 번호.

      1. **인증**에서 **기본 인증** 또는 (Confluence 서버만 해당) **개인 액세스 토큰**을 선택합니다.

      1. **AWS Secrets Manager 보안** 암호 - 기존 보안 암호를 선택하거나 새 Secrets Manager 보안 암호를 생성하여 Confluence 인증 자격 증명을 저장합니다. 새 암호를 만들기로 선택하면 AWS Secrets Manager 보안 암호 창이 열립니다.

         1. ** AWS Secrets Manager 보안 암호 생성 창**에 다음 정보를 입력합니다.

           1. **보안 암호 이름** - 보안 암호의 이름. 'AmazonKendra-Confluence-'라는 접두사가 보안 암호 이름에 자동으로 추가됩니다.

           1. **사용자 이름** 및 **암호**의 경우 - Confluence에서 구성한 인증 자격 증명 값을 입력합니다. 기본 인증을 사용하는 경우 Confluence 사용자 이름(이메일 ID)과 암호(API 토큰)를 사용합니다. 개인 액세스 토큰을 사용하는 경우 Confluence 계정에서 구성한 **개인 액세스 토큰**의 세부 정보를 입력합니다.

           1. 보안 암호를 저장하고 추가합니다.

   1. **IAM 역할** - 기존 IAM 역할을 선택하거나 새 IAM 역할을 생성하여 리포지토리 자격 증명 및 인덱스 콘텐츠에 액세스합니다.
**참고**  
IAM 인덱스에 사용되는 역할은 데이터 소스에 사용할 수 없습니다. 기존 역할을 인덱스나 FAQ에 사용하는지 확실하지 않은 경우 **새 역할 생성**을 선택하여 오류를 방지하세요.

   1. **다음**을 선택합니다.

1. **동기화 설정 구성** 페이지에 다음 정보를 입력합니다.

   1. **개인 스페이스 포함** 및 **보관된 스페이스 포함** - 이 데이터 소스에 포함할 선택적 스페이스 유형을 선택합니다.

   1. **추가 구성**의 경우 - 정규 표현식 패턴을 지정하여 특정 콘텐츠를 포함하거나 제외합니다. 최대 100개의 패턴을 추가할 수 있습니다.

   1. **선택한 스페이스 내에서 첨부 파일을 크롤링**하도록 선택할 수도 있습니다.

   1. **동기화 실행 일정**에서 **빈도** - Amazon Kendra 가 데이터 소스와 동기화하는 빈도를 선택합니다.

   1. **다음**을 선택합니다.

1. **필드 매핑 설정** 페이지에 다음 정보를 입력합니다.

   1. **스페이스**, **페이지**, **블로그** - Amazon Kendra 생성된 기본 데이터 소스 필드 또는 **제안된 추가 필드 매핑** 중에서 선택하여 인덱스 필드를 추가합니다.

   1.  **필드 추가** - 사용자 지정 데이터 소스 필드를 추가하려면 매핑할 인덱스 필드 이름과 필드 데이터 유형을 만듭니다.

   1. **다음**을 선택합니다.

1. **검토 및 생성** 페이지에서 입력한 정보가 정확한지 확인한 다음 **데이터 소스 추가**를 선택합니다. 이 페이지에서 정보를 편집하도록 선택할 수도 있습니다. 데이터 소스가 성공적으로 추가된 후 **데이터 소스** 페이지에 데이터 소스가 표시됩니다.

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

**Confluence Amazon Kendra 에 연결하려면**

[ConfluenceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConfluenceConfiguration.html) API를 사용하여 다음을 지정해야 합니다.
+ **컨플루언스 버전** - 사용 중인 Confluence 인스턴스의 버전을 `CLOUD` 또는 `SERVER`로 지정합니다.
+ **보안 암호 Amazon 리소스 이름(ARN)** - Confluence 인증 자격 증명이 포함된 Secrets Manager 보안 암호의 Amazon 리소스 이름(ARN)을 제공합니다.

  Confluence 서버를 사용하는 경우 Confluence 사용자 이름과 암호 또는 개인 액세스 토큰을 인증 자격 증명으로 사용할 수 있습니다.

  Confluence 사용자 이름과 암호를 인증 자격 증명으로 사용하는 경우, 다음 자격 증명을 JSON 구조로 Secrets Manager 보안 암호에 저장합니다.

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

  개인 액세스 토큰을 사용하여 Confluence Server를에 연결하는 경우 다음 자격 증명을 보안 암호에 JSON 구조로 Amazon Kendra저장합니다. Secrets Manager 

  ```
  {
      "patToken": "personal access token"
  }
  ```

  Confluence 클라우드를 사용하는 경우 Confluence에 구성된 API 토큰과 Confluence 사용자 이름을 암호로 사용합니다. 다음 자격 증명을 Secrets Manager 보안 암호에 JSON 구조로 저장합니다.

  ```
  {
      "username": "user name",
      "password": "API token"
  }
  ```
+ **IAM 역할** -를 호출`CreateDataSource`하여 Secrets Manager 보안 암호에 액세스하고 Confluence 커넥터 및에 필요한 퍼블릭 APIs를 호출할 수 있는 권한을 IAM 역할에 제공하는 `RoleArn` 시기를 지정합니다 Amazon Kendra. 자세한 내용은 [Confluence 데이터 소스에 대한IAM 역할](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds)을 참조하세요.

다음 선택적 기능도 추가할 수 있습니다.
+ **웹 프록시** - 웹 프록시를 통해 Confluence URL 인스턴스에 연결할지 여부입니다. 이 옵션을 Confluence 서버에 사용할 수 있습니다.
+ (Confluence 서버만 해당) **Virtual Private Cloud(VPC)** - `VpcConfiguration`을 데이터 소스 구성의 일부로 지정합니다. [VPC Amazon Kendra 를 사용하도록 구성을 참조하세요](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
+  **포함 및 제외 필터** - 특정 스페이스, 블로그 게시물, 페이지, 스페이스 및 연결을 포함하거나 제외하는 정규식 패턴을 지정합니다. 첨부 파일을 인덱싱하도록 선택하면 인덱싱된 페이지 및 블로그에 대한 첨부 파일만 인덱싱됩니다.
**참고**  
대부분의 데이터 소스는 필터라고 하는 포함 또는 제외 패턴인 정규 표현식 패턴을 사용합니다. 포함 필터를 지정하는 경우 포함 필터와 일치하는 콘텐츠만 인덱싱됩니다. 포함 필터와 일치하지 않는 문서는 인덱싱되지 않습니다. 포함 및 제외 필터를 지정하는 경우 제외 필터와 일치하는 문서는 포함 필터와 일치하더라도 인덱싱되지 않습니다.
+  **필드 매핑** - Confluence 데이터 소스 필드를 Amazon Kendra 인덱스 필드에 매핑하기로 선택합니다. 자세한 내용을 알아보려면 [데이터 소스 필드 매핑](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html)을 참조하세요.
**참고**  
가 문서를 Amazon Kendra 검색하려면 문서 본문 필드 또는 해당 문서에 해당하는 문서 본문이 필요합니다. 데이터 소스의 문서 본문 필드 이름을 인덱스 필드 이름 `_document_body`에 매핑해야 합니다. 다른 모든 필드는 선택 사항입니다.
+  **사용자 컨텍스트 필터링 및 액세스 제어** -Amazon Kendra 는 문서에 대한 액세스 제어 목록(ACL)이 있는 경우 문서의 ACL을 크롤링합니다. ACL 정보는 검색 결과를 문서에 대한 사용자 또는 그룹의 액세스 권한을 기준으로 필터링하는 데 사용됩니다. 자세한 내용은 [사용자 컨텍스트 필터링](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter)을 참조하세요.

------

## 자세히 알아보기
<a name="confluence-v1-learn-more"></a>

Confluence 데이터 소스 Amazon Kendra 와 통합하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [Amazon Kendra Confluence Server 커넥터 구성 ](https://aws.amazon.com/blogs/machine-learning/configuring-your-amazon-kendra-confluence-server-connector/)