# Event Forwarding Exclusions

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**

<details>

<summary><mark style="color:blue;">POST</mark> /v1/vhosts/{vhost}/apps/{app}:setEventForwardPolicy</summary>

**Header**

```http
Authorization: Basic {credentials}

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

**Body**

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

</details>

> **Response**

<details>

<summary><mark style="color:blue;">200</mark> Ok</summary>

The request has succeeded

**Header**

```http
Content-Type: application/json
```

**Body**

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

</details>

<table><thead><tr><th width="154">Parameter</th><th width="159.5555419921875" align="center">Input Type</th><th>Description</th></tr></thead><tbody><tr><td><code>dropEvent</code></td><td align="center">Array</td><td><p>Event Forading 시, 제외할 Event Format(s)을 지정합니다.</p><ul><li><code>amf</code>, <code>scte35</code>, <code>id3v2</code>, <code>webvtt</code>, <code>cue</code>, <code>oven_event</code></li></ul></td></tr></tbody></table>

{% hint style="warning" %}
User가 REST API나 `EventGeneration` XML 설정을 통해 직접 생성한 Event는 위설정과 무관하게 전송됩니다.
{% endhint %}

### Event Forwading 조회하기

> **Request**

<details>

<summary><mark style="color:blue;">GET</mark> /v1/vhosts/{vhost}/apps/{app}:EventForwardPolicy</summary>

**Header**

```http
Authorization: Basic {credentials}

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

</details>

> **Response**

<details>

<summary><mark style="color:blue;">200</mark> Ok</summary>

The request has succeeded

**Header**

```
Content-Type: application/json
```

**Body**

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

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ovenmediaengine-enterprise.gitbook.io/guide/ko-kr/features/workflow-integration-and-external-system-connectivity/event-forwarding-exclusions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.