Confluence 커넥터 V1.0 - Amazon Kendra
지원되는 기능사전 조건연결 지침자세히 알아보기

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

Confluence 커넥터 V1.0

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

참고

컨플루언스 커넥터 V1.0/에 대한 지원은 ConfluenceConfiguration API 2023년에 종료될 예정입니다. 컨플루언스 커넥터 V2.0 /로 마이그레이션하거나 이를 사용하는 것이 좋습니다. TemplateConfiguration API

문제 해결을 위해 Amazon Kendra Confluence 데이터 소스 커넥터는 을 참조하십시오. 데이터 소스 문제 해결

지원되는 기능

Amazon Kendra Confluence 데이터 소스 커넥터는 다음 기능을 지원합니다.

  • 필드 매핑

  • 사용자 액세스 제어

  • 포함/제외 필터

  • (Confluence 서버에만 해당) 가상 사설 클라우드 () VPC

사전 조건

사용할 수 있기 전에 Amazon Kendra Confluence 데이터 원본을 인덱싱하려면 Confluence에서 다음과 같이 변경하고 AWS 계정.

Confluence에서 다음을 충족해야 합니다.

  • 부여됨 Amazon Kendra 다음과 같은 방법으로 Confluence 인스턴스 내의 모든 콘텐츠를 볼 수 있는 권한:

    • 제작 Amazon Kendra confluence-administrators그룹의 일원.

    • 모든 기존 스페이스, 블로그 및 페이지에 대한 사이트 관리자 권한 부여.

  • Confluence 인스턴스를 복사했습니다. URL

  • SSO(싱글 사인온) 사용자의 경우: Confluence 데이터 센터에서 Confluence 인증 방법을 구성할 때 사용자 이름 및 암호에 대한 로그인 시 표시 페이지를 활성화했습니다.

  • Confluence 서버의 경우

    • 연결할 Confluence 관리 계정 사용자 이름과 암호가 들어 있는 기본 인증 자격 증명을 기록해 두었습니다. Amazon Kendra.

      참고

      보안 인증 정보와 보안 암호를 정기적으로 새로 고치거나 교체하는 것이 좋습니다. 보안을 위해 필요한 액세스 수준만 제공하세요. 데이터 소스, 커넥터 버전 1.0 및 2.0(해당하는 경우) 간에 보안 인증 정보와 보안 암호를 재사용하지 않는 것이 좋습니다.

    • 선택 사항: Confluence 계정에 연결할 개인용 액세스 토큰 생성 Amazon Kendra. 자세한 내용은 개인용 액세스 토큰 생성에 대한 Confluence 설명서를 참조하십시오.

  • Confluence 클라우드의 경우

    • 연결할 Confluence 관리 계정 사용자 이름 및 암호가 포함된 기본 인증 자격 증명을 기록해 두었습니다. Amazon Kendra.

  • Confluence 및 동일한 인덱스에 사용할 다른 여러 데이터 소스에서 각 문서가 고유한지 확인했습니다. 인덱스에 사용하려는 각 데이터 소스에는 데이터 소스 전체에서 동일한 문서가 포함되어서는 안 됩니다. 문서는 인덱스 전체에 IDs 적용되며 인덱스별로 고유해야 합니다.

귀하의 AWS 계정다음을 갖추고 있는지 확인하세요.

  • 만들었습니다. Amazon Kendra 색인을 사용하고API, 를 사용하는 경우 색인 ID를 기록해 둡니다.

  • 생성됨 IAM 데이터 소스의 역할 및 를 사용하는 경우 API 다음을 기록했습니다. ARN IAM 역할.

    참고

    인증 유형 및 자격 증명을 변경하는 경우 다음을 업데이트해야 합니다. IAM 올바른 위치에 액세스하기 위한 역할 AWS Secrets Manager 시크릿 ID.

  • 컨플루언스 인증 자격 증명을 다음 위치에 저장했습니다. AWS Secrets Manager 암호를 입력하고, 사용하는 경우 암호를 기록해 ARN 두었습니다. API

    참고

    보안 인증 정보와 보안 암호를 정기적으로 새로 고치거나 교체하는 것이 좋습니다. 보안을 위해 필요한 액세스 수준만 제공하세요. 데이터 소스, 커넥터 버전 1.0 및 2.0(해당하는 경우) 간에 보안 인증 정보와 보안 암호를 재사용하지 않는 것이 좋습니다.

