기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # ServiceNow 통합 ServiceNow 통합을 사용하여 인시던트, 문제, 변경 요청, 지식 기반 문서 및 첨부 파일 관리를 포함하여 ServiceNow 인스턴스 내에서 작업을 수행할 수 있습니다. 이 통합은 ServiceNow REST API를 사용합니다. 자세한 내용은 ServiceNow 설명서의 [REST API](https://docs.servicenow.com/bundle/xanadu-api-reference/page/build/applications/concept/api-rest.html)를 참조하세요. 이 통합을 설정하려면 두 단계가 필요합니다. 먼저 ServiceNow 인스턴스에서 OAuth 애플리케이션을 구성합니다. 그런 다음 Amazon Quick에서 통합을 생성하고 ServiceNow 앱에 연결합니다. Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요[인증 방법](quick-action-auth.md). ## 시작하기 전 준비 사항 통합을 설정하기 전에 다음이 있는지 확인합니다. + ServiceNow 인스턴스. 이 통합은 Xanadu 릴리스에 대해 검증되었습니다. + OAuth 애플리케이션을 생성할 수 있는 권한이 있는 ServiceNow 사용자 계정(`admin` 역할 필요). + 서비스 인증(클라이언트 자격 증명)의 경우 인스턴스가 워싱턴 DC 릴리스 이상을 실행 중이어야 합니다. + 구독 요구 사항은 섹션을 참조하세요[콘솔에서 통합 설정](integration-console-setup-process.md). ## ServiceNow OAuth 구성 Amazon Quick을 구성하기 전에 ServiceNow 인스턴스에서 OAuth 애플리케이션 엔드포인트를 생성합니다. Amazon Quick 콘솔로 이동하기 전에 ServiceNow에서 다음 단계를 모두 완료합니다. 자세한 내용은 ServiceNow 설명서의 [클라이언트가 인스턴스에 액세스할 수 있도록 엔드포인트 생성을](https://www.servicenow.com/docs/bundle/xanadu-platform-security/page/administer/security/task/t_CreateEndpointforExternalClients.html) 참조하세요. ### OAuth 애플리케이션 등록 OAuth 애플리케이션을 등록하려면 다음 단계를 완료합니다. 1. ServiceNow 인스턴스에서 **모두** > **시스템 OAuth** > **애플리케이션 레지스트리**로 이동하여 **새로** 만들기를 선택합니다. 1. **외부 클라이언트에 대한 OAuth API 엔드포인트 생성을** 선택합니다. 1. 양식을 작성합니다. + **이름** - OAuth 애플리케이션을 설명하는 이름입니다. + **리디렉션 URL** - `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback` *\$1region\$1*을 해당 AWS 리전(예: `us-east-1`)으로 바꿉니다. 1. **제출**을 선택합니다. 1. 애플리케이션 레지스트리 항목을 다시 열고 **클라이언트 보안** 암호 옆의 잠금 아이콘을 선택하여 값을 표시합니다. 1. **클라이언트 ID** 및 **클라이언트 보안** 암호 값을 복사합니다. Amazon Quick에서 통합을 구성할 때이 정보가 필요합니다. ### 서비스 인증을 위한 추가 단계(클라이언트 자격 증명) 서비스 인증을 사용하려는 경우 OAuth 애플리케이션을 등록한 후 다음 추가 단계를 완료하세요. 클라이언트 자격 증명 권한 부여 유형은 ServiceNow Washington DC 릴리스에 도입되었습니다. 자세한 내용은 ServiceNow 커뮤니티의 [Up Your OAuth2.0 Game: Inbound Client Credentials with Washington DC](https://www.servicenow.com/community/developer-blog/up-your-oauth2-0-game-inbound-client-credentials-with-washington/ba-p/2816891)를 참조하세요. 1. 클라이언트 자격 증명 권한 부여 유형을 활성화합니다. 필터 탐색기 `sys_properties.list` 사용으로 이동하여 다음 값을 사용하여 새 시스템 속성을 생성합니다. + **명칭** – `glide.oauth.inbound.client.credential.grant_type.enabled` + **유형** – `true | false` + **값**-`true` 1. 다음 플러그인이 설치되어 있는지 확인합니다(**관리자** > **애플리케이션 관리자**로 이동). + OAuth 2.0(`com.snc.platform.security.oauth`) + REST API 공급자(`com.glide.rest`) + 인증 범위(`com.glide.auth.scope`) + REST API 인증 범위 플러그인(`com.glide.rest.auth.scope`) 1. 시스템 OAuth > 애플리케이션 **레지스트리에서 OAuth 애플리케이션**으로 돌아갑니다. ** OAuth** **OAuth Application User** 필드가 보이지 않으면 양식에 추가합니다(**구성** > **양식 빌더**를 사용하여 추가). 1. **OAuth 애플리케이션 사용자를** 시스템 관리자 역할이 있는 사용자와 같이 적절한 권한이 있는 사용자로 설정합니다. **중요** 서비스 인증을 사용하면 모든 작업이 구성된 OAuth 애플리케이션 사용자로 실행됩니다. 이 통합에 액세스할 수 있는 모든 Amazon Quick 사용자는 해당 계정의 권한을 사용하여 작업을 수행할 수 있습니다. 조직의 보안 요구 사항에 맞게 계정 권한을 구성합니다. ## Amazon Quick에서 통합 설정 ServiceNow OAuth 구성을 완료한 후 Amazon Quick에서 통합을 생성합니다. 1. Amazon Quick 콘솔에서 **통합을** 선택합니다. 1. **ServiceNow**를 선택하고 추가(더하기 "\$1") 버튼을 선택합니다. 1. 통합 세부 정보를 입력합니다. + **이름** - ServiceNow 통합에 대한 설명 이름입니다. + **설명**(선택 사항) - 통합의 목적입니다. 1. 연결 유형을 선택하고 연결 설정을 입력합니다. 1. **사용자 인증(OAuth)**에서 다음 필드를 구성합니다. + **기본 URL** - `https://{your-instance}.service-now.com` + **클라이언트 ID** - ServiceNow OAuth 애플리케이션의 클라이언트 ID입니다. + **클라이언트 보안 암호** - ServiceNow OAuth 애플리케이션의 클라이언트 보안 암호입니다. + **토큰 URL** - `https://{your-instance}.service-now.com/oauth_token.do` + **인증 URL** - `https://{your-instance}.service-now.com/oauth_auth.do` + **리디렉션 URL** - `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback` 1. **서비스 인증(클라이언트 자격 증명)**에서 다음 필드를 구성합니다. + **인증 유형** Service-to-service OAuth + **기본 URL** - `https://{your-instance}.service-now.com` + **클라이언트 ID** - ServiceNow OAuth 애플리케이션의 클라이언트 ID입니다. + **클라이언트 보안 암호** - ServiceNow OAuth 애플리케이션의 클라이언트 보안 암호입니다. + **토큰 URL** - `https://{your-instance}.service-now.com/oauth_token.do` 1. **Create and continue**를 선택합니다. 1. 통합을 공유할 사용자를 선택합니다. 1. **다음**을 선택합니다. 사용자 인증의 경우 **통합** > **작업** > ServiceNow 통합 이름으로 이동하고 **로그인**을 선택하여 OAuth 권한 부여 흐름을 완료합니다. ## 사용 가능한 작업 통합을 설정한 후 다음 작업을 사용할 수 있습니다. **ServiceNow 사용 가능한 작업** | 카테고리 | 작업 | 설명 | | --- | --- | --- | | 인시던트 | 인시던트 나열 | 기존 인시던트를 검색합니다. | | 인시던트 | 인시던트 생성 | 인시던트 레코드를 생성하여 예상 운영 표준과의 편차를 문서화합니다. | | 인시던트 | 인시던트 보기 | 특정 인시던트의 세부 정보를 검색합니다. | | 인시던트 | 인시던트 업데이트 | 인시던트 레코드를 업데이트합니다. | | 인시던트 | 인시던트 삭제 | 인시던트를 삭제합니다. | | 문제 | 문제 나열 | 기존 문제를 검색합니다. | | 문제 | 문제 생성 | 새 문제 레코드를 생성합니다. | | 문제 | 문제 보기 | 특정 문제 레코드의 세부 정보를 검색합니다. | | 문제 | 문제 업데이트 | 문제 레코드를 업데이트합니다. | | 문제 | 문제 삭제 | 문제를 삭제합니다. | | 변경 요청 | 변경 요청 나열 | 모든 변경 요청을 검색합니다. | | 변경 요청 | 변경 요청 생성 | 변경 요청을 생성하여 승인 및 지원되는 구성 항목(CIs. | | 변경 요청 | 변경 요청 보기 | 특정 변경 요청에 대한 세부 정보를 검색합니다. | | 변경 요청 | 변경 요청 업데이트 | 변경 요청을 수정합니다. | | 변경 요청 | 변경 요청 삭제 | 변경 요청을 삭제합니다. | | 지식 기반 문서 | 지식 기반 문서 생성 | 지식 기반 문서를 생성합니다. 지식 API(sn\$1km\$1api) 플러그인이 필요합니다. | | 지식 기반 문서 | 지식 기반 문서 업데이트 | 지식 기반 문서를 수정합니다. | | 지식 기반 문서 | 지식 기반 문서 삭제 | 지식 기반 문서를 삭제합니다. | | 첨부 파일 | 첨부 파일 메타데이터 검색 | 첨부 파일의 메타데이터를 검색합니다. | | 첨부 파일 | 첨부 파일 메타데이터 검색 | 특정 첨부 파일에 대한 메타데이터를 검색합니다. | | 첨부 파일 | 첨부 파일 콘텐츠 검색 | 이진 파일 첨부 파일 콘텐츠를 검색합니다. | | 첨부 파일 | 이진 첨부 파일 업로드 | 이진 파일을 지정된 레코드에 첨부 파일로 업로드합니다. | | 첨부 파일 | 멀티파트 양식 첨부 파일 업로드 | 멀티파트 파일 첨부 파일을 업로드합니다. | | 첨부 파일 | 첨부 파일 삭제 | 첨부 파일을 삭제합니다. | | Users | 사용자 목록 표시 | 모든 사용자 레코드를 나열합니다. | | 시스템 | 선택 항목 나열 | sys\$1choice 테이블에서 선택 목록 값을 검색합니다. | **참고** 사용 가능한 특정 작업은 ServiceNow 인스턴스에 구성된 권한과 사용된 인증 방법에 따라 달라집니다. ## 제한 사항 이 통합은 UI 정책, UI 작업 또는 클라이언트 스크립트를 적용하지 않는 REST API를 통해 ServiceNow와 상호 작용합니다. 이러한 규칙은 ServiceNow 브라우저 인터페이스에만 적용됩니다. 서버 측 비즈니스 규칙, ACLs 및 데이터 정책이 적용됩니다. 자세한 내용은 ServiceNow 설명서의 [REST API](https://docs.servicenow.com/bundle/xanadu-api-reference/page/integrate/inbound-rest/concept/c_RESTAPI.html)를 참조하세요. ## 관리 및 문제 해결 통합을 편집, 공유 또는 삭제하려면 섹션을 참조하세요[기존 통합 관리](integration-workflows.md#managing-existing-integrations). ### 인증 문제 + **OAuth 권한 부여 실패** - 클라이언트 ID와 클라이언트 보안 암호가 ServiceNow 애플리케이션 레지스트리의 값과 일치하는지 확인합니다. ServiceNow의 리디렉션 URL이 Amazon Quick 구성의 URL과 정확히 일치하는지 확인합니다. + **서비스 인증 실패** - `glide.oauth.inbound.client.credential.grant_type.enabled` 시스템 속성이 로 설정되어 있는지 확인합니다`true`. **OAuth Application User** 필드가 애플리케이션 레지스트리 레코드에 채워져 있는지 확인합니다. ### 일반적인 오류 메시지 + **작업 반환 권한 오류** - ServiceNow 사용자 또는 OAuth 애플리케이션 사용자에게 대상 테이블에 액세스하는 데 필요한 역할(예: 인시던트 관리 `itil` 역할)이 있는지 확인합니다. + **연결 제한 시간 또는 연결할 수 없는 인스턴스** - 기본 URL이 올바른 ServiceNow 인스턴스 이름을 사용하는지 확인합니다. ServiceNow 인스턴스에 액세스할 수 있고 유지 관리 모드가 아닌지 확인합니다.