ServiceNow 커넥터 V1.0 - Amazon Kendra

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

ServiceNow 커넥터 V1.0

ServiceNow IT 서비스, 티켓 시스템 및 지원과 같은 조직 수준의 워크플로를 만들고 관리할 수 있는 클라우드 기반 서비스 관리 시스템을 제공합니다. ServiceNow 카탈로그, 기술 문서 및 Amazon Kendra 첨부 파일을 인덱싱하는 데 사용할 수 있습니다.

참고

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

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

지원되는 기능

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

  • ServiceNow 인스턴스 버전: 런던, 기타

  • 포함/제외 패턴: 서비스 카탈로그, 지식 문서, 첨부 파일

필수 조건

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

ServiceNow에서 다음이 있는지 확인하세요.

  • ServiceNow 관리자 계정을 만들고 ServiceNow 인스턴스를 생성했습니다.

  • ServiceNow 인스턴스 URL의 호스트를 복사했습니다. 예를 들어 인스턴스의 URL이 https://your-domain.service-now.com인 경우 입력하는 호스트 URL의 형식은 your-domain.service-now.com입니다.

  • ServiceNow 인스턴스에 연결할 수 있는 사용자 이름과 암호가 포함된 기본 인증 자격 증명을 기록해 두었습니다. Amazon Kendra

    참고

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

  • 선택 사항: 사용자 이름, 암호, 클라이언트 ID Amazon Kendra 및 클라이언트 암호를 식별하고 생성할 수 있는 OAuth 2.0 자격 증명 토큰을 구성했습니다. 사용자 이름과 암호는 ServiceNow 지식 기반 및 서비스 카탈로그에 대한 액세스를 제공해야 합니다. 자세한 내용은 OAuth 2.0 인증 ServiceNow 설명서를 참조하십시오.

  • 다음 권한을 추가했습니다.

    • kb_category

    • kb_knowledge

    • kb_knowledge_base

    • kb_uc_cannot_read_mtom

    • kb_uc_can_read_mtom

    • sc_catalog

    • sc_category

    • sc_cat_item

    • 시스템_어태치먼트

    • sys_attachment_doc

    • sys_user_role

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

에 다음이 있는지 확인하세요. AWS 계정

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

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

    참고

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

  • ServiceNow 인증 자격 증명을 AWS Secrets Manager 비밀에 저장하고 API를 사용하는 경우 비밀의 ARN을 기록했습니다.

    참고

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

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

연결 지침

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

Console

Amazon Kendra 연결하려면 ServiceNow

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

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

    참고

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

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

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

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

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

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

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

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

    5. 다음을 선택합니다.

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

    1. ServiceNow 호스트 - 호스트 URL을 입력합니다. ServiceNow

    2. ServiceNow 버전 —버전을 선택합니다. ServiceNow

    3. 사용 사례에 따라 기본 인증, OAuth 2.0 인증 중에서 선택합니다.

    4. AWS Secrets Manager 비밀 - 기존 암호를 선택하거나 새 암호를 생성하여 ServiceNow 인증 Secrets Manager 자격 증명을 저장합니다. 새 암호를 만들기로 선택하면 AWS Secrets Manager 보안 암호 창이 열립니다.

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

      2. 기본 인증을 사용하는 경우 - 계정의 비밀 이름, 사용자 이름, 비밀번호를 입력합니다. ServiceNow

        OAuth2 인증을 사용하는 경우 - 계정에서 생성한 비밀 이름, 사용자 이름, 암호, 클라이언트 ID, 클라이언트 암호를 입력합니다. ServiceNow

      3. 저장 및 보안 암호 추가를 선택합니다.

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

      참고

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

    6. 다음을 선택합니다.

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

    1. 지식 문서 포함 - 지식 문서를 인덱싱하도록 선택합니다.

    2. 참조 문서 유형 - 사용 사례에 따라 공개 문서만 포함과 ServiceNow 필터 쿼리를 기반으로 문서 포함 중에서 선택합니다. ServiceNow 필터 쿼리 기반 문서 포함을 선택하는 경우 ServiceNow 계정에서 복사한 필터 쿼리를 입력해야 합니다.

    3. 지식 문서 첨부 파일 포함 - 지식 문서 첨부 파일을 인덱싱하도록 선택합니다. 인덱싱할 특정 파일 형식을 선택할 수도 있습니다.

    4. 카탈로그 항목 포함 - 카탈로그 항목을 인덱싱하도록 선택합니다.

    5. 카탈로그 항목 첨부 파일 포함 - 카탈로그 항목 첨부 파일을 인덱싱하려면 선택합니다. 인덱싱할 특정 파일 형식을 선택할 수도 있습니다.

    6. 빈도 Amazon Kendra - 데이터 원본과 동기화하는 빈도.

    7. 다음을 선택합니다.

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

    1. 참조 문서서비스 카탈로그 - Amazon Kendra 생성된 기본 데이터 원본 필드와 색인에 매핑하려는 추가 제안 필드 매핑 중에서 선택합니다.

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

    3. 다음을 선택합니다.

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

API

연결하려면 Amazon Kendra ServiceNow

ServiceNowConfiguration API를 사용하여 다음을 지정해야 합니다.

  • 데이터 소스 URL ServiceNow —URL을 지정합니다. 호스트 엔드포인트는 your-domain.service-now.com과 같은 형식이어야 합니다.

  • 데이터 원본 호스트 인스턴스 ServiceNow —호스트 인스턴스 버전을 또는 LONDON 로 지정합니다. OTHERS

  • 비밀 Amazon 리소스 이름 (ARN) - 계정에서 생성한 인증 자격 증명이 포함된 Secrets Manager 암호의 Amazon 리소스 이름 (ARN) 을 제공합니다. ServiceNow

    기본 인증을 사용하는 경우 보안 암호는 다음 키가 있는 JSON 구조에 저장됩니다.

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

    OAuth2 인증을 사용하는 경우 보안 암호는 다음 키가 있는 JSON 구조에 저장됩니다.

    { "username": "user name", "password": "password", "clientId": "client id", "clientSecret": "client secret" }
  • IAM 역할 CreateDataSource Secrets Manager —비밀에 액세스할 수 있는 권한을 IAM 역할을 제공하고 커넥터 및 에 필요한 퍼블릭 API를 호출하기 위해 호출할 RoleArn 시기를 지정합니다. ServiceNow Amazon Kendra자세한 내용은 ServiceNow 데이터 원본의IAM 역할을 참조하십시오.

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

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

    참고

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

  • 포함 및 제외 필터 - 카탈로그와 지식 문서의 특정 파일 첨부 파일을 포함할지 또는 제외할지 여부를 지정합니다.

    참고

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

  • 인덱싱 파라미터 - 다음을 수행할지 여부를 지정할 수도 있습니다.

    • 지식 문서 및 서비스 카탈로그 또는 이 두 가지를 모두 인덱싱합니다. 참조 문서 및 서비스 카탈로그 항목을 색인화하기로 선택한 경우 색인의 색인 문서 콘텐츠 ServiceNow 필드에 매핑되는 필드의 Amazon Kendra 이름을 제공해야 합니다.

    • 지식 문서 및 카탈로그 항목에 대한 첨부 파일을 인덱싱합니다.

    • 하나 이상의 지식 기반에서 문서를 선택하는 ServiceNow 쿼리를 사용하십시오. 지식 기반은 공개 또는 비공개일 수 있습니다. 자세한 내용을 알아보려면 쿼리로 인덱싱할 문서 지정을 참조하세요.

자세히 알아보기

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