# Web Console Publishing

Web Console Publishing은 OvenMediaEngine Web Console의 Stream 목록, Stream 상세, Event Monitoring 화면를 로그인 없이 외부 사용자와 공유할 수 있도록 하는 기능입니다. Virtual Hsot, Application, Stream을 선택하여 공유할 수 있으며, 권한 설정 및 만료일 지정이 가능하여 공유 링크를 관리할 수 있습니다.

## Web Console Publishing URL 생성 및 관리

WebConsole의 Publishing 화면에서 Web Console Publishing URL을 생성 및 관리 할 수 있습니다.

<figure><img src="https://content.gitbook.com/content/Z6NWzeQyKbSWkDFSGwGx/blobs/1F4vwkmxKaTXGCGQ7HvQ/%ED%8D%BC%EB%B8%94%EB%A6%AC%EC%8B%B1%EB%84%A4%EB%B9%84%EA%B2%8C%EC%9D%B4%EC%85%98.JPG" alt=""><figcaption></figcaption></figure>

1. 화면 우측 상단의 네비게이션을 이용해 Publishing 화면에 진입합니다.

### Publishing URL 생성

Publishing URL을 생성하여 Web Console을 외부에 공유할 수 있습니다. 생성한 URL은 필요에 따라 수정하거나 삭제할 수 있습니다.

<figure><img src="https://content.gitbook.com/content/Z6NWzeQyKbSWkDFSGwGx/blobs/voDMQwrV3BBfIjHbaOzV/%ED%8D%BC%EB%B8%94%EB%A6%AC%EC%8B%B1URL%EC%83%9D%EC%84%B1.JPG" alt=""><figcaption></figcaption></figure>

1. Publishing 화면 상단의 New Publishing 버튼을 클릭해 Publishing URL 생성 다이얼로그를 표시합니다.

<figure><img src="https://content.gitbook.com/content/Z6NWzeQyKbSWkDFSGwGx/blobs/PhNy0u5MFkBimwISoGzB/%ED%8D%BC%EB%B8%94%EB%A6%AC%EC%8B%B1URL%EC%83%9D%EC%84%B1%ED%8C%9D%EC%97%85.JPG" alt=""><figcaption></figcaption></figure>

2. 다이얼로그에 다음 값을 설정하여 Publishing URL을 생성합니다:

<table><thead><tr><th width="120">Field</th><th width="77">Required</th><th>Description</th></tr></thead><tbody><tr><td>Source Ids</td><td>Y</td><td><p>공유 화면에서 접근 가능한  Virtual Host, Application, Stream을 지정합니다. 복수 설정이 가능하며 <code>,</code>로 구분지어 지정합니다. </p><p></p><ul><li><strong>Virtual Hsot</strong>: <code>#{virtual_host_name}</code>형식으로 지정합니다. 지정한 Virtual Host 내 모든 Applicaiton 및 Stream에 접근 가능합니다. </li><li><strong>Application</strong>: <code>#{virtual_host_name}#{app_name}</code>형식으로 지정합니다. 지정한 Application 내 모든 Stream에 접근 가능합니다. </li><li><strong>Stream</strong>: <code>#{virtual_host_name}#{app_name}/{stream_name}</code>형식으로 지정합니다. 지정한 Stream에 접근 가능합니다.</li></ul><p></p><p>예를 들어, <code>#default/app1/stream, #default/app2</code> 로 지정 시, <code>#default/app1/stream</code> Stream과, <code>#default/app2</code> Application 내 모든 Stream을 공유하는 것 입니다.</p></td></tr><tr><td>Description</td><td>N</td><td>Publishing URL 생성 시 기록을 위한 설명을 추가할 수 있습니다.</td></tr><tr><td>Permission</td><td>Y</td><td><ul><li><strong>Read Only</strong>: 외부 사용자는 공유된 화면를 조회만 할 수 있습니다. </li></ul><p></p><ul><li><strong>ReadWrite</strong>: 외부 사용자는 다음 작업이 추가로 가능합니다: </li></ul><ol><li>Stream 목록 화면: Managed Stream 생성/삭제, Scheduled Channel 생성/수정/삭제, Multiplex Channel 생성/삭제.</li><li>Stream 상세 화면: Recording 시작/중지, Push Publishing 시작/중지, (LL)-HLS Dump 시작/중지.</li></ol></td></tr><tr><td>Expiry Date</td><td>Y</td><td>Publishing URL의 유효 기간을 설정할 수 있습니다.</td></tr></tbody></table>

### Publishing URL 관리

<figure><img src="https://content.gitbook.com/content/Z6NWzeQyKbSWkDFSGwGx/blobs/xyhr7eikWHNrDodSGklz/%ED%8D%BC%EB%B8%94%EB%A6%AC%EC%8B%B1URL%EB%AA%A9%EB%A1%9D.JPG" alt=""><figcaption></figcaption></figure>

1. 생성된 Publishing URL 목록과 해당 Publishing URL의 설정 정보를 확인할 수 있습니다.
2. 공유할 Publishing URL을 확인할 수 있습니다.
3. 생성된 Web Console Publishing URL의 설정을 수정할 수 있습니다. 생성시 설정한 `Source Ids`, `Description`, `Permission`, `Expiry Date`를 재설정 할 수 있으며, 공유된 Publishing URL에 즉시 적용됩니다.
4. Publishing URL을 삭제합니다. 공유된 Publishing URL은 즉시 사용 불가능하게 됩니다.

## 외부 공유 모드 Web Console

Publishing URL에 접속하면 외부 공유 모드 Web Console의 Stream 목록 화면이 표시됩니다.

### Stream List 화면

<figure><img src="https://content.gitbook.com/content/Z6NWzeQyKbSWkDFSGwGx/blobs/iYXzmk4tXBuLlleOm5mS/%ED%8D%BC%EB%B8%94%EB%A6%AC%EC%8B%B1%EB%90%9C%EC%8A%A4%ED%8A%B8%EB%A6%BC%EB%AA%A9%EB%A1%9D%ED%99%94%EB%A9%B4.JPG" alt=""><figcaption></figcaption></figure>

* 설정된 Source Ids에 해당되는 Stream 목록이 표시됩니다.
* 설정된 Permission이 `Read Write`인 경우 Managed Stream 생성/삭제, Scheduled Channel 생성/수정/삭제, Multiplex Channel 생성/삭제 기능이 활성화됩니다.

### Stream Details 화면

<figure><img src="https://content.gitbook.com/content/Z6NWzeQyKbSWkDFSGwGx/blobs/gP3nzmOF0bDMeJYaEicX/%ED%8D%BC%EB%B8%94%EB%A6%AC%EC%8B%B1%EB%90%9C%EC%8A%A4%ED%8A%B8%EB%A6%BC%EC%83%81%EC%84%B8%ED%99%94%EB%A9%B4.JPG" alt=""><figcaption></figcaption></figure>

* 설정된 Permission이 `Read Write`인 경우 Recording 시작/중지, Push Publishing 시작/중지, (LL)-HLS Dump 시작/중지 기능이 활성화됩니다.

### Event Monitoring 및 Event Timeline 화면

<div><figure><img src="https://content.gitbook.com/content/Z6NWzeQyKbSWkDFSGwGx/blobs/0f3VhtLUO3x0RQWZmC37/%ED%8D%BC%EB%B8%94%EB%A6%AC%EC%8B%B1%EB%90%9C%EC%9D%B4%EB%B2%A4%ED%8A%B8%EB%AA%A8%EB%8B%88%ED%84%B0%EB%A7%81%ED%99%94%EB%A9%B4.JPG" alt=""><figcaption><p>Event Monitoring</p></figcaption></figure> <figure><img src="https://content.gitbook.com/content/Z6NWzeQyKbSWkDFSGwGx/blobs/wM0SM1jmVCxAb8G6siRc/%ED%8D%BC%EB%B8%94%EB%A6%AC%EC%8B%B1%EB%90%9C%EC%9D%B4%EB%B2%A4%ED%8A%B8%ED%83%80%EC%9E%84%EB%9D%BC%EC%9D%B8%ED%99%94%EB%A9%B4.JPG" alt=""><figcaption><p>Event Timeline</p></figcaption></figure></div>

* 설정된 Source Ids에 해당되는 Stream의 Event Monitoring (List)이 표시됩니다.

### Access Restriction Error 화면

<figure><img src="https://content.gitbook.com/content/Z6NWzeQyKbSWkDFSGwGx/blobs/CRMchTSGcsOacq4xTClk/%ED%8D%BC%EB%B8%94%EB%A6%AC%EC%8B%B1%EC%A0%91%EA%B7%BC%EC%A0%9C%ED%95%9C%ED%99%94%EB%A9%B4.JPG" alt=""><figcaption></figcaption></figure>

Publishing URL 인증에 실패할 경우 접근 제한 에러 화면이 표시됩니다. Publishing URL 인증 실패는 다음과 같은 경우 발생합니다.

1. 존재하지 않는 Publishing URL로 접근한 경우
2. Publishing URL이 삭제 된 경우
3. `Expiry Date`에 의해 Publishing URL이 만료 된 경우
4. 허용되지 않은 `Source Ids`에 접근한 경우
