JSON v2 형식은 클라이언트가 이벤트 메시지를 인스턴스에 보내는 데 사용하는 형식과 같습니다. 이 URL은 우수한 성능을 제공합니다.

사용자 지정 페이로드를 밀어넣을 URL

MID 서버 JSON, XML 또는 일반 텍스트 형식으로 사용자 지정 페이로드를 받을 수도 있습니다. 이 경우 사용자는 MID 서버 사용자가 제공한 스크립트 포함을 사용하여 이벤트 메시지를 변환한 다음, 인스턴스로 이벤트를 보냅니다. 이 경우의 URL은 다음과 같습니다.

MID WebService 이벤트 수집기가 JSON 형식의 이벤트 메시지를 변환하는 방법의 예는 다음 문서를 참조하십시오 BMC TrueSight 및 BMC TrueSight_v2에서 이벤트 수집.

이벤트를 일반 JSON 형식으로 보내려면 다음 형식으로 URL을 사용할 수 있습니다.

http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event? 변환=TransformEvents_MidJsonGeneric

이 경우 기본 인스턴스에 제공된 TransformEvents_MidJsonGeneric MID 스크립트 포함이 이벤트 메시지를 이벤트 필드로 변환합니다. 모든 필드는 생성되는 ServiceNow 이벤트에 추가 정보 필드로 추가됩니다.

연결을 확인하기 위한 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 샘플 포함 스크립트가 제공됩니다.

이벤트 메시지 헤더

이벤트 메시지의 형식에 따라 컨텐츠-형식 필드에 관련 요청 헤더 값을 지정합니다.

인증 및 데이터 보안 옵션

• 인증 유형으로, API 키, mTLS 또는 기본으로 설정할 수 있습니다.
• 보안 연결: 전송 시 수신 및 발신 데이터에 보안을 적용할지 선택할 수 있습니다. 고급 보안 옵션을 선택하는 경우 잘 알려진 인증 기관에서 인증서를 얻은 다음 키 저장소 인증서 별칭 과 키 저장소 암호를 제공해야 합니다.
• 암호화 보호를 제공하고 통합 키 스토어에 사용자 지정 인증서를 설치할 수 있는 MID 통합 키 스토어를MID 서버 사용합니다. 자세한 내용은 MID 서버 통합 키 저장소에 사용자 지정 인증서 설치를 참조하세요.
• 사용자는 텍스트 변수에 JSON, XML 또는 텍스트 형식의 이벤트 메시지를 수신하는 스크립트를 제공해야 합니다. 스크립트에는 변환을 수행하고 이벤트 객체의 반환 배열을 준비하는 transform() 함수가 있어야 합니다. 플러그인이 활성화될 때 이벤트 관리 이벤트를 XML 형식에서 변환하는 TransformEvents_xmlSample 포함 스크립트가 예제로 제공됩니다.