기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Drupal
Drupal은 웹 사이트 및 웹 애플리케이션을 만드는 데 사용할 수 있는 오픈 소스 콘텐츠 관리 시스템(CMS)입니다. 를 사용하여 Drupal에서 다음을 인덱싱 Amazon Kendra 할 수 있습니다.
-
콘텐츠 - 기사, 기본 페이지, 기본 블록, 사용자 정의 콘텐츠 유형, 사용자 정의 블록 유형, 사용자 정의 콘텐츠 유형, 사용자 정의 블록 유형
-
설명 - 모든 콘텐츠 유형 및 블록 유형에 해당
-
첨부 파일 - 모든 콘텐츠 유형 및 블록 유형에 해당
Amazon Kendra 콘솔
Amazon Kendra Drupal 데이터 소스 커넥터 문제 해결은 섹션을 참조하세요데이터 소스 문제 해결.
지원 기능
Amazon Kendra Drupal 데이터 소스 커넥터는 다음 기능을 지원합니다.
-
필드 매핑
-
사용자 컨텍스트 필터링
-
포함/제외 필터
-
전체 및 증분 콘텐츠 동기화
-
Virtual Private Cloud(VPC)
사전 조건
Amazon Kendra 를 사용하여 Drupal 데이터 소스를 인덱싱하려면 먼저 Drupal 및 AWS 계정에서 이러한 변경을 수행합니다.
Drupal에서 다음 사항을 갖추었는지 확인하세요.
-
Drupal (Standard) Suite 계정과 관리자 역할을 가진 사용자를 만들었습니다.
-
Drupal 사이트 이름을 복사하고 호스트 URL을 구성했습니다. 예:
https://<hostname>/<drupalsitename>
. -
사용자 이름(Drupal 웹 사이트 로그인 사용자 이름) 및 암호(Drupal 웹 사이트 암호)를 포함하는 기본 보안 인증을 구성했습니다.
-
권장: OAuth 2.0 보안 인증 토큰을 구성했습니다. 이 토큰을 Drupal 암호 부여, 클라이언트 ID, 클라이언트 보안 암호, 사용자 이름(Drupal 웹 사이트 로그인 사용자 이름) 및 암호(Drupal 웹 사이트 암호)와 함께 사용하여 Amazon Kendra에 연결합니다.
-
관리자 역할을 사용하여 Drupal 계정에 다음 권한을 추가했습니다.
-
블록 관리
-
블록_콘텐츠 디스플레이 관리
-
블록_콘텐츠 필드 관리
-
블록_콘텐츠 양식 디스플레이 관리
-
뷰 관리
-
사용자 이메일 주소 보기
-
게시되지 않은 자체 콘텐츠 보기
-
페이지 수정본 보기
-
기사 수정본 보기
-
모든 수정본 보기
-
관리 테마 보기
-
콘텐츠 액세스
-
콘텐츠 개요 액세스
-
설명 액세스
-
콘텐츠 검색
-
파일 개요 액세스
-
상황별 링크에 액세스
참고
사용자 정의 콘텐츠 유형 또는 사용자 정의 블록 유형이 있거나 Drupal 웹 사이트에 보기 및 블록이 추가된 경우 관리자 액세스 권한을 제공해야 합니다.
-
에서 다음 사항을 확인해야 AWS 계정합니다.
-
Amazon Kendra 인덱스를 생성하고 API를 사용하는 경우 인덱스 ID를 기록했습니다.
-
데이터 소스에 대한 IAM 역할을 생성하고 API를 사용하는 경우 IAM 역할의 ARN을 기록했습니다.
참고
인증 유형과 자격 증명을 변경하는 경우 올바른 AWS Secrets Manager 보안 암호 ID에 액세스하도록 IAM 역할을 업데이트해야 합니다.
-
Drupal 보안 인증 정보를 AWS Secrets Manager 보안 암호에 저장했고 API를 사용하는 경우 보안 암호의 ARN을 기록했습니다.
참고
보안 인증 정보와 보안 암호를 정기적으로 새로 고치거나 교체하는 것이 좋습니다. 보안을 위해 필요한 액세스 수준만 제공하세요. 데이터 소스, 커넥터 버전 1.0 및 2.0(해당하는 경우) 간에 보안 인증 정보와 보안 암호를 재사용하지 않는 것이 좋습니다.
기존 IAM 역할이나 보안 암호가 없는 경우 Drupal 데이터 소스를 연결할 때 콘솔을 사용하여 새 IAM 역할 및 Secrets Manager 보안 암호를 생성할 수 있습니다 Amazon Kendra. API를 사용하는 경우 기존 IAM 역할 및 Secrets Manager 보안 암호의 ARN과 인덱스 ID를 제공해야 합니다.
연결 지침
Drupal 데이터 소스 Amazon Kendra 에 연결하려면가 데이터에 액세스할 Amazon Kendra 수 있도록 Drupal 자격 증명의 세부 정보를 제공해야 합니다. 에 대해 Drupal을 아직 구성하지 않은 경우 섹션을 Amazon Kendra 참조하세요사전 조건.
Drupal Amazon Kendra 에 연결하려면
-
에 로그인 AWS Management Console 하고 Amazon Kendra 콘솔
을 엽니다. -
왼쪽 탐색 창에서 인덱스를 선택한 다음 인덱스 목록에서 사용할 인덱스를 선택합니다.
참고
인덱스 설정에서 사용자 액세스 제어 설정을 구성하거나 편집할 수 있습니다.
-
시작하기 페이지에서 데이터 소스 추가를 선택합니다.
-
데이터 소스 추가 페이지에서 Drupal 커넥터를 선택한 다음 커넥터 추가를 선택합니다. 버전 2(해당하는 경우)를 사용하는 경우 "V2.0" 태그가 있는 Drupal 커넥터를 선택합니다.
-
데이터 소스 세부 정보 지정 페이지에서 다음 정보를 입력합니다.
-
이름 및 설명에서 데이터 소스 이름에 데이터 소스의 이름을 입력합니다. 하이픈은 포함할 수 있지만 공백은 포함할 수 없습니다.
-
(선택 사항) 설명 - 데이터 소스에 대한 선택적 설명을 입력합니다.
-
기본 언어 - 문서를 인덱스로 필터링할 언어를 선택합니다. 달리 지정하지 않는 한, 언어는 영어로 기본 설정됩니다. 문서 메타데이터에 지정된 언어가 선택한 언어보다 우선합니다.
-
태그에서 새 태그 추가 - 리소스를 검색 및 필터링하거나 AWS 비용을 추적하는 선택적 태그를 포함합니다.
-
Next(다음)를 선택합니다.
-
-
액세스 및 보안 정의 페이지에서 다음 정보를 입력합니다.
-
소스 내, 호스트 URL의 경우 - Drupal 사이트의 호스트 URL. 예:
https://<hostname>/<drupalsitename>
. -
SSL 인증서 위치 - Amazon S3 버킷에 저장된 SSL 인증서의 경로를 입력합니다.
-
권한 부여 - ACL이 있고 액세스 제어에 사용하려는 경우 문서에 대한 ACL(액세스 제어 목록) 정보를 켜거나 끕니다. ACL은 사용자와 그룹이 액세스할 수 있는 문서를 지정합니다. ACL 정보는 검색 결과를 문서에 대한 사용자 또는 그룹의 액세스 권한을 기준으로 필터링하는 데 사용됩니다. 자세한 내용은 사용자 컨텍스트 필터링을 참조하세요.
-
인증의 경우 - 사용 사례에 따라 기본 인증, OAuth 2.0 인증 중에서 선택합니다.
-
AWS Secrets Manager 보안 암호 - 기존 보안 암호를 선택하거나 새 Secrets Manager 보안 암호를 생성하여 Drupal 인증 자격 증명을 저장합니다. 새 암호를 만들기로 선택하면 AWS Secrets Manager 보안 암호 창이 열립니다.
-
AWS Secrets Manager 보안 암호 생성 창에 다음 정보를 입력합니다.
-
기본 인증을 선택한 경우 복사한 보안 암호 이름, 사용자 이름(Drupal 사이트 사용자 이름), 암호(Drupal 사이트 암호)를 입력하고 저장 및 보안 암호 추가를 선택합니다.
-
OAuth 2.0 인증을 선택한 경우 Drupal 계정에서 생성한 보안 암호 이름, 사용자 이름(Drupal 사이트 사용자 이름), 암호(Drupal 사이트 암호), 클라이언트 ID, 클라이언트 보안 암호를 입력하고 보안 암호 저장 및 추가를 선택합니다.
-
-
저장(Save)을 선택합니다.
-
-
Virtual Private Cloud(VPC) - VPC를 사용하기로 선택할 수 있습니다. 그렇다면 서브넷과 VPC 보안 그룹을 추가해야 합니다.
-
자격 증명 크롤러 - Amazon Kendra의 자격 증명 크롤러를 켤지 여부를 지정합니다. 자격 증명 크롤러는 문서에 대한 ACL(액세스 제어 목록) 정보를 사용하여 문서에 대한 사용자 또는 그룹 액세스를 기반으로 검색 결과를 필터링합니다. 문서에 대한 ACL이 있고 ACL을 사용하도록 선택한 경우 Amazon Kendra의 자격 증명 크롤러를 켜서 검색 결과의 사용자 컨텍스트 필터링을 구성할 수도 있습니다. 그렇지 않으면 자격 증명 크롤러가 꺼지면 모든 문서를 공개적으로 검색할 수 있습니다. 문서에 대한 액세스 제어를 사용하고 자격 증명 크롤러가 꺼져 있는 경우 PutPrincipalMapping API를 사용하여 사용자 컨텍스트 필터링을 위한 사용자 및 그룹 액세스 정보를 업로드할 수 있습니다.
-
IAM 역할 - 기존 IAM 역할을 선택하거나 새 IAM 역할을 생성하여 리포지토리 자격 증명 및 인덱스 콘텐츠에 액세스합니다.
참고
IAM 인덱스에 사용되는 역할은 데이터 소스에 사용할 수 없습니다. 기존 역할을 인덱스나 FAQ에 사용하는지 확실하지 않은 경우 새 역할 생성을 선택하여 오류를 방지하세요.
-
Next(다음)를 선택합니다.
-
-
동기화 설정 구성 페이지에 다음 정보를 입력합니다.
-
동기화 범위에서 다음 옵션을 선택합니다.
참고
기사, 기본 페이지, 기본 블록을 크롤링하도록 선택하면 해당 기본 필드가 자동으로 동기화됩니다. 설명, 첨부 파일, 사용자 지정 필드 및 기타 사용자 지정 개체를 동기화하도록 선택할 수도 있습니다.
-
개체 선택의 경우:
-
기사 - 기사, 설명, 첨부 파일을 크롤링할지 여부를 선택합니다.
-
기본 페이지 - 기본 페이지, 설명, 첨부 파일을 크롤링할지 여부를 선택합니다.
-
기본 블록 - 기본 블록, 설명, 첨부 파일을 크롤링할지 여부를 선택합니다.
-
사용자 지정 콘텐츠 유형 및 사용자 지정 블록을 추가하도록 선택할 수도 있습니다.
-
-
-
추가 구성 - 선택 사항의 경우:
-
정규식 패턴의 경우 - 정규 표현식 패턴을 추가하여 특정 개체 제목 및 파일 이름을 포함하거나 제외합니다. 최대 100개의 패턴을 추가할 수 있습니다.
-
-
동기화 모드 - 데이터 소스 콘텐츠가 변경될 때 인덱스를 업데이트하는 방법을 선택합니다. 데이터 소스를 Amazon Kendra 와 처음 동기화하면 기본적으로 모든 콘텐츠가 크롤링되고 인덱싱됩니다. 동기화 모드 옵션으로 전체 동기화를 선택하지 않은 경우에도 초기 동기화가 실패한 경우 데이터의 전체 동기화를 실행해야 합니다.
-
전체 동기화: 데이터 소스가 인덱스와 동기화될 때마다 기존 콘텐츠를 대체하여 모든 콘텐츠를 새로 인덱싱합니다.
-
신규, 수정, 삭제된 동기화: 데이터 소스가 인덱스와 동기화될 때마다 신규, 수정 및 삭제된 콘텐츠만 인덱싱합니다.는 데이터 소스의 메커니즘을 사용하여 콘텐츠 변경 사항을 추적하고 마지막 동기화 이후 변경된 콘텐츠를 인덱싱할 Amazon Kendra 수 있습니다.
-
-
동기화 실행 일정의 빈도 - Amazon Kendra 가 데이터 소스와 동기화할 빈도를 선택합니다.
-
Next(다음)를 선택합니다.
-
-
필드 매핑 설정 페이지에 다음 정보를 입력합니다.
-
콘텐츠, 설명 및 첨부 파일 - Amazon Kendra 생성된 기본 데이터 소스 필드 중에서 인덱스에 매핑할 필드를 선택합니다.
-
필드 추가 - 사용자 지정 데이터 소스 필드를 추가하려면 매핑할 인덱스 필드 이름과 필드 데이터 유형을 만듭니다.
-
Next(다음)를 선택합니다.
-
-
검토 및 생성 페이지에서 입력한 정보가 정확한지 확인한 다음 데이터 소스 추가를 선택합니다. 이 페이지에서 정보를 편집하도록 선택할 수도 있습니다. 데이터 소스가 성공적으로 추가된 후 데이터 소스 페이지에 데이터 소스가 표시됩니다.
Notes
-
Drupal API에는 공식적인 제한 한도가 없습니다.
-
Drupal에는 Java SDK를 사용할 수 없습니다.
-
Drupal 데이터는 네이티브 JSON API를 사용해야만 가져올 수 있습니다.
-
Drupal 뷰와 연결되지 않은 콘텐츠 유형은 크롤링할 수 없습니다.
-
Drupal 블록에서 데이터를 크롤링하려면 관리자 액세스 권한이 필요합니다.
-
HTTP 동사를 사용하여 사용자 정의 콘텐츠 유형을 생성하는 데 사용할 수 있는 JSON API는 없습니다.
-
기사, 기본 페이지, 기본 블록, 사용자 정의 콘텐츠 유형 및 사용자 정의 블록 유형의 문서 본문과 설명은 HTML 형식으로 표시됩니다. HTML 콘텐츠의 형식이 올바르지 않으면 HTML 관련 태그가 문서 본문과 설명에 나타나고 Amazon Kendra 검색 결과에 표시됩니다.
-
설명이나 본문이 없는 콘텐츠 유형 및 블록 유형은 수집되지 않습니다 Amazon Kendra. 이러한 콘텐츠 또는 블록 유형의 설명 및 첨부 파일만 Amazon Kendra 인덱스에 수집됩니다.