SOAP Web Service
SOAP(Simple Object Access Protocol)는 HTTP를 통해 웹 서비스에 액세스하는 데 사용되는 XML 기반 프로토콜입니다.
웹 서비스 공급자
- 직접 웹 서비스: URL 쿼리를 사용하여 테이블의 WSDL을 요청합니다.
- SOAP 웹 서비스 임포트 세트: 임포트 테이블 및 변환 맵을 사용하여 테이블에 대한 웹 서비스 요청을 자동화합니다.
- Scripted SOAP Web Services: 사용자 지정 JavaScript를 사용하여 SOAP Web Services 요청을 실행합니다.
WSDL
모든 테이블과 임포트 세트는 테이블 스키마와 사용 가능한 작업을 설명하는 WSDL(Web Service Definition Language) XML 문서를 동적으로 생성합니다.
https://myinstance.service-now.com/incident.do?WSDL
HTTP를 통해 액세스할 수 있는 동적으로 생성되고 제공되는 ServiceNow 모든 WSDL은 Open Source Initiative OSI - Apache License, Version 2.0 라이센스 계약에 정의된 조건에 따라 사용할 수 있습니다.
장기 실행 SOAP 요청 지원
는 Now Platform 요청이 처리되는 동안 네트워크 연결의 비활성으로 인한 소켓 시간 초과를 방지하여 장기 실행 SOAP 요청을 지원합니다.
이 기능은 많은 수의 레코드를 요청하거나, 집계 쿼리를 수행하거나, 정렬이 필요한 정렬 기준 식을 사용할 때 ODBC 드라이버의 효율성을 향상시킵니다.
기본적으로 시스템은 ODBC 드라이버 및 MID Server와 같은 에서 제공하는 ServiceNow 웹 서비스 클라이언트에 대해 시간 초과 보호를 제공합니다. 시스템 속성을 사용하여 사용자 지정 웹 서비스에 시간 초과 보호를 추가할 수 있습니다.
시간 초과 보호
웹 서비스 클라이언트는 긴 세션을 활성 상태로 유지하고 소켓 비활성으로 인한 시간 초과를 방지하기 위해 307-임시 리디렉션을 수신합니다. 307-임시 리디렉션은 상태 코드를 지원하는 웹 서비스 클라이언트가 HTTP 위치 헤더에 지정된 위치에 대한 마지막 요청을 반복하도록 합니다. 위치 헤더의 값은 웹 서비스 클라이언트가 원래 지정한 URL과 동일합니다. 307-임시 리디렉션의 사용은 WS-I 규격입니다.
- 의 glide.soapprocessor.allow_long_running_threads 값은 true입니다.
- 요청은 URL 매개 변수를 redirectSupported=true 포함합니다.
- 요청은 세션을 인식합니다(HTTP 쿠키 지원).
- 리디렉션 수가 에 의해 설정된 glide.soap.max_redirects값을 초과하지 않았습니다.
SOAP 웹 서비스 보안
인스턴스는 HTTPS 프로토콜을 통한 기본 인증 챌린지/응답과 컨텍스트 보안을 사용하는 시스템 수준 ACL(접근 제어 목록)의 조합을 사용하여 웹 서비스 보안을 적용합니다. 관리자는 SOAP 역할 중 하나를 부여하여 사용자가 액세스할 수 있는 시스템 자원 웹 서비스를 제어할 수 있습니다.
SOAP 역할
SOAP 웹 서비스를 사용하려면 수행할 작업에 대한 적절한 역할이 있어야 합니다. 또한 대상 테이블에 액세스하는 데 필요한 다른 역할이 있어야 합니다.
| 역할 | 설명 |
|---|---|
| Soap | 모든 SOAP 작업을 수행할 수 있습니다. |
| soap_create | 새 기록을 삽입할 수 있습니다. |
| soap_delete | 기존 기록을 삭제할 수 있습니다. |
| soap_ecc | 큐 [ecc_queue] 테이블에서 기록을 쿼리, 삽입 및 삭제할 수 있습니다. |
| soap_query | 기록 정보를 쿼리할 수 있습니다. |
| soap_query_update | 기록 정보를 쿼리하고 기록을 업데이트할 수 있습니다. |
| soap_script | .do 엔드포인트를 지정하는 스크립트를 실행할 수 있습니다. 이 역할은 스크립트된 웹 서비스를 실행하는 데 필요합니다. |
| soap_update | 기록을 업데이트할 수 있습니다. |
| import_admin | 임포트 세트와 임포트의 모든 측면을 관리할 수 있습니다. 임포트 세트 행 [sys_import_set_row] 테이블에 접근하는 데 필요합니다. |
| import_transformer | 임포트 세트 변환 맵을 관리하고 변환을 실행할 수 있습니다. 임포트 세트 행 [sys_import_set_row] 테이블에 접근하는 데 필요합니다. |
기본 웹 서비스 역할 요구 사항
기본적으로 프로세서 ACL 규칙 세트에서는 사용자에게 WSDL, XSD 및 XML 스키마 요청을 작성할 수 있는 soap_query 역할이 있어야 합니다.
이러한 역할 요구 사항을 변경하려면 ACL 규칙을 비활성화할 수 있습니다.
기본 인증
각 WSDL 또는 SOAP 메시지 요청의 인스턴스와 연결된 사용자에 대해 기본 인증을 적용하기 위해 관리자는 glide.basicauth.required 속성을 true로 설정할 수 있습니다.
사용 가능한 경우, 각 WSDL 및 SOAP 요청에는 기본 인증 프로토콜에 지정된 대로 "권한 부여" 헤더가 포함되어야 합니다.
웹 서비스 요청은 비대화형이므로 요청 중에 Authorization 헤더가 항상 필요합니다.
모든 요청과 함께 기본 인증 정보를 제공하면(필요한지 여부와 상관없이) 기본 인증 자격 증명에서 제공된 사용자가 웹 서비스 호출과 연관될 수 있다는 추가적인 이점이 있습니다. 예를 들어 인시던트 기록을 만들 때 저널 필드에는 기본 게스트 사용자 대신 기본 인증 헤더에 포함된 사용자 ID가 나열됩니다.
SOAP 보안 정책
- 외부 웹 서비스를 이용할 때 SOAP 요청 서명 사용 또는 사용 안 함
- WS-Security를 통해 통신할 때 SOAP 요청이 충족해야 하는 인증 요구사항을 지정하십시오.
SOAP 액세스 정책에 대한 자세한 내용은 SOAP API 액세스 정책을 참조하세요.
서명된 SOAP 요청에 필요한 인증서
WS-Security 통신에 대한 SOAP 요청에 서명하려면 다음 인증서가 필요합니다.
- 요청자의 X.509 인증서
- 요청자의 인증서에 서명한 인증 기관의 X.509 CA 인증서
SOAP 기본 보안 정책
관리자는 시스템 속성 glide.soap.default_security_policy와 함께 인스턴스가 사용하는 SOAP 보안 정책을 지정할 수 있습니다. glide.soap.default_security_policy 시스템 특성은 인바운드 요청에 대해 WSS(Web Services-Security)를 적용할 때 인스턴스가 사용하는 SOAP 보안 정책의 이름을 지정합니다.
| 필드 | 설명 |
|---|---|
| 유형 | 문자열 |
| 기본값 | 기본 보안 정책 |
| 위치 | 시스템 속성 [sys_properties] 테이블에 시스템 속성 추가 |
WS-Security
- SOAP 메시지가 알려진 보낸 사람으로부터 시작되었는지 확인
- SOAP 메시지가 전송 중에 변경되지 않았는지 확인
WS-Security는 기본 인증과 함께 사용하기 위한 것입니다. 인스턴스가 SOAP 메시지를 받으면 기본 인증 헤더를 검토하여 SOAP 사용자에게 인스턴스에 대한 권한이 있는지 확인합니다. WS-Security 헤더를 검토하여 수신 메시지의 유효성을 판별합니다. 메시지 가로채기(man-in-the-middle) 공격과 같은 공격의 영향을 받는 요청에는 잘못된 WS-Security 헤더가 있어 차단됩니다.
WS-Security 프로파일
WS 보안 프로파일은 WS 보안이 사용 가능할 때 웹 서비스 메시지가 인증되는 방법을 판별합니다. 다음 메커니즘을 사용하여 웹 서비스 요청을 인증할 수 있습니다.
| 인증 메커니즘 | 설명 |
|---|---|
| 인증서 검증 | 요청과 관련된 인증서를 확인합니다. 요청의 인증서를 확인하려면 요청자의 인증서와 인증 기관을 업로드해야 합니다. |
| 사용자 자격 증명 | 요청과 관련된 사용자 자격 증명을 확인하여 웹 서비스 요청을 인증합니다. 이 유형의 인증은 요청의 자격 증명이 기존 사용자의 자격 증명과 일치하는지 또는 요청의 자격 증명이 프로파일 레코드에 제공된 사용자 이름 및 암호와 일치하는지 확인할 수 있습니다. |
WS-Security 프로파일 모듈은 현재 적용 중인 WS-Security 프로파일을 나열합니다.
WS-Security 오류 로깅
glide.processor.debug.SOAPProcessor 시스템 속성을 사용하면 WS 보안에 대한 오류 메시지를 트랜잭션 로그에 표시할 수 있습니다.
시스템 속성 glide.processor.debug.SOAPProcessor 는 인증서 및 키 저장소 검사와 같은 SOAP 처리를 위한 디버깅 메시지를 사용 또는 사용 안함(예)으로 설정(아니오)합니다.
| 필드 | 설명 |
|---|---|
| 유형 | 예 | 아니오 |
| 기본값 | 아니오 |
| 위치 | 시스템 속성 [sys_properties] 테이블에 시스템 속성 추가 |
WSS X.509 토큰 프로파일
- 주체 이름
- 발급자 이름
- serial number
- 유효 간격
웹 서비스 보안: SOAP 메시지 보안 스펙에 정의된 대로 X.509 인증 프레임워크를 사용하십시오.
인증서를 업로드하고 X509 인증서 필드에서 참조합니다. 바인드된 세션인 경우, WS-Security 인증이 성공할 때 가장할 사용자를 선택하십시오.
WSS 사용자 이름 토큰 프로파일
X.509 토큰 프로파일을 지정할 때 SOAP 요청에서 UsernameToken을 제공할 수도 있습니다.
UsernameToken은 "사용자 이름"으로 요청자를 식별하는 수단으로 사용되며, 필요에 따라 암호, 공유 암호 또는 이에 상응하는 암호를 사용하여 해당 ID를 인증합니다.
UsernameToken을 인증하는 방법에는 두 가지가 있습니다.
- 기존 사용자 자격 증명으로 인증합니다.
그림 5. 기존 사용자 자격 증명으로 인증 수신 SOAP 요청의 사용자 이름을 사용하여 UserName 값과 일치하도록 지정된 사용자 필드로 사용자를 찾습니다. 시스템은 수신 UsernameToken의 암호 값을 사용하여 요청을 인증합니다. 세션 바인딩 옵션을 선택하면 성공적으로 인증하는 사용자가 세션 에 사용됩니다.
- 지정된 사용자 자격 증명으로 인증합니다.
그림 6. 지정된 사용자 자격 증명으로 인증 사용자 테이블의 사용자와 관련 없는 로그인 자격 증명을 사용하여 인증합니다. 세션 바인딩 옵션을 선택하면 사용자로 실행 필드에 지정된 사용자가 세션에 사용됩니다.
웹 서비스에 대한 엄격한 보안
기본적으로 웹 서비스에 대한 기본 인증은 사용자가 SOAP 연결을 사용하여 인스턴스에 액세스할 수 있는 권한이 있는지 여부만 결정합니다. 권한이 부여되면 모든 사용자가 웹 서비스로 게시된 모든 테이블에 액세스할 수 있습니다.
시스템 특성 수신 SOAP 요청에 엄격한 보안 적용은 이 동작을 변경하며, 사용자가 웹 서비스에서 인스턴스 자원에 액세스하려면 Contextual Security Manager 요구사항을 충족해야 합니다.
이 특성을 사용하면 적절한 SOAP 역할을 가지며 테이블과 작업의 ACL 조건을 충족하는 사용자만 SOAP 연결에서 해당 작업을 수행할 수 있습니다.
웹 서비스에 대한 상호 인증
아웃바운드 웹 서비스에 대해 상호 인증이 지원됩니다.
SOAP 세션 관리 및 보고
SOAP 세션은 웹 서비스 클라이언트 애플리케이션, ServiceNow MID Server 또는 ServiceNow ODBC 드라이버와 같은 외부 SOAP 클라이언트에 의해 인스턴스로 설정된 Glide 세션입니다. SOAP 세션은 다음의 사용자 세션 목록에 포함됩니다. . 이 ? SOAP URL은 SOAP 세션을 식별합니다.
SOAP 세션 속성
특정 특성은 SOAP 세션의 유지보수 방법을 제어합니다.
| 속성 | 설명 |
|---|---|
| glide.soap.invalidate_session_timeout | 활성 세션이 열린 상태로 유지되는 기간(초)입니다. 이 지속 시간에 도달하면 인스턴스가 세션을 비활성화하고 모든 시스템 자원을 회수합니다. 제한 시간에 도달한 후 클라이언트가 다른 요청을 보내면 인스턴스가 새 세션을 설정합니다. 이 속성에는 5초에서 1200초(20분) 사이의 값을 사용할 수 있습니다.
|