Salesforce 커넥터 V1.0 - Amazon Kendra
지원되는 기능사전 조건연결 지침

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

Salesforce 커넥터 V1.0

Salesforce는 지원, 영업 및 마케팅 팀을 관리하기 위한 고객 관계 관리(CRM) 도구입니다. Amazon Kendra 를 사용하여 Salesforce 표준 객체와 사용자 지정 객체를 인덱싱할 수 있습니다.

중요

Amazon Kendra 는 Salesforce API 버전 48을 사용합니다. Salesforce API는 하루에 수행할 수 있는 요청 수를 제한합니다. Salesforce는 해당 요청을 초과할 경우 계속할 수 있을 때까지 재시도합니다.

참고

Salesforce 커넥터 V1.0 / SalesforceConfiguration APIWord는 2023년에 종료되었습니다. Salesforce 커넥터 V2.0 / TemplateConfiguration APIWord로 마이그레이션하거나 사용하는 것이 좋습니다.

Amazon Kendra Salesforce 데이터 소스 커넥터 문제 해결은 섹션을 참조하세요데이터 소스 문제 해결.

지원되는 기능

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

  • 필드 매핑

  • 사용자 액세스 제어

  • 포함/제외 필터

사전 조건

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

Salesforce에서 다음을 확인하세요.

  • Salesforce 계정을 생성하고 Salesforce에 연결하는 데 사용하는 사용자 이름 및 암호를 기록했습니다.

  • OAuth가 활성화된 Salesforce 연결 앱 계정을 생성하고 Salesforce 연결 앱에 할당된 소비자 키(클라이언트 ID) 및 소비자 보안 암호(클라이언트 보안 암호)를 복사했습니다. 클라이언트 ID와 클라이언트 보안 암호는 AWS Secrets Manager 보안 암호에 저장된 인증 자격 증명으로 사용됩니다. 자세한 내용은 Connected 앱에 대한 Salesforce 설명서를 참조하세요.

    참고

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

  • Salesforce에 연결하는 데 사용된 계정과 연결된 Salesforce 보안 토큰을 복사했습니다.

  • 인덱싱하려는 Salesforce 인스턴스의 URL를 복사했습니다. 일반적으로 이는 다음과 같습니다.https://<company>.salesforce.com/. 서버가 Salesforce 연결 앱을 실행 중이어야 합니다.

  • ReadOnly 프로파일을 복제한 다음 모든 데이터 보기 및 문서 관리 권한을 추가하여 Salesforce에 대한 읽기 전용 액세스 권한이 있는 사용자의 Salesforce 서버에 자격 증명을 추가했습니다. 이러한 자격 증명은 연결을 수행하는 사용자와에 Amazon Kendra 연결하는 Salesforce 연결 앱을 식별합니다.

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

에 다음 항목이 있는지 AWS 계정확인합니다.

  • Amazon Kendra 인덱스를 생성하고 API를 사용하는 경우 인덱스 ID를 기록했습니다.

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

    참고

    인증 유형 및 자격 증명을 변경하는 경우 올바른 AWS Secrets Manager 보안 암호 ID에 액세스하도록 IAM 역할을 업데이트해야 합니다.

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

    참고

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

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

연결 지침

Salesforce 데이터 소스 Amazon Kendra 에 연결하려면가 데이터에 액세스할 Amazon Kendra 수 있도록 Salesforce 데이터 소스에 필요한 세부 정보를 제공해야 합니다. 아직 Salesforce를 구성하지 않은 경우 섹션을 Amazon Kendra 참조하세요사전 조건.

Console

Salesforce Amazon Kendra 에 연결하려면

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

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

    참고

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

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

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

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

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

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

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

    4. 새 태그 추가 - 리소스를 검색 및 필터링하거나 공유 비용을 추적하기 위한 태그입니다.

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

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

    1. Salesforce URL - 인덱싱하려는 Salesforce 사이트의 인스턴스 URL를 입력합니다.

    2. 인증 유형에서 기존 인증과 신규 인증 정보 중 하나를 선택하여 Salesforce 보안 인증 정보를 저장합니다. 새 보안 암호를 생성하도록 선택하면 AWS Secrets Manager 보안 암호 창이 열립니다.

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

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

        2. 사용자 이름, 암호, 보안 토큰, 소비자 키, 소비자 보안 암호 및 인증 URL의 경우 - Salesforce 계정에서 생성한 인증 자격 증명 값을 입력합니다.

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

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

      참고

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

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

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

    1. 첨부 파일 크롤링 - 첨부된 객체, 기사, 피드를 모두 크롤링하도록 선택합니다.

    2. 표준 객체, 지식 문서 및 Chatter 피드 - 크롤링하려는 Salesforce 개체 또는 콘텐츠 유형을 선택합니다.

      참고

      표준 객체, 지식 문서 또는 chatter 피드 중 하나 이상을 인덱싱하기 위한 구성 정보를 제공해야 합니다. 지식 문서를 크롤링하기로 선택한 경우 인덱싱할 지식 문서 유형, 문서 이름, 모든 지식 문서의 표준 필드를 인덱싱할지 또는 사용자 지정 문서 유형의 필드만 인덱싱할지 여부를 지정해야 합니다. 사용자 지정 문서를 인덱싱하도록 선택한 경우 문서 유형의 내부 이름을 지정해야 합니다. 문서 유형은 최대 10개까지 지정할 수 있습니다.

    3. 빈도 - Amazon Kendra 가 데이터 소스와 동기화하는 빈도입니다.

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

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

    1. 표준 지식 문서, 표준 객체 첨부 파일 및 추가 추천 필드 매핑의 경우 - 인덱스에 매핑하려는 Amazon Kendra 생성된 기본 데이터 소스 필드에서 선택합니다.

      참고

      _document_body에 대한 인덱스 매핑이 필요합니다. Salesforce ID 필드와 Amazon Kendra _document_id 필드 간의 매핑은 변경할 수 없습니다.

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

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

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

API

Salesforce Amazon Kendra 에 연결하려면

다음 API SalesforceConfiguration를 지정해야 합니다.

  • Server URL - 인덱싱하려는 Salesforce 사이트의 인스턴스 URL입니다.

  • 보안 암호 Amazon 리소스 이름(ARN) - Salesforce 계정의 인증 자격 증명이 포함된 Secrets Manager 보안 암호의 Amazon 리소스 이름(ARN)을 제공합니다. 보안 암호는 다음 키를 사용하여 JSON 구조에 저장됩니다.

    {
    "authenticationUrl": "OAUTH endpoint that Amazon Kendra connects to get an OAUTH token",
    "consumerKey": "Application public key generated when you created your Salesforce application",
    "consumerSecret": "Application private key generated when you created your Salesforce application.",
    "password": "Password associated with the user logging in to the Salesforce instance",
    "securityToken": "Token associated with the user account logging in to the Salesforce instance",
    "username": "User name of the user logging in to the Salesforce instance"
}

  • IAM 역할 -를 호출CreateDataSource하여 Secrets Manager 보안 암호에 액세스할 수 있는 권한을 IAM 역할에 제공하고 Salesforce 커넥터 및에 필요한 퍼블릭 APIs를 호출할 RoleArn 때 지정합니다 Amazon Kendra. 자세한 내용은 Salesforce 데이터 소스에 대한IAM 역할을 참조하세요.

  • 표준 객체, 지식 문서 또는 chatter 피드 중 하나 이상을 인덱싱하기 위한 구성 정보를 제공해야 합니다.

    • 표준 객체 - 표준 객체를 크롤링하도록 선택한 경우 표준 객체 이름과 문서 내용이 포함된 표준 객체 테이블의 필드 이름을 지정해야 합니다.

    • 지식 문서 - 지식 문서를 크롤링하기로 선택한 경우 인덱싱할 지식 문서 유형, 인덱싱할 지식 문서의 상태, 모든 지식 문서의 표준 필드를 인덱싱할지 또는 사용자 지정 문서 유형의 필드만 인덱싱할지 여부를 지정해야 합니다.

    • Chatter 피드 - Chatter 피드를 크롤링하도록 선택한 경우 Salesforce FeedItem 테이블에서 인덱싱할 콘텐츠가 포함된 열의 이름을 지정해야 합니다.

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

  • 포함 및 제외 필터 - 특정 파일 첨부 파일을 포함할지 또는 제외할지 여부를 지정합니다.

    참고

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

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

    참고

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

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