Event Forwarding

OvenMediaEngine Enterprise 0.20.1.4-1 버전부터 Event Forwarding 기능을 사용할 수 있습니다.

Event Forwarding 기능은 OvenMediaEngine의 특정 Application 단위에서 각종 Event를 다음 처리 단계 (내부 또는 외부)로 전달할지 여부를 결정하는 API입니다. 이를 통해 WebRTC, RTMP, OVT, SRT 등 여러 Provider의 Event가 다음 단계로 전달되는지를 제어할 수 있으며, 주로 보안 강화와 운영 정책 제어 목적으로사용됩니다.

API Interface

제외할 Event Forwarding 설정하기

기본적으로 모든 Event에 대해 Event Forwarding이 허용되어 있습니다. Event Forwarding 시, 특정 Event Format(s) 제외가 필요할 경우 setEventForwardPolicy API를 사용하여 지정할 수 있습니다.

이 정책은 대상 Application 내의 모든 Egress Stream에 적용됩니다.

Request

POST /v1/vhosts/{vhost}/apps/{app}:setEventForwardPolicy

Header

Authorization: Basic {credentials}

# Authorization
Credentials for HTTP Basic Authentication created with <AccessToken>

Body

{
    "dropEvent" : ["amf", "scte35"]
}

Response

200 Ok

The request has succeeded

Header

Content-Type: application/json

Body

{
    "message": "OK",
    "statusCode": 200
}

Parameter	Input Type	Description
dropEvent	Array	Event Forading 시, 제외할 Event Format(s)을 지정합니다. amf, scte35, id3v2, webvtt, cue, oven_event

User가 REST API나 EventGeneration XML 설정을 통해 직접 생성한 Event는 위설정과 무관하게 전송됩니다.

Event Forwading 조회하기

Request

GET /v1/vhosts/{vhost}/apps/{app}:EventForwardPolicy

Header

Authorization: Basic {credentials}

# Authorization
Credentials for HTTP Basic Authentication created with <AccessToken>

Response

200 Ok

The request has succeeded

Header

Content-Type: application/json

Body

{
    "message": "OK",
    "response": {
      "dropEvent" : ["amf", "scte35"]
    }
    "statusCode": 200
}