Adobe Experience Manager - Amazon Kendra
지원되는 기능필수 조건연결 지침

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

Adobe Experience Manager

Adobe Experience Manager는 웹 사이트 또는 모바일 앱 콘텐츠를 만드는 데 사용되는 콘텐츠 관리 시스템입니다. 를 Amazon Kendra 사용하여 페이지 Adobe Experience Manager 및 콘텐츠 자산에 연결하고 이를 인덱싱할 수 있습니다.

Amazon Kendra 클라우드 서비스 작성자 인스턴스 및 Adobe Experience Manager 온프레미스 작성자 및 게시 인스턴스로 Adobe Experience Manager (AEM) 을 지원합니다.

Amazon Kendra 콘솔 또는 API를 사용하여 Adobe Experience Manager 데이터 원본에 연결할 Amazon Kendra 수 있습니다. TemplateConfiguration

Amazon Kendra Adobe Experience Manager 데이터 소스 커넥터 문제 해결에 대한 자세한 내용은 을 참조하십시오데이터 소스 문제 해결.

지원되는 기능

Adobe Experience Manager 데이터 소스 커넥터에서 지원하는 기능은 다음과 같습니다.

  • 필드 매핑

  • 사용자 액세스 제어

  • 포함/제외 필터

  • 전체 및 점진적 콘텐츠 동기화

  • OAuth 2.0 및 기본 인증

  • Virtual Private Cloud(VPC)

필수 조건

Adobe Experience Manager데이터 원본을 Amazon Kendra 인덱싱하는 데 사용하려면 먼저 Adobe Experience Manager 및 AWS 계정에서 다음과 같이 변경하십시오.

Adobe Experience Manager에서 다음 사항을 갖추었는지 확인하세요.

  • 관리자 권한이 있는 계정 또는 관리자 사용자에 액세스합니다.

  • Adobe Experience Manager 호스트 URL을 복사했습니다.

    참고

    (온프레미스/서버) AWS Secrets Manager 는 에 포함된 엔드포인트 정보가 데이터 원본 구성 세부 정보에 지정된 엔드포인트 정보와 동일한지 Amazon Kendra 확인합니다. 이렇게 하면 사용자가 작업을 수행할 권한이 없지만 구성된 보안 암호에 액세스하여 작업을 수행하는 데 Amazon Kendra 를 프록시로 사용하는 보안 문제인 혼동된 대리자 문제를 방지하는 데 도움이 됩니다. 나중에 엔드포인트 정보를 변경하는 경우 새 보안 암호를 생성하여 이 정보를 동기화해야 합니다.

  • 관리자 사용자 이름과 암호의 기본 인증 보안 인증 정보를 기록했습니다.

    참고

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

  • 선택 사항: Adobe Experience Manager (AEM) 에서 OAuth 2.0 자격 증명을 클라우드 서비스 또는 AEM 온프레미스로 구성했습니다. AEM온프레미스를 사용하는 경우 보안 인증 정보에는 클라이언트 ID, 클라이언트 암호 및 프라이빗 키가 포함됩니다. 클라우드 서비스형 AEM을 사용하는 경우 보안 인증 정보에는 클라이언트 ID, 클라이언트 보안 암호, 프라이빗 키, 조직 ID, 기술 계정 ID 및 Adobe Identity Management System(IMS) 호스트가 포함됩니다. 클라우드 서비스형 AEM의 보안 인증 정보를 생성하는 방법에 대한 자세한 내용은 Adobe Experience Manager 설명서를 참조하세요. AEM 온프레미스의 경우 Adobe Granite OAuth 2.0 서버 구현(com.adobe.granite.oauth.server)은 AEM의 OAuth 2.0 서버 기능에 대한 지원을 제공합니다.

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

에 다음이 있는지 확인하십시오. AWS 계정

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

  • 데이터 소스에 대한 IAM 역할을 만들고 API를 사용하는 경우 역할의 IAM ARN을 기록했습니다.

    참고

    인증 유형과 자격 증명을 변경하는 경우 올바른 AWS Secrets Manager 비밀 ID에 액세스하려면 IAM 역할을 업데이트해야 합니다.

  • Adobe Experience Manager 보안 인증 정보를 AWS Secrets Manager 보안 암호에 저장했고 API를 사용하는 경우 보안 암호의 ARN을 기록했습니다.

    참고

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

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

연결 지침

Adobe Experience Manager데이터 Amazon Kendra 원본에 연결하려면 데이터에 액세스할 Amazon Kendra 수 있도록 Adobe Experience Manager 데이터 원본의 필수 세부 정보를 제공해야 합니다. 아직 구성하지 않은 경우 Adobe Experience Manager 을 Amazon Kendra참조하십시오필수 조건.

Console

Amazon Kendra 연결하려면 Adobe Experience Manager

  1. 에 AWS Management Console 로그인하고 Amazon Kendra 콘솔을 엽니다.

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

    참고

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

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

  4. 데이터 소스 추가 페이지에서 Adobe Experience Manager 커넥터를 선택한 다음 커넥터 추가를 선택합니다. 버전 2 (해당하는 경우) 를 사용하는 경우 “V2.0" 태그가 있는 Adobe Experience Manager 커넥터를 선택하십시오.

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

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

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

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

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

    5. 다음을 선택합니다.

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

    1. 소스 - AEM 온프레미스 또는 클라우드 서비스형 AEM을 선택합니다.

      Adobe Experience Manager 호스트 URL을 입력합니다. 예를 들어 AEM 온프레미스를 사용하는 경우 호스트 이름과 포트를 포함해야 합니다. https://hostname:port 클라우드 서비스형 AEM을 사용하는 경우 작성자 URL을 사용할 수 있습니다. https://author-xxxxxx-xxxxxxx.adobeaemcloud.com

    2. SSL 인증서 위치 - Amazon S3 버킷에 저장된 SSL 인증서의 경로를 입력합니다. 이를 사용하여 보안 SSL 연결로 AEM 온프레미스에 연결합니다.

    3. 승인 —ACL이 있고 액세스 제어에 사용하려는 경우 문서에 대한 액세스 제어 목록 (ACL) 정보를 켜거나 끕니다. ACL은 사용자와 그룹이 액세스할 수 있는 문서를 지정합니다. ACL 정보는 검색 결과를 문서에 대한 사용자 또는 그룹의 액세스 권한을 기준으로 필터링하는 데 사용됩니다. 자세한 내용은 사용자 컨텍스트 필터링을 참조하세요.

    4. 인증 - 기본 인증 또는 OAuth 2.0 인증을 선택합니다. 그런 다음 기존 AWS Secrets Manager 암호를 선택하거나 Adobe Experience Manager 자격 증명을 저장할 새 암호를 생성합니다. 새 암호를 만들기로 선택하면 AWS Secrets Manager 비밀 창이 열립니다.

      기본 인증을 선택한 경우 암호 이름, Adobe Experience Manager 사이트 사용자 이름 및 암호를 입력합니다. 사용자는 관리자 권한이 있거나 관리자 사용자여야 합니다.

      OAuth 2.0 인증을 선택하고 AEM 온프레미스를 사용하는 경우 암호, 클라이언트 ID, 클라이언트 보안 암호 및 프라이빗 키의 이름을 입력합니다. 클라우드 서비스형 AEM을 사용하는 경우 보안 암호 이름, 클라이언트 ID, 클라이언트 보안 암호, 프라이빗 키, 조직 ID, 기술 계정 ID 및 Adobe Identity Management System(IMS) 호스트를 입력합니다.

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

    5. Virtual Private Cloud(VPC) - VPC를 사용하기로 선택할 수 있습니다. 그렇다면 서브넷과 VPC 보안 그룹을 추가해야 합니다.

    6. 아이덴티티 크롤러 - 아이덴티티 크롤러를 활성화할지 여부를 지정합니다. Amazon Kendra ID 크롤러는 문서에 대한 액세스 제어 목록 (ACL) 정보를 사용하여 문서에 대한 사용자 또는 그룹의 액세스 권한을 기준으로 검색 결과를 필터링합니다. 문서에 대한 ACL이 있고 ACL을 사용하기로 선택한 경우 ID 크롤러를 활성화하여 검색 결과에 대한 Amazon Kendra사용자 컨텍스트 필터링을 구성할 수도 있습니다. 그렇지 않으면 ID 크롤러를 끄면 모든 문서를 공개적으로 검색할 수 있습니다. 문서에 대한 액세스 제어를 사용하고 싶은데 ID 크롤러가 꺼져 있는 경우 PutPrincipalMappingAPI를 사용하여 사용자 컨텍스트 필터링을 위한 사용자 및 그룹 액세스 정보를 업로드할 수도 있습니다.

    7. IAM 역할 - 기존 역할을 선택하거나 새 IAM IAM 역할을 생성하여 리포지토리 자격 증명에 액세스하고 콘텐츠를 인덱싱합니다.

      참고

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

    8. 다음을 선택합니다.

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

    1. 동기화 범위 - 특정 콘텐츠 유형, 페이지 구성 요소 및 루트 경로를 크롤링하기 위한 제한을 설정하고 정규식 패턴을 사용하여 콘텐츠를 필터링합니다.

      1. 콘텐츠 유형 - 페이지나 자산만 크롤링할지, 아니면 둘 다 크롤링할지 선택합니다.

      2. (선택 사항) 추가 구성 - 다음 설정을 구성합니다.

        • 페이지 구성 요소 - 페이지 구성 요소의 특정 이름입니다. 페이지 구성 요소는 Adobe Experience Manager 템플릿 편집기와 함께 작동하도록 설계된 확장 가능한 페이지 구성 요소로, 템플릿 편집기로 페이지 머리글/바닥글 및 구조 구성 요소를 조합할 수 있습니다.

        • 컨텐츠 조각 변형 - 컨텐츠 조각 변형의 특정 이름. 컨텐츠 조각을 사용하면 Adobe Experience Manager에서 페이지에 구애받지 않는 컨텐츠를 설계, 생성, 큐레이션 및 게시할 수 있습니다. 이를 통해 여러 위치/여러 채널에서 바로 사용할 수 있도록 콘텐츠를 준비할 수 있습니다.

        • 루트 경로 - 특정 콘텐츠의 루트 경로입니다.

        • Regex 패턴 - 특정 페이지 및 자산을 포함하거나 제외하기 위한 정규 표현식 패턴입니다.

    2. 동기화 모드 - 데이터 소스 콘텐츠가 변경될 때 인덱스를 업데이트하는 방법을 선택합니다. 데이터 원본을 처음으로 동기화하는 경우 기본적으로 모든 콘텐츠가 크롤링되고 색인됩니다. Amazon Kendra 동기화 모드 옵션으로 전체 동기화를 선택하지 않더라도 초기 동기화에 실패한 경우 데이터의 전체 동기화를 실행해야 합니다.

      • 전체 동기화: 모든 콘텐츠를 새로 인덱싱하여 데이터 소스가 색인과 동기화될 때마다 기존 콘텐츠를 대체합니다.

      • 신규, 수정된 동기화: 데이터 소스가 색인과 동기화될 때마다 새 콘텐츠와 수정된 콘텐츠만 인덱싱합니다. Amazon Kendra 데이터 원본의 메커니즘을 사용하여 콘텐츠 변경 사항을 추적하고 마지막 동기화 이후 변경된 콘텐츠를 인덱싱할 수 있습니다.

      • 새 콘텐츠, 수정된 콘텐츠, 삭제된 동기화: 데이터 원본이 색인과 동기화될 때마다 새 콘텐츠, 수정된 콘텐츠, 삭제된 콘텐츠만 색인화합니다. Amazon Kendra 데이터 원본의 메커니즘을 사용하여 콘텐츠 변경 사항을 추적하고 마지막 동기화 이후 변경된 콘텐츠를 인덱싱할 수 있습니다.

    3. 시간대 ID - AEM 온프레미스를 사용하고 서버의 시간대가 Amazon Kendra AEM 커넥터 또는 인덱스의 시간대와 다른 경우 AEM 커넥터 또는 인덱스에 맞춰 서버 시간대를 지정할 수 있습니다. AEM 온프레미스의 기본 시간대는 Amazon Kendra AEM 커넥터 또는 인덱스의 시간대입니다. 클라우드 서비스형 AEM의 기본 시간대는 그리니치 표준시입니다.

    4. 빈도용 동기화 실행 일정 —데이터 원본 콘텐츠를 동기화하고 색인을 업데이트하는 빈도를 선택합니다.

    5. 다음을 선택합니다.

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

    1. Amazon Kendra 생성된 기본 데이터 원본 필드 중에서 색인에 매핑할 필드를 선택합니다. 사용자 지정 데이터 소스 필드를 추가하려면 매핑할 인덱스 필드 이름과 필드 데이터 유형을 만듭니다.

    2. 다음을 선택합니다.

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

API

Amazon Kendra 연결하려면 Adobe Experience Manager

TemplateConfiguration API를 사용하여 데이터 소스 스키마의 JSON을 지정해야 합니다. 다음 정보를 제공해야 합니다.

  • 데이터 원본 - TemplateConfigurationJSON 스키마를 사용할 AEM 때와 같이 데이터 원본 유형을 지정합니다. 또한 API를 TEMPLATE 호출할 때와 같이 데이터 소스를 지정하십시오. CreateDataSource

  • AEM 호스트 URL - Adobe Experience Manager 호스트 URL을 지정합니다. 예를 들어 AEM 온프레미스를 사용하는 경우 호스트 이름과 포트를 포함해야 합니다. https://hostname:port 클라우드 서비스형 AEM을 사용하는 경우 작성자 URL을 사용할 수 있습니다. https://author-xxxxxx-xxxxxxx.adobeaemcloud.com

  • 동기화 모드 - 데이터 소스 콘텐츠가 변경될 때 색인을 업데이트하는 방법을 Amazon Kendra 지정합니다. 데이터 원본을 처음으로 동기화하는 경우 기본적으로 모든 콘텐츠가 크롤링되고 색인됩니다. Amazon Kendra 동기화 모드 옵션으로 전체 동기화를 선택하지 않더라도 초기 동기화에 실패한 경우 데이터의 전체 동기화를 실행해야 합니다. 다음 중에서 선택할 수 있습니다.

    • FORCED_FULL_CRAWL모든 콘텐츠를 새로 인덱싱하려면 데이터 원본이 색인과 동기화될 때마다 기존 콘텐츠를 교체해야 합니다.

    • FULL_CRAWL데이터 원본이 색인과 동기화될 때마다 새 콘텐츠, 수정된 콘텐츠, 삭제된 콘텐츠만 색인화하도록 합니다. Amazon Kendra 데이터 원본의 메커니즘을 사용하여 콘텐츠 변경 사항을 추적하고 마지막 동기화 이후 변경된 콘텐츠를 인덱싱할 수 있습니다.

    • CHANGE_LOG데이터 소스가 색인과 동기화될 때마다 새 콘텐츠와 수정된 콘텐츠만 인덱싱합니다. Amazon Kendra 데이터 원본의 메커니즘을 사용하여 콘텐츠 변경 사항을 추적하고 마지막 동기화 이후 변경된 콘텐츠를 인덱싱할 수 있습니다.

  • 인증 유형 - 사용하려는 인증 유형(Basic 또는 OAuth2)을 지정합니다.

  • AEM 유형 - 사용할 Adobe Experience Manager 유형(CLOUD 또는 ON_PREMISE)을 지정합니다.

  • 보안 암호 Amazon 리소스 이름(ARN) - AEM 온프레미스 또는 클라우드에 기본 인증을 사용하려는 경우 사용자 이름 및 암호의 인증 보안 인증 정보를 저장하는 보안 암호를 제공합니다. 비밀의 Amazon 리소스 이름 (ARN) 을 AWS Secrets Manager 제공합니다. 보안 암호는 다음 키가 있는 JSON 구조로 저장됩니다.

    {
    "aemUrl": "Adobe Experience Manager On-Premise host URL",
    "username": "user name with admin permissions",
    "password": "password with admin permissions"
}

    AEM 온프레미스에 OAuth 2.0 인증을 사용하려는 경우 보안 암호는 다음 키를 사용하여 JSON 구조에 저장됩니다.

    {
    "aemUrl": "Adobe Experience Manager host URL",
    "clientId": "client ID",
    "clientSecret": "client secret",
    "privateKey": "private key"
}

    클라우드 서비스형 AEM에 OAuth 2.0 인증을 사용하려는 경우 보안 암호는 다음 키를 사용하여 JSON 구조에 저장됩니다.

    {
    "clientId": "client ID",
    "clientSecret": "client secret",
    "privateKey": "private key",
    "orgId": "organization ID",
    "technicalAccountId": "technical account ID",
    "imsHost": "Adobe Identity Management System (IMS) host"
}

  • IAM 역할 - 역할을 CreateDataSource 호출하여 Secrets Manager 비밀에 액세스할 수 있는 권한을 제공하고 Adobe Experience Manager 커넥터 및 에 필요한 공개 API를 호출할 RoleArn 시기를 지정합니다. IAM Amazon Kendra자세한 내용은 Adobe Experience Manager 데이터 소스에 대한IAM 역할을 참조하세요.

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

  • Virtual Private Cloud(VPC) - CreateDataSource를 호출할 때 VpcConfiguration을 지정합니다. 자세한 정보는 Amazon Kendra 를 사용하도록 구성 Amazon VPC을 참조하세요.

  • 시간대 ID - AEM On-Premise를 사용하고 서버의 시간대가 Amazon Kendra AEM 커넥터 또는 인덱스의 시간대와 다른 경우 AEM 커넥터 또는 색인에 맞게 서버 시간대를 지정할 수 있습니다.

    AEM 온프레미스의 기본 시간대는 AEM 커넥터 또는 인덱스의 시간대입니다. Amazon Kendra 클라우드 서비스형 AEM의 기본 시간대는 그리니치 표준시입니다.

    지원되는 시간대 ID에 대한 자세한 내용은 Adobe Experience Manager JSON 스키마를 참조하세요.

  • 포함 및 제외 필터 - 특정 페이지 및 자산을 포함할지 또는 제외할지 여부를 지정합니다.

    참고

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

  • 아이덴티티 크롤러 - 아이덴티티 크롤러를 활성화할지 여부를 지정합니다. Amazon Kendra ID 크롤러는 문서에 대한 액세스 제어 목록 (ACL) 정보를 사용하여 문서에 대한 사용자 또는 그룹의 액세스 권한을 기준으로 검색 결과를 필터링합니다. 문서에 대한 ACL이 있고 ACL을 사용하기로 선택한 경우 ID 크롤러를 활성화하여 검색 결과에 대한 Amazon Kendra사용자 컨텍스트 필터링을 구성할 수도 있습니다. 그렇지 않으면 ID 크롤러를 끄면 모든 문서를 공개적으로 검색할 수 있습니다. 문서에 대한 액세스 제어를 사용하고 싶은데 ID 크롤러가 꺼져 있는 경우 PutPrincipalMappingAPI를 사용하여 사용자 컨텍스트 필터링을 위한 사용자 및 그룹 액세스 정보를 업로드할 수도 있습니다.

  • 필드 매핑 - Adobe Experience Manager 데이터 소스 필드를 Amazon Kendra 인덱스 필드에 매핑하기로 선택합니다. 자세한 내용을 알아보려면 데이터 소스 필드 매핑을 참조하세요.

    참고

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

구성해야 할 기타 중요한 JSON 키 목록은 Adobe Experience Manager 템플릿 스키마를 참조하세요.