웹 서비스 API를 사용하여 MID 서버에 이벤트 밀어넣기
이벤트 메시지를 MID 서버로 밀어넣는 URL 메서드를 제공하도록 MID WebService 이벤트 수집기를 구성합니다.
http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/jsonv2 JSON v2 형식은 클라이언트가 이벤트 메시지를 인스턴스에 보내는 데 사용하는 형식과 같습니다. 이 URL은 우수한 성능을 제공합니다.
자세한 내용은 MID WebService 이벤트 수집기 컨텍스트 구성 문서를 참조하십시오.사용자 지정 페이로드를 밀어넣을 URL
MID 서버는 JSON, XML 또는 일반 텍스트 형식의 사용자 지정 페이로드를 수신할 수도 있습니다. 이 경우 MID 서버는 사용자가 제공한 스크립트 포함을 사용하여 이벤트 메시지를 변환한 다음, 인스턴스로 이벤트를 보냅니다. 이 경우 URL은 다음과 같습니다.
http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform={Transform_script_name} 스크립트 포함 예시를 보려면 기본 TransformEvents_xmlSample 스크립트 포함을 참조하십시오. MID WebService 이벤트 수집기가 JSON 형식의 이벤트 메시지를 변환하는 방식의 예는 BMC TrueSight 및 BMC TrueSight_v2에서 이벤트 수집 문서를 참조하십시오.
이벤트를 일반 JSON 형식으로 보내기 위해 다음 형식으로 URL을 사용할 수 있습니다.
http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform=TransformEvents_MidJsonGeneric
이 경우 기본 인스턴스에 제공된 TransformEvents_MidJsonGeneric MID 스크립트 포함이 이벤트 메시지를 이벤트 필드로 변환합니다. 모든 필드는 생성되는 ServiceNow 이벤트에 추가 정보 필드로 추가됩니다.
http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/{transform_script_name} 형식의 URL도 지원됩니다.연결 확인을 위한 REST API URL은 http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/ping입니다.
수집된 이벤트를 변환하기 위한 스크립트 포함
필요한 MID 서버 스크립트 포함을 사용하여 수집된 이벤트 메시지를 변환(구문 분석)하고 매핑된 이벤트 필드에 채웁니다. MID 서버 스크립트 포함 이름은 프리픽스와 서픽스로 구성됩니다. 프리픽스는 필수 텍스트 TransformEvents_이며 서픽스는 URL에서 변환된 이름(예: http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/xmlSample )입니다. 이렇게 구성된 스크립트 이름은 TransformEvents_xmlSample입니다.
텍스트 변수에 이벤트 메시지를 수신하는 스크립트 포함을 제공해야 합니다. 이 스크립트에는 변환을 수행하고 이벤트 객체의 반환 배열을 준비하는 transform() 함수가 있어야 합니다. 이벤트 관리 플러그인이 활성화되면 XML 형식의 이벤트를 변환하는 TransformEvents_xmlSample 샘플 포함 스크립트가 제공됩니다.
이벤트 메시지 헤더
이벤트 메시지의 형식에 따라 컨텐츠-형식 필드에 관련 요청 헤더 값을 지정합니다.
| 메시지 형식 | 컨텐츠-형식 값 |
|---|---|
| JSON | application/json |
| XML | application/xml |
| 텍스트 | text/plain |
인증 및 데이터 보안 옵션
인증 및 데이터 보안 옵션:- 인증 유형: API 키 또는 기본으로 설정할 수 있습니다.
- 보안 연결: 전송 시 수신 및 발신 데이터에 보안을 적용할지 선택할 수 있습니다. 고급 보안 옵션을 선택하면 잘 알려진 인증 기관에서 인증서를 얻은 다음, 키 저장소 인증서 별칭 및 키 저장소 암호를 입력해야 합니다.
- 암호화 보호를 제공하고 MID 서버 통합 키 저장소에 사용자 지정 인증서를 설치할 수 있는 MID 통합 키 저장소를 사용합니다. 자세한 내용은 MID 서버 통합 키 저장소에 사용자 지정 인증서 설치를 참조하십시오.
- 사용자는 텍스트 변수에 JSON, XML 또는 텍스트 형식의 이벤트 메시지를 수신하는 스크립트를 제공해야 합니다. 이 스크립트에는 변환을 수행하고 이벤트 객체의 반환 배열을 준비하는 transform() 함수가 있어야 합니다. 이벤트 관리 플러그인이 활성화될 때 XML 형식의 이벤트를 변환하는
TransformEvents_xmlSample포함 스크립트가 예시로 제공됩니다.