기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# ServiceNow 커넥터 V1.0
ServiceNow는 IT 서비스, 티켓팅 시스템 및 지원과 같은 조직 수준의 워크플로를 생성하고 관리하기 위한 클라우드 기반 서비스 관리 시스템을 제공합니다. Amazon Kendra 를 사용하여 ServiceNow 카탈로그, 지식 문서 및 첨부 파일을 인덱싱할 수 있습니다.
**참고**
ServiceNow 커넥터 V1.0/ServiceNowConfiguration API에 대한 지원은 2023년에 종료되었습니다. ServiceNow 커넥터 V2.0 / TemplateConfiguration API로 마이그레이션하거나 이를 사용하는 것이 좋습니다.
Amazon Kendra ServiceNow 데이터 소스 커넥터의 문제 해결은 섹션을 참조하세요[데이터 소스 문제 해결](troubleshooting-data-sources.md).
**Topics**
+ [지원되는 기능](#supported-features-v1-servicenow)
+ [사전 조건](#prerequisites-v1-servicenow)
+ [연결 지침](#data-source-procedure-v1-servicenow)
+ [자세히 알아보기](#servicenow-v1-learn-more)
## 지원되는 기능
Amazon Kendra ServiceNow 데이터 소스 커넥터는 다음 기능을 지원합니다.
+ ServiceNow 인스턴스 버전: 런던, 기타
+ 포함/제외 패턴: 서비스 카탈로그, 지식 문서, 첨부 파일
## 사전 조건
Amazon Kendra 를 사용하여 ServiceNow 데이터 소스를 인덱싱하려면 먼저 ServiceNow 및 AWS 계정에서 이러한 변경을 수행합니다.
**ServiceNow에서 다음을 확인하세요.**
+ ServiceNow 관리자 계정을 생성하고 ServiceNow 인스턴스를 생성했습니다.
+ ServiceNow 인스턴스 URL의 호스트를 복사했습니다. 예를 들어 인스턴스의 URL이 {{https://your-domain.service-now.com}}인 경우 입력하는 호스트 URL의 형식은 {{your-domain.service-now.com}}입니다.
+ Amazon Kendra 가 ServiceNow 인스턴스에 연결하도록 허용하는 사용자 이름과 암호가 포함된 기본 보안 인증 정보를 기록했습니다.
**참고**
보안 인증 정보와 보안 암호를 정기적으로 새로 고치거나 교체하는 것이 좋습니다. 보안을 위해 필요한 액세스 수준만 제공하세요. 데이터 소스, 커넥터 버전 1.0 및 2.0(해당하는 경우) 간에 보안 인증 정보와 보안 암호를 재사용하지 **않는** 것이 좋습니다.
+ **선택 사항:** 사용자 이름, 암호, 클라이언트 ID Amazon Kendra 및 클라이언트 암호를 식별하고 생성할 수 있는 OAuth 2.0 자격 증명 토큰을 구성했습니다. 사용자 이름과 암호는 ServiceNow 지식 기반 및 서비스 카탈로그에 대한 액세스를 제공해야 합니다. 자세한 내용은 [OAuth 2.0 인증에 대한 ServiceNow 설명서](https://www.servicenow.com/docs/bundle/utah-platform-security/page/integrate/single-sign-on/concept/c_Authentication.html)를 참조하세요.
+ 다음 권한을 추가했습니다.
+ 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 인덱스를 생성하고](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) API를 사용하는 경우 인덱스 ID를 기록했습니다.
+ 데이터 소스에 대한 [IAM 역할을 생성](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds)했으며 API를 사용하는 경우 IAM 역할의 ARN을 기록했습니다.
**참고**
인증 유형과 자격 증명을 변경하는 경우 올바른 AWS Secrets Manager 보안 암호 ID에 액세스하도록 IAM 역할을 업데이트해야 합니다.
+ ServiceNow 보안 인증 정보를 AWS Secrets Manager 보안 암호에 저장했고 API를 사용하는 경우 보안 암호의 ARN을 기록했습니다.
**참고**
보안 인증 정보와 보안 암호를 정기적으로 새로 고치거나 교체하는 것이 좋습니다. 보안을 위해 필요한 액세스 수준만 제공하세요. 데이터 소스, 커넥터 버전 1.0 및 2.0(해당하는 경우) 간에 보안 인증 정보와 보안 암호를 재사용하지 **않는** 것이 좋습니다.
기존 IAM 역할이나 보안 암호가 없는 경우 ServiceNow 데이터 소스를 연결할 때 콘솔을 사용하여 새 IAM 역할 및 Secrets Manager 보안 암호를 생성할 수 있습니다 Amazon Kendra. API를 사용하는 경우 기존 IAM 역할 및 Secrets Manager 보안 암호의 ARN과 인덱스 ID를 제공해야 합니다.
## 연결 지침
ServiceNow 데이터 소스 Amazon Kendra 에 연결하려면가 데이터에 액세스할 Amazon Kendra 수 있도록 ServiceNow 데이터 소스에 필요한 세부 정보를 제공해야 합니다. 에 대해 아직 ServiceNow를 구성하지 않은 경우 섹션을 Amazon Kendra 참조하세요[사전 조건](#prerequisites-v1-servicenow).
------
#### [ Console ]
**ServiceNow Amazon Kendra 에 연결하려면**
1. AWS Management Console에 로그인하고 [Amazon Kendra 콘솔](https://console.aws.amazon.com/kendra/)을 엽니다.
1. 왼쪽 탐색 창에서 **인덱스**를 선택한 다음 인덱스 목록에서 사용할 인덱스를 선택합니다.
**참고**
**인덱스 설정**에서 **사용자 액세스 제어** 설정을 구성하거나 편집할 수 있습니다.
1. **시작하기** 페이지에서 **데이터 소스 추가**를 선택합니다.
1. **데이터 소스 추가** 페이지에서 **ServiceNow 커넥터 V1.0**을 선택한 다음 **데이터 소스 추가**를 선택합니다.
1. **데이터 소스 세부 정보 지정** 페이지에서 다음 정보를 입력합니다.
1. **이름 및 설명**에서 **데이터 소스 이름**에 데이터 소스의 이름을 입력합니다. 하이픈은 포함할 수 있지만 공백은 포함할 수 없습니다.
1. (선택 사항) **설명** - 데이터 소스에 대한 선택적 설명을 입력합니다.
1. **기본 언어** - 인덱스에 사용할 문서를 필터링할 언어를 선택합니다. 달리 지정하지 않는 한, 언어는 영어로 기본 설정됩니다. 문서 메타데이터에 지정된 언어가 선택한 언어보다 우선합니다.
1. **태그**에서 **새 태그 추가** - 리소스를 검색 및 필터링하거나 AWS 비용을 추적하는 선택적 태그를 포함합니다.
1. **다음**을 선택합니다.
1. **액세스 및 보안 정의** 페이지에서 다음 정보를 입력합니다.
1. **ServiceNow 호스트** - ServiceNow 호스트 URL을 입력합니다.
1. **ServiceNow 버전** - ServiceNow 버전을 선택합니다.
1. 사용 사례에 따라 **기본 인증**, **OAuth 2.0 인증** 중에서 선택합니다.
1. **AWS Secrets Manager 보안 암호** - 기존 보안 암호를 선택하거나 새 Secrets Manager 보안 암호를 생성하여 ServiceNow 인증 자격 증명을 저장합니다. 새 암호를 만들기로 선택하면 AWS Secrets Manager 보안 암호 창이 열립니다.
1. **보안 암호 이름** - 보안 암호의 이름. 'AmazonKendra-ServiceNow-'라는 접두사가 보안 암호 이름에 자동으로 추가됩니다.
1. 기본 인증을 사용하는 경우 - ServiceNow 계정의 **보안 암호 이름**, **사용자 이름** 및 **암호**를 입력합니다.
OAuth2 인증을 사용하는 경우 - ServiceNow 계정에서 생성한 **보안 암호 이름**, **사용자 이름**, **암호**, **클라이언트 ID** 및 **클라이언트 보안 암호**를 입력합니다.
1. **저장 및 보안 암호 추가**를 선택합니다.
1. **IAM 역할** - 기존 IAM 역할을 선택하거나 새 IAM 역할을 생성하여 리포지토리 자격 증명 및 인덱스 콘텐츠에 액세스합니다.
**참고**
IAM 인덱스에 사용되는 역할은 데이터 소스에 사용할 수 없습니다. 기존 역할을 인덱스나 FAQ에 사용하는지 확실하지 않은 경우 **새 역할 생성**을 선택하여 오류를 방지하세요.
1. **다음**을 선택합니다.
1. **동기화 설정 구성** 페이지에 다음 정보를 입력합니다.
1. **지식 문서 포함** - 지식 문서를 인덱싱하도록 선택합니다.
1. **지식 문서 유형** - 사용 사례에 따라 **공개 문서만 포함**과 **ServiceNow 필터 쿼리를 기반으로 문서 포함** 중에서 선택합니다. **ServiceNow 필터 쿼리를 기반으로 문서 포함**을 선택하는 경우 ServiceNow 계정에서 복사한 **필터 쿼리**를 입력해야 합니다.
1. **지식 문서 첨부 파일 포함** - 지식 문서 첨부 파일을 인덱싱하도록 선택합니다. 인덱싱할 특정 파일 형식을 선택할 수도 있습니다.
1. **카탈로그 항목 포함** - 카탈로그 항목을 인덱싱하도록 선택합니다.
1. **카탈로그 항목 첨부 파일 포함** - 카탈로그 항목 첨부 파일을 인덱싱하려면 선택합니다. 인덱싱할 특정 파일 형식을 선택할 수도 있습니다.
1. **빈도** - Amazon Kendra 가 데이터 소스와 동기화하는 빈도입니다.
1. **다음**을 선택합니다.
1. **필드 매핑 설정** 페이지에 다음 정보를 입력합니다.
1. **지식 문서** 및 **서비스 카탈로그** - Amazon Kendra 생성된 기본 데이터 소스 필드와 인덱스에 매핑하려는 추가 제안 필드 매핑 중에서 선택합니다.
1. **필드 추가** - 사용자 지정 데이터 소스 필드를 추가하려면 매핑할 인덱스 필드 이름과 필드 데이터 유형을 만듭니다.
1. **다음**을 선택합니다.
1. **검토 및 생성** 페이지에서 입력한 정보가 정확한지 확인한 다음 **데이터 소스 추가**를 선택합니다. 이 페이지에서 정보를 편집하도록 선택할 수도 있습니다. 데이터 소스가 성공적으로 추가된 후 **데이터 소스** 페이지에 데이터 소스가 표시됩니다.
------
#### [ API ]
**ServiceNow Amazon Kendra 에 연결하려면**
[ServiceNowConfiguration API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ServiceNowConfiguration.html)를 사용하여 다음을 지정해야 합니다.
+ **데이터 소스 URL** - ServiceNow URL을 지정합니다. 호스트 엔드포인트는 {{your-domain.service-now.com}}과 같은 형식이어야 합니다.
+ **데이터 소스 호스트 인스턴스** - ServiceNow 호스트 인스턴스 버전을 `LONDON` 또는 `OTHERS`로 지정합니다.
+ **보안 암호 Amazon 리소스 이름(ARN)** - ServiceNow 계정에서 생성한 인증 자격 증명이 포함된 Secrets Manager 보안 암호의 Amazon 리소스 이름(ARN)을 제공합니다.
기본 인증을 사용하는 경우 보안 암호는 다음 키가 있는 JSON 구조에 저장됩니다.
```
{
"username": {{"user name"}},
"password": {{"password"}}
}
```
OAuth2 인증을 사용하는 경우 보안 암호는 다음 키가 있는 JSON 구조에 저장됩니다.
```
{
"username": "{{user name}}",
"password": "{{password}}",
"clientId": "{{client id}}",
"clientSecret": "{{client secret}}"
}
```
+ **IAM 역할** -를 호출`CreateDataSource`하여 Secrets Manager 보안 암호에 액세스하고 ServiceNow 커넥터 및에 필요한 퍼블릭 APIs를 호출할 수 있는 권한을 IAM 역할에 제공하는 `RoleArn` 시기를 지정합니다 Amazon Kendra. 자세한 내용은 [ServiceNow 데이터 소스에 대한IAM 역할](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds)을 참조하세요.
다음 선택적 기능도 추가할 수 있습니다.
+ **필드 매핑** - ServiceNow 데이터 소스 필드를 Amazon Kendra 인덱스 필드에 매핑하기로 선택합니다. 자세한 내용을 알아보려면 [데이터 소스 필드 매핑](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html)을 참조하세요.
**참고**
가 문서를 Amazon Kendra 검색하려면 문서 본문 필드 또는 해당 문서에 해당하는 문서 본문이 필요합니다. 데이터 소스의 문서 본문 필드 이름을 인덱스 필드 이름 `_document_body`에 매핑해야 합니다. 다른 모든 필드는 선택 사항입니다.
+ **포함 및 제외 필터** - 카탈로그와 지식 문서의 특정 파일 첨부 파일을 포함할지 또는 제외할지 여부를 지정합니다.
**참고**
대부분의 데이터 소스는 필터라고 하는 포함 또는 제외 패턴인 정규 표현식 패턴을 사용합니다. 포함 필터를 지정하는 경우 포함 필터와 일치하는 콘텐츠만 인덱싱됩니다. 포함 필터와 일치하지 않는 문서는 인덱싱되지 않습니다. 포함 및 제외 필터를 지정하는 경우 제외 필터와 일치하는 문서는 포함 필터와 일치하더라도 인덱싱되지 않습니다.
+ **인덱싱 파라미터** - 다음을 수행할지 여부를 지정할 수도 있습니다.
+ 지식 문서 및 서비스 카탈로그 또는 이 두 가지를 모두 인덱싱합니다. 지식 문서 및 서비스 카탈로그 항목을 인덱싱하도록 선택한 경우 Amazon Kendra 인덱스의 인덱스 문서 내용 필드에 매핑되는 ServiceNow 필드의 이름을 제공해야 합니다.
+ 지식 문서 및 카탈로그 항목에 대한 첨부 파일을 인덱싱합니다.
+ 하나 이상의 지식 기반에서 문서를 선택하는 ServiceNow 쿼리를 사용하세요. 지식 기반은 공개 또는 비공개일 수 있습니다. 자세한 내용을 알아보려면 [쿼리로 인덱싱할 문서 지정](https://docs.aws.amazon.com/kendra/latest/dg/servicenow-query.html)을 참조하세요.
------
## 자세히 알아보기
ServiceNow 데이터 소스 Amazon Kendra 와 통합하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [Amazon Kendra ServiceNow Online 커넥터 시작하기](https://aws.amazon.com/blogs/machine-learning/getting-started-with-amazon-kendra-servicenow-online-connector/)