기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
ServiceNow 통합
ServiceNow 통합을 사용하여 인시던트, 문제, 변경 요청, 지식 기반 문서 및 첨부 파일 관리를 포함하여 ServiceNow 인스턴스 내에서 작업을 수행할 수 있습니다. 이 통합은 ServiceNow REST API를 사용합니다. 자세한 내용은 ServiceNow 설명서의 REST API
이 통합을 설정하려면 두 단계가 필요합니다. 먼저 ServiceNow 인스턴스에서 OAuth 애플리케이션을 구성합니다. 그런 다음 Amazon Quick에서 통합을 생성하고 ServiceNow 앱에 연결합니다. Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요인증 방법.
시작하기 전 준비 사항
통합을 설정하기 전에 다음이 있는지 확인합니다.
-
ServiceNow 인스턴스. 이 통합은 Xanadu 릴리스에 대해 검증되었습니다.
-
OAuth 애플리케이션을 생성할 수 있는 권한이 있는 ServiceNow 사용자 계정(
admin역할 필요). -
서비스 인증(클라이언트 자격 증명)의 경우 인스턴스가 워싱턴 DC 릴리스 이상을 실행 중이어야 합니다.
-
구독 요구 사항은 섹션을 참조하세요콘솔에서 통합 설정.
ServiceNow OAuth 구성
Amazon Quick을 구성하기 전에 ServiceNow 인스턴스에서 OAuth 애플리케이션 엔드포인트를 생성합니다. Amazon Quick 콘솔로 이동하기 전에 ServiceNow에서 다음 단계를 모두 완료합니다.
자세한 내용은 ServiceNow 설명서의 클라이언트가 인스턴스에 액세스할 수 있도록 엔드포인트 생성을
OAuth 애플리케이션 등록
OAuth 애플리케이션을 등록하려면 다음 단계를 완료합니다.
-
ServiceNow 인스턴스에서 모두 > 시스템 OAuth > 애플리케이션 레지스트리로 이동하여 새로 만들기를 선택합니다.
-
외부 클라이언트에 대한 OAuth API 엔드포인트 생성을 선택합니다.
-
양식을 작성합니다.
-
이름 - OAuth 애플리케이션을 설명하는 이름입니다.
-
리디렉션 URL -
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback{region}을 해당 AWS 리전(예:us-east-1)으로 바꿉니다.
-
-
제출을 선택합니다.
-
애플리케이션 레지스트리 항목을 다시 열고 클라이언트 보안 암호 옆의 잠금 아이콘을 선택하여 값을 표시합니다.
-
클라이언트 ID 및 클라이언트 보안 암호 값을 복사합니다. Amazon Quick에서 통합을 구성할 때이 정보가 필요합니다.
서비스 인증을 위한 추가 단계(클라이언트 자격 증명)
서비스 인증을 사용하려는 경우 OAuth 애플리케이션을 등록한 후 다음 추가 단계를 완료하세요. 클라이언트 자격 증명 권한 부여 유형은 ServiceNow Washington DC 릴리스에 도입되었습니다. 자세한 내용은 ServiceNow 커뮤니티의 Up Your OAuth2.0 Game: Inbound Client Credentials with Washington DC
-
클라이언트 자격 증명 권한 부여 유형을 활성화합니다. 필터 탐색기
sys_properties.list사용으로 이동하여 다음 값을 사용하여 새 시스템 속성을 생성합니다.-
명칭 –
glide.oauth.inbound.client.credential.grant_type.enabled -
유형 –
true | false -
값-
true
-
-
다음 플러그인이 설치되어 있는지 확인합니다(관리자 > 애플리케이션 관리자로 이동).
-
OAuth 2.0(
com.snc.platform.security.oauth) -
REST API 공급자(
com.glide.rest) -
인증 범위(
com.glide.auth.scope) -
REST API 인증 범위 플러그인(
com.glide.rest.auth.scope)
-
-
시스템 OAuth > 애플리케이션 레지스트리에서 OAuth 애플리케이션으로 돌아갑니다. OAuth OAuth Application User 필드가 보이지 않으면 양식에 추가합니다(구성 > 양식 빌더를 사용하여 추가).
-
OAuth 애플리케이션 사용자를 시스템 관리자 역할이 있는 사용자와 같이 적절한 권한이 있는 사용자로 설정합니다.
중요
서비스 인증을 사용하면 모든 작업이 구성된 OAuth 애플리케이션 사용자로 실행됩니다. 이 통합에 액세스할 수 있는 모든 Amazon Quick 사용자는 해당 계정의 권한을 사용하여 작업을 수행할 수 있습니다. 조직의 보안 요구 사항에 맞게 계정 권한을 구성합니다.
Amazon Quick에서 통합 설정
ServiceNow OAuth 구성을 완료한 후 Amazon Quick에서 통합을 생성합니다.
-
Amazon Quick 콘솔에서 통합을 선택합니다.
-
ServiceNow를 선택하고 추가(더하기 "+") 버튼을 선택합니다.
-
통합 세부 정보를 입력합니다.
-
이름 - ServiceNow 통합에 대한 설명 이름입니다.
-
설명(선택 사항) - 통합의 목적입니다.
-
-
연결 유형을 선택하고 연결 설정을 입력합니다.
-
사용자 인증(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
-
-
서비스 인증(클라이언트 자격 증명)에서 다음 필드를 구성합니다.
-
인증 유형 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
-
-
-
Create and continue를 선택합니다.
-
통합을 공유할 사용자를 선택합니다.
-
다음을 선택합니다.
사용자 인증의 경우 통합 > 작업 > ServiceNow 통합 이름으로 이동하고 로그인을 선택하여 OAuth 권한 부여 흐름을 완료합니다.
사용 가능한 작업
통합을 설정한 후 다음 작업을 사용할 수 있습니다.
| 카테고리 | 작업 | 설명 |
|---|---|---|
| 인시던트 | 인시던트 나열 | 기존 인시던트를 검색합니다. |
| 인시던트 | 인시던트 생성 | 인시던트 레코드를 생성하여 예상 운영 표준과의 편차를 문서화합니다. |
| 인시던트 | 인시던트 보기 | 특정 인시던트의 세부 정보를 검색합니다. |
| 인시던트 | 인시던트 업데이트 | 인시던트 레코드를 업데이트합니다. |
| 인시던트 | 인시던트 삭제 | 인시던트를 삭제합니다. |
| 문제 | 문제 나열 | 기존 문제를 검색합니다. |
| 문제 | 문제 생성 | 새 문제 레코드를 생성합니다. |
| 문제 | 문제 보기 | 특정 문제 레코드의 세부 정보를 검색합니다. |
| 문제 | 문제 업데이트 | 문제 레코드를 업데이트합니다. |
| 문제 | 문제 삭제 | 문제를 삭제합니다. |
| 변경 요청 | 변경 요청 나열 | 모든 변경 요청을 검색합니다. |
| 변경 요청 | 변경 요청 생성 | 변경 요청을 생성하여 승인 및 지원되는 구성 항목(CIs. |
| 변경 요청 | 변경 요청 보기 | 특정 변경 요청에 대한 세부 정보를 검색합니다. |
| 변경 요청 | 변경 요청 업데이트 | 변경 요청을 수정합니다. |
| 변경 요청 | 변경 요청 삭제 | 변경 요청을 삭제합니다. |
| 지식 기반 문서 | 지식 기반 문서 생성 | 지식 기반 문서를 생성합니다. 지식 API(sn_km_api) 플러그인이 필요합니다. |
| 지식 기반 문서 | 지식 기반 문서 업데이트 | 지식 기반 문서를 수정합니다. |
| 지식 기반 문서 | 지식 기반 문서 삭제 | 지식 기반 문서를 삭제합니다. |
| 첨부 파일 | 첨부 파일 메타데이터 검색 | 첨부 파일의 메타데이터를 검색합니다. |
| 첨부 파일 | 첨부 파일 메타데이터 검색 | 특정 첨부 파일에 대한 메타데이터를 검색합니다. |
| 첨부 파일 | 첨부 파일 콘텐츠 검색 | 이진 파일 첨부 파일 콘텐츠를 검색합니다. |
| 첨부 파일 | 이진 첨부 파일 업로드 | 이진 파일을 지정된 레코드에 첨부 파일로 업로드합니다. |
| 첨부 파일 | 멀티파트 양식 첨부 파일 업로드 | 멀티파트 파일 첨부 파일을 업로드합니다. |
| 첨부 파일 | 첨부 파일 삭제 | 첨부 파일을 삭제합니다. |
| Users | 사용자 목록 표시 | 모든 사용자 레코드를 나열합니다. |
| 시스템 | 선택 항목 나열 | sys_choice 테이블에서 선택 목록 값을 검색합니다. |
참고
사용 가능한 특정 작업은 ServiceNow 인스턴스에 구성된 권한과 사용된 인증 방법에 따라 달라집니다.
제한 사항
이 통합은 UI 정책, UI 작업 또는 클라이언트 스크립트를 적용하지 않는 REST API를 통해 ServiceNow와 상호 작용합니다. 이러한 규칙은 ServiceNow 브라우저 인터페이스에만 적용됩니다. 서버 측 비즈니스 규칙, ACLs 및 데이터 정책이 적용됩니다. 자세한 내용은 ServiceNow 설명서의 REST API
관리 및 문제 해결
통합을 편집, 공유 또는 삭제하려면 섹션을 참조하세요기존 통합 관리.
인증 문제
-
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 인스턴스에 액세스할 수 있고 유지 관리 모드가 아닌지 확인합니다.