기존에 가지고 있는 것이 없는 경우 IAM 역할 또는 암호는 콘솔을 사용하여 새 역할을 만들 수 있습니다. IAM 역할 및 Secrets Manager Confluence 데이터 원본을 연결할 때의 비밀 Amazon Kendra. 를 API 사용하는 경우 기존 제품을 제공해야 ARN 합니다. IAM 역할 및 Secrets Manager 비밀, 인덱스 ID

연결 지침

연결하려면 Amazon Kendra Confluence 데이터 소스에 다음과 같이 Confluence 자격 증명의 세부 정보를 제공해야 합니다. Amazon Kendra 데이터에 액세스할 수 있습니다. 아직 Confluence를 다음과 같이 구성하지 않은 경우 Amazon Kendra 을 참조하십시오. 사전 조건

Console

연결하려면 Amazon Kendra 컨플루언스로

  1. 에 로그인하세요. AWS 관리 콘솔을 열고 Amazon Kendra 콘솔.

  2. 왼쪽 탐색 창에서 인덱스를 선택한 다음 인덱스 목록에서 사용할 인덱스를 선택합니다.

    참고

    인덱스 설정에서 사용자 액세스 제어 설정을 구성하거나 편집할 수 있습니다.

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

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

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

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

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

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

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

    5. Next(다음)를 선택합니다.

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

    1. 컨플루언스 클라우드와 컨플루언스 서버 중에서 선택하세요.

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

      1. 컨플루언스 - 나의 컨플루언스 URL. URL

      2. AWS Secrets Manager 시크릿 —기존 시크릿을 선택하거나 새 시크릿을 생성하세요. Secrets Manager Confluence 인증 자격 증명을 저장하기 위한 비밀입니다. 새 시크릿을 생성하기로 선택한 경우 AWS Secrets Manager 시크릿 창이 열립니다.

        1. 만들기에 다음 정보를 입력합니다. AWS Secrets Manager 시크릿 윈도우:

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

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

          3. 인증 저장을 선택합니다.

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

      1. 컨플루언스 URL - 컨플루언스 사용자 이름 및 암호.

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

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

        2. 포트 번호 - 호스트 전송 프로토콜에서 사용하는 포트입니다. URL

      3. 인증의 경우 기본 인증 또는 (Confluence Server만 해당) 개인용 액세스 토큰을 선택합니다.

      4. AWS Secrets Manager 비밀 - 기존 암호를 선택하거나 새 암호를 생성합니다. Secrets Manager Confluence 인증 자격 증명을 저장하기 위한 비밀입니다. 새 시크릿을 생성하기로 선택한 경우 AWS Secrets Manager 시크릿 창이 열립니다.

        1. 만들기에 다음 정보를 입력합니다. AWS Secrets Manager 시크릿 윈도우:

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

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

          3. 비밀번호를 저장하고 추가하세요.

    4. IAM 역할 —기존 항목 선택 IAM 역할 또는 새 역할 생성 IAM 리포지토리 자격 증명에 액세스하고 콘텐츠를 인덱싱하기 위한 역할.

      참고

      IAM 색인에 사용되는 역할을 데이터 원본에 사용할 수 없습니다. 기존 역할을 인덱스에 사용하는지 확실하지 않은 경우 새 역할 생성을 선택하여 오류를 방지하십시오. FAQ

    5. Next(다음)를 선택합니다.

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

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

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

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

    4. 실행 일정 동기화에서 빈도 - 빈도를 선택합니다. 빈도를 선택합니다. Amazon Kendra 데이터 소스와 동기화됩니다.

    5. Next(다음)를 선택합니다.

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

    1. 스페이스, 페이지, 블로그의 경우 —다음 중에서 선택 Amazon Kendra 생성된 기본 데이터 원본 필드 또는 인덱스 필드를 추가하기 위한 추가 제안 필드 매핑

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

    3. Next(다음)를 선택합니다.

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

API

연결하려면 Amazon Kendra 컨플루언스로

다음을 사용하여 지정해야 합니다. ConfluenceConfigurationAPI

  • 컨플루언스 버전 - 사용 중인 Confluence 인스턴스의 버전을 CLOUD 또는 SERVER로 지정합니다.

  • 비밀 Amazon 리소스 이름 (ARN) —Amazon 리소스 이름 (ARN) 을 입력합니다. Secrets Manager Confluence 인증 자격 증명이 포함된 암호입니다.

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

    Confluence 사용자 이름과 암호를 인증 자격 증명으로 사용하는 경우 다음 자격 증명이 하나의 구조로 저장됩니다. JSON Secrets Manager 비밀:

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

    개인용 액세스 토큰을 사용하여 Confluence 서버를 연결하는 경우 Amazon Kendra다음 자격 증명을 JSON 구조에 따라 저장합니다. Secrets Manager 비밀:

    {
    "patToken": "personal access token"
}

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

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

  • IAM 역할 —제공을 CreateDataSource 위해 전화를 걸 RoleArn 때 지정하세요. IAM 액세스 권한이 있는 역할 Secrets Manager 비밀을 지키고 Confluence 커넥터에 필요한 APIs 대중에게 전화를 걸고 Amazon Kendra. 자세한 내용은 을 참조하십시오. IAM Confluence 데이터 원본의 역할.

다음 선택적 기능도 추가할 수 있습니다.

  • 웹 프록시 - 웹 프록시를 통해 Confluence URL 인스턴스에 연결할지 여부. 이 옵션을 Confluence 서버에 사용할 수 있습니다.

  • (Confluence 서버에만 해당) 가상 사설 클라우드 (VPC) - 데이터 소스 구성의 VpcConfiguration 일부로 지정합니다. 구성을 참조하십시오. Amazon Kendra VPCa를 사용하려면

  • 포함 및 제외 필터 - 특정 스페이스, 블로그 게시물, 페이지, 스페이스 및 연결을 포함하거나 제외하는 정규식 패턴을 지정합니다. 첨부 파일을 인덱싱하도록 선택하면 인덱싱된 페이지 및 블로그에 대한 첨부 파일만 인덱싱됩니다.

    참고

    대부분의 데이터 소스는 필터라고 하는 포함 또는 제외 패턴인 정규 표현식 패턴을 사용합니다. 포함 필터를 지정하는 경우 포함 필터와 일치하는 콘텐츠만 인덱싱됩니다. 포함 필터와 일치하지 않는 문서는 인덱싱되지 않습니다. 포함 및 제외 필터를 지정하는 경우 제외 필터와 일치하는 문서는 포함 필터와 일치하더라도 인덱싱되지 않습니다.

  • 필드 매핑 - Confluence 데이터 소스 필드를 다음 위치에 매핑하도록 선택합니다. Amazon Kendra 인덱스 필드. 자세한 내용을 알아보려면 데이터 소스 필드 매핑을 참조하세요.

    참고

    다음과 같은 경우에는 문서에 해당하는 문서 본문 필드 또는 문서 본문이 필요합니다. Amazon Kendra 문서를 검색하려면 데이터 원본의 문서 본문 필드 이름을 색인 필드 이름에 매핑해야 _document_body 합니다. 다른 모든 필드는 선택 사항입니다.

  • 사용자 컨텍스트 필터링 및 액세스 제어 —Amazon Kendra 문서에 대한 액세스 제어 목록 (ACL) 이 있는 경우 해당 문서에 대한 액세스 제어 목록을 크롤링합니다. ACL 이 ACL 정보는 문서에 대한 사용자 또는 그룹의 액세스 권한을 기준으로 검색 결과를 필터링하는 데 사용됩니다. 자세한 내용은 사용자 컨텍스트 필터링을 참조하세요.

자세히 알아보기

통합에 대해 자세히 알아보려면 Amazon Kendra Confluence 데이터 소스와 함께 사용하려면 다음을 참조하십시오.