Nimble Streamer DRM
Digital Rights Management with Widevine, Playready, FairPlay, BuyDRM, EZDRM, PallyCon, Verimatrix
Nimble Streamer supports DRM CENC encryption for MPEG-DASH and HLS with fMP4 container in the following use cases:
- Google Widevine™ support to protect MPEG-DASH.
- Microsoft Playready™ support to protect MPEG-DASH.
- Apple FairPlay™ support to protect HLS.
- All encryption works for H.264/AVC and H.265/HEVC codecs.
- Widevine Cloud Service support with key rotation.
- BuyDRM KeyOS support for Widevine, FairPlay and Playready.
- EZDRM DRM-as-a-Service support for Widevine, FairPlay and Playready. Read the introduction blog post.
- PallyCon support for Widevine, FairPlay and Playready. Read introduction blog post about our collaboration.
- Verimatrix VCAS CPIX multi-DRM support for Widevine, FairPlay and Playready.
Nimble supports DRM in the following scenarios:
- Encrypting live streaming output based on any input.
- DVR encryption for playback of recorded streams.
- VOD content encryption during playback.
Verimatrix™ VCAS CEI key management is supported to protect live HLS streams with AES encryption.
It's not supported for DVR and VOD use cases.
Follow these easy steps to start using the DRM feature set:
- Set up Nimble Streamer and register Addenda license.
- Configure DRM using simple drm.conf file on Nimble Streamer server side.
- Test protected streams in your players.
1. Set up Nimble Streamer
1.1 Prerequisites: you need to have the following items to be completed before proceeding with DRM setup.
- You have a proper DRM-enabled player set up and tested so you could test the encrypted streams.
- You signed up for WMSPanel account.
- Latest version of Nimble Streamer was installed and is running.
- SSL is properly set up and tested.
1.2 Set up streaming: create and test your streaming scenario without any encryption first.
Overall you need to make sure you have a separate working test output stream which you'll try to encrypt.
Once you set up DRM as described below, you'll be able to apply it to your production environment.
Watch Nimble Streamer setup for live, DVR and VOD with EZDRM.
2. Subscribe and license
2.1 WMSPanel subscription.
You need to be subscribed for WMSPanel account, at least for basic minimum subscription. So once you made sure Nimble Streamer works with non-encrypted use cases you can follow subscription instructions on your profile page.
2.2 Addenda license.
Nimble Streamer DRM is part of Nimble Streamer Addenda premium package.
You need to subscribe for Addenda package license for each Nimble Streamer server instance where you want to enable DRM.
Use instruction from Addenda page to obtain and register the license.
3. Configure DRM settings
All DRM settings are stored in drm.conf file located at the same location as nimble.conf. E.g. on Linux, you need to create /etc/nimble/drm.conf file.
Just add a few lines, re-start Nimble Streamer and you're all set. You may also apply drm.conf changes by using native API call without Nimble re-start.
3.a General parameters
The config consist of a set of drm{}
blocks, each of them contains settings for specified applications.
Show setup details
Mandatory parameters must be included in every block, they are as follows.
application
defines space-separated list of names of applications where settings will be applied.type
parameter defines the type of a key provider server.keyserver
parameter defines the URL of a key server for specific key provider.
Optional parameters may be used in case when they are needed in specific cases.
By default Nimble Streamer generates unique content IDs itself, but if you need to override them you can use these parameters.
Other parameters are specific to the key provider, they'll be described in each section.
3.b Widevine Cloud Service
Nimble can encrypt content with Google Widevine and use key rotation.
Show setup details
drm {
application = live_wv1 live_wv2 live_wv3
keyserver = https://license.uat.widevine.com/cenc/getcontentkey/widevine_test
type = widevine
widevine_signer = widevine_test
widevine_aes_signing_key = 1ae8ccd0e7985cc0b6203a55855a1034afc252980e970ca90e5202689f947ab9
widevine_aes_signing_iv = d58ce954203b7c9a9a9d467f59839249
}
Mandatory parameters define Widevine-specific behavior:
-
widevine_signer, widevine_aes_signing_key, widevine_aes_signing_iv
Optional parameters describe key rotation:
key_rotation_interval
parameter defines the interval for rotating keys where it's applicable. It's defined in seconds. If it's set to "0", then keys will not be rotated.key_count
parameter defines how many keys will be taken from a key server at once for further rotation.
3.c EZDRM
Nimble can encrypt content with Google Widevine, Apple FairPlay and Microsoft Playready using EZDRM key servers.
Watch step-by-step tutorial showing the setup of Nimble Streamer with EZDRM Widevine for live, DVR and VOD.
Notice that EZDRM resource ID can be specified using content_id parameter.
Show setup details
drm {
application = live_ezdrm
type = ezdrm
user = user@yourcompany.com
password = 12yourpassword34&*@#
}
Mandatory parameters define EZDRM access credentials:
user
is user name in EZDRMpassword
is that user's password
3.d BuyDRM KeyOS
Nimble can encrypt content with Google Widevine, Apple FairPlay and Microsoft Playready using BuyDRM KeyOS.
Show setup details
drm {
application = live_keyos
type = keyos
keyos_user_certificate_file = /home/user/keyos/conf/keyos_user.crt
keyos_user_key_file = /home/user/keyos/conf/keyos_user.key
}
Mandatory parameters define KeyOS access credentials:
keyos_user_certificate_file
is an end user's public x509 certificatekeyos_user_key_file
is an end user's x509 private key file
Optional content IDs. You may set content_id and content_ids parameters like in other cases but they must be set in UUID format, e.g.
content_id = 2193eb5b-544b-1234-abcd-1e94b0f778b8
3.e PallyCon
Nimble can encrypt content with Google Widevine, Apple FairPlay and Microsoft Playready using PallyCon key servers.
Show setup details
drm {
application = live_pally
type = pallycon
pallycon_kms_token = yourtoken
}
Mandatory parameter define access token:
pallycon_kms_token
is a token for acessing PallyCon
3.f Verimatrix VCAS CPIX
Nimble can encrypt content using Verimatrix multi-DRM with Widevine, Playready and FairPlay.
Show setup details
drm {
application = live_vcas
keyserver = http://key_server_ip:8058
type = vcas_cpix
}
Optional parameters may be used in case when they are needed in specific cases.
3.g Verimatrix VCAS CEI
Nimble can encrypt HLS content with AES encryption using Verimatrix VCAS key servers.
Show setup details
drm {
application = live_vcas
keyserver = http://key_server_ip:8058
type = vcas_cei
}
Verimatrix allows using key rotation, it's optional:
key_rotation_interval
parameter defines the interval for rotating keys where it's applicable. If it's set to "0", then keys will not be rotated.key_count
parameter defines how many keys will be taken from a key server at once for further rotation.
Verimatrix has other optional parameters like this one:
vcas_encoder_token
parameter defines the token for certain cloud scenarios.
3.h HLS AES-128 encryption
Nimble can make per-application HLS AES encryption of HLS content.
Show setup details
drm {
application = live_aes
type = hls_aes128
key = 78E9A33351234FBDD0EF6C233B310F55
}
This feature has optional parameter:
key_url
parameter defines the URL for key if it's not handled by Nimble Streamer.
4. Test encrypted streams and troubleshoot
Once you re-start Nimble Streamer, you may use your player to test the encrypted live stream to make sure the setup is correct. On Android, you may use Larix Player free app to play content encrypted via MPEG-DASH with Widevine and PlayReady in live, DVR and VOD modes.
Make sure you use SSL for your streams' playback.
If the stream doesn't play then disable corresponding DRM section in drm.conf and re-start Nimble Streamer instance. This will let you determine if the DRM setup is the root cause of the problem. Notice that you may apply drm.conf changes by using this Nimble native API call.
If you still have issues after making fixes to configuration, contact our support. We'll need your drm.conf file, a live stream to test, and a web page with that stream and DRM-enabled player.