Kollus DRM Content Service Flow

Notice

This document is a machine-translated draft and is currently undergoing review. Some content may be inaccurate or differ from the original Korean version. For the most precise information, refer to the Korean documentation.

This guide describes the entire process for distributing and playing back content with Kollus DRM applied. Refer to the service flow below when operating secure content.

Learn More

For detailed information on content encryption (DRM), refer to the documents below.

• Content Encryption (DRM)

---

Core process summary

1. Secure upload: The customer administrator sends the content file to the Kollus upload server. (Selecting the [Encryption] option is required)
2. Poster extraction: After the upload is complete, the system extracts a poster (representative image) to be displayed on the player's initial screen.
3. Transcoding: An encoding process is performed to convert the content to the optimal resolution and bitrate for the playback environment. The customer administrator can check the progress status in [Library] on the Kollus VOD console.
4. Content encryption (Kollus DRM): The media data is encrypted (packaged) using Kollus's proprietary security standard. This is an essential step for preventing unauthorized copying and leakage, and content that has been encrypted can only be securely played back through select Kollus Players.
5. Thumbnail extraction: The system extracts thumbnail images to be used for preview in the player's progress bar.
6. Upload file key issuance: Upon completion of transcoding and encryption, the system issues an upload file key for identifying the content.
7. Channel registration and media content key issuance: When the customer administrator registers content to a specific channel, the system issues a media content key, which is the distribution identifier.
8. Playback URL creation and verification: The customer administrator combines the media content key and security token to create a Playback URL(S-link). The final check for normal playback of the content is performed via the generated URL.

---

Tutorial

Step 1: sign in to the Kollus VOD console

Go to the Kollus VOD console and sign in.

Step 2: secure upload

In the [Library] menu that appears after signing in, you can manage content files and classify them by category.

1. Click [Content upload] in the upper right corner of the screen.
   
2. Select [Encryption] from the upload options. Encryption settings can only be configured at the time of upload and cannot be changed after the upload is complete.
3. Drag and drop the file into the upload area or click [Select file] to select a file.
   • Emoji restriction: Files cannot be uploaded if the file name contains emojis.
   • Supported file extensions: Only the following extensions can be uploaded. Files with unsupported extensions may be excluded from the upload list or fail to upload.
     • Video: .3gp, .asf, .avi, .dv, .flv, .webm, .m4v, .mov, .mp4, .mpeg, .mpg, .wmv, .3g2, .3gpp, .f4v, .m2v, .ogm, .ogv, .wm
     • Audio: .aac, .flac, .m4a, .mp3, .ogg, .wav, .amr, .wma
   • Maximum upload count: You can select up to 20 files at a time. To upload 21 or more files, use Kollus Uploader.
4. When the upload is complete, the system automatically starts Transcoding.
   • Transcoding: An essential process that converts the original video to the optimal resolution and bitrate for various viewing environments.
   • Progress status: Can be checked via the percentage (%) displayed above the content poster.
     
   
5. When all tasks are complete, a lock icon is displayed in the lower right corner of the poster image.
   

Step 3: create a channel

To deliver transcoded content, you must first create a channel. It serves as the fundamental unit for content distribution, allowing you to configure independent security and playback policies.

1. Select [Channel] from the left menu.
   
2. Click [Add channel] in the channel list or in the upper right corner.
   
3. Configure each item and click [Save]. (Since this guide is for testing secure URL playback, select [Use as encrypted content-only channel].)

   Item	Description
   Channel name	Channel identification name (emojis cannot be entered)
   Description	Enter the purpose or management objective of the channel
   Channel settings	[Use as shared channel]: Provides URL and embed code for external distribution [Use as encrypted content-only channel]: Dedicated to content with Kollus DRM applied (Learn More: Content Encryption (DRM))
   Delivery method	Streaming and file delivery specifications (Encrypted content-only channels support Progressive Download only.) [Progressive Download]: Sequential download method (for low-spec environments) [HLS]: Automatically optimizes video quality based on network conditions [HLS (AES-128)]: Enhanced security (adds AES-128 encryption layer)
   Security settings	[Block playback when manipulating video watermark]: Immediately blocks playback when watermark tampering is detected

Step 4: register content

Register content to the created channel.

1. In the channel list, click the channel name > [More options (⋮)] > [Add content to channel], or click the channel card > [Add content to channel] in the upper right corner.
   
2. Select the content to register and click [Add].
   
3. Upon registration, a unique media content key is issued for each piece of content. This key is used as the distribution identifier per channel.
   

Step 5: generate a JWT

Encrypted content adopts JWT(JSON Web Token)-based authentication and playback authorization verification to maximize security.

Various security and convenience features such as watermarks, subtitle settings, and playback controls can be defined in the JWT Payload. The required Payload configuration for Kollus DRM content playback is as follows.

{
	"cuid": "{END_USER_ID}",
	"expt": 1703980800,
	"mc": [{
		"mckey": "{MEDIA_CONTENT_KEY}"
	}]
}

Option	Type	Description
cuid	string	User ID This is the reference value for concurrent playback prevention, bookmark, and resume settings. It is recommended to use alphanumeric characters. Using Korean or special characters may restrict searching in the prevention log.
expt	integer	JWT expiration date and time (Unix timestamp) Maximum value: 1893455999 (2029-12-31) Even after expiration, content access may be permitted for up to 1 minute to account for server time discrepancies.
mc	array	Array containing information about the content to be played
mckey	string	Media content key

See Also

For identification information used to call the player, refer to the documents below.

• Key/ID information: Authentication and Key Information
• JWT(JSON Web Token) specifications: Unified JWT Specifications

Step 6: configure the secure playback URL

Configure the Playback URL using the secure URL(S-link) format so that only authenticated users can call the player.

Learn More

For detailed information on player call methods, refer to the documents below.

• Player Call

Playback URL format

https://v.kr.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_KEY}

Parameter details

Parameter	Description
jwt	Authentication and security settings token (JWT generated in Step 5)
custom_key	Custom key Where to find: Kollus VOD console > [Service account] > [Custom key]

Step 7: player playback and feature verification

Content with Kollus DRM(Digital Rights Management) applied can only be played in a secure player environment.

Player information

For detailed information on Kollus Players, refer to the documents below.

• Kollus Player Types

Basic player features

The Kollus Player provides the following standard features for a smooth viewing experience.

• Playback speed control: Supports 0.5–2x playback speed
• Navigation features: 10-second interval seeking and loop section
• Convenience features: PIP(Picture-in-Picture) mode support

Player detailed features

The full list of player features is available on the Kollus Player Features page.

---

Next steps

• Managing Content Categories
• Configuring Encoding Profiles
• Learn More About Kollus Player