View a markdown version of this page

Confluence 데이터 센터 데이터 소스 연결 - Amazon Bedrock

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

Confluence 데이터 센터 데이터 소스 연결

VPC 연결을 설정하고 보안 인증 정보를 AWS Secrets Manager 보안 암호에 저장한 후 지식 기반에 Confluence 데이터 센터 데이터 소스를 생성합니다. 이 페이지에서는 AWS Management Console 또는 API를 사용하여 데이터 소스를 생성한 다음 구성할 수 있는 커넥터 파라미터에 대한 참조를 생성하는 방법을 설명합니다.

참고

먼저 VPC 구성 및 인증 설정을 완료합니다. 데이터 소스에 대한 VPC 연결 구성 및 Confluence 데이터 센터에 대한 기본 또는 PAT 인증 설정 섹션을 참조하세요. VPC 구성 ID와 보안 암호 ARN이 필요합니다.

데이터 소스 생성

Console
Confluence 데이터 센터를 관리형 지식 기반에 연결하려면
  1. 데이터 소스에서 데이터 소스의 이름을 입력합니다.

  2. 데이터 소스 드롭다운에서 Confluence 데이터 센터를 선택합니다.

  3. VPC 구성에서 Confluence 데이터 센터 인스턴스에 도달하는 VPC 구성을 선택하거나 VPC 구성 추가를 선택하여 구성을 생성합니다. 자세한 내용은 데이터 소스에 대한 VPC 연결 구성을 참조하세요.

  4. (선택 사항) 애플리케이션 컨텍스트 경로에 Confluence 데이터 센터 REST API가 제공되는 콘텐츠 경로(예: )를 입력합니다/wiki. REST API가 웹 루트에서 제공되는 경우 비워 둡니다.

  5. (선택 사항, HTTPS만 해당) TLS 인증서에서 Confluence 데이터 센터 인스턴스에 대한 TLS 인증서의 Amazon S3 URI를 제공합니다.

  6. 인증에서 기본 인증 또는 개인 액세스 토큰을 선택한 다음 일치하는 자격 증명이 있는 AWS Secrets Manager 보안 암호를 선택합니다.

  7. (선택 사항) 동기화 범위를 확장하여 크롤링할 엔터티 유형(페이지, 페이지 첨부 파일, 블로그, 블로그 첨부 파일, 개인 공간)을 선택합니다.

  8. (선택 사항) 개체 URLs 확장하여 URL 기반 필터링을 사용하여 특정 Confluence 스페이스, 페이지 및 블로그를 동기화합니다.

  9. (선택 사항) 특정 MIME 유형을 포함하거나 제외하려면 Mime 유형을 확장합니다.

API

Confluence 데이터 센터 데이터 소스를 생성하려면 Agents for 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는 비동기식입니다. 작업이 완료되면 데이터 소스 상태가에서 AVAILABLE CREATING로 전환됩니다.

커넥터 파라미터

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

connectionConfiguration
Field 필수 설명
authType 예 인증 유형입니다. BASIC 또는 로 설정합니다PERSONAL_TOKEN. 인증 방법을(를) 참조하세요.
secretArn 예 Confluence 데이터 센터 자격 증명이 포함된 AWS Secrets Manager 보안 암호의 ARN입니다.
vpcConfiguration 예 Confluence 데이터 센터 인스턴스의 프라이빗 네트워크 경로입니다. 지식 기반에서 VPC 구성의 ID로 설정된 vpcConfigurationId 필드를 포함합니다. 데이터 소스에 대한 VPC 연결 구성을(를) 참조하세요.
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").

인증 방법 변경

UpdateDataSource 작업 또는를 사용하여 데이터 소스를 일치하는 자격 증명이 포함된 새 authType 보안 암호로 업데이트하여 데이터 소스의 인증 방법(예: 기본에서 개인 액세스 토큰으로)을 변경할 수 있습니다 AWS Management Console.

다음 단계

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