DKDM management

Modified on Sat, 28 Feb at 7:12 PM

This guide explains how to manage DKDMs (Distribution KDMs) in Mnemonica — uploading, viewing, downloading, and deleting the master keys that enable KDM generation for encrypted DCPs. Looking for the KDM management guide?


This guide is intended for Project Managers. The DKDM management features are only available to users with the Manager role.


TABLE OF CONTENTS


What is a DKDM?

A Distribution KDM (DKDM) is a master encryption key in XML format that authorizes the Mnemonica platform to generate device-specific KDMs for an encrypted DCP. Without a DKDM uploaded for a given DCP, the platform cannot produce KDM deliveries for that content.

DKDMs are the upstream prerequisite for KDM generation. You upload DKDMs here (per asset); the KDM Distribution module then uses them to generate playback keys for specific projectors.


Accessing the DKDM Dialog

DKDM management lives inside the Works module, not the KDM module. To access it:

  1. Open a Project from the Dashboard
  2. Go to the Works tab
  3. Select a Master (e.g., "Kiss And Test")
  4. Select a Version (e.g., "KDM-TEST-01")
  5. In the Media Pool, find the encrypted DCP row
  6. Click the ... menu on the DCP row
  7. Select Manage DKDMs


The "Manage DKDMs" menu item only appears for encrypted DCP packages and only for users with the Manager role on the project.


Identifying Encrypted DCPs

Encrypted DCP rows show indicator icons in the media pool. The DKDM count badge shows how many DKDMs are currently uploaded for that asset (0, 1, etc.).


Uploading a DKDM

The dialog behavior depends on whether DKDMs already exist for the asset.

First Upload (Empty State)

When no DKDMs exist, the dialog shows a drag-and-drop upload zone. Drag an .xml file onto the zone, or click to browse. Only .xml files are accepted.

Subsequent Uploads

When DKDMs already exist, a compact Upload DKDM button appears above the table. Click it to open the file browser.


Upload Feedback

ResultMessage
Success"DKDM uploaded successfully"
Wrong format"Please select a valid .xml file"
API error"Failed to upload [filename]"
Read error"Failed to read [filename]"


Viewing DKDMs

After uploading, the dialog shows a sortable table. The asset name is displayed at the top of the dialog with a DCP icon. Default sort: most recently uploaded first.


ColumnDescription
DKDMCPL URN identifier (hover for full URN)
Valid FromStart date of the DKDM validity
Valid ToEnd date (shown in red if expired)
UploadedDate the DKDM was added to the platform


Downloading a DKDM

Click the ... menu on any DKDM row and select Download. The XML file downloads to your local machine.


Deleting a DKDM

Click the ... menu on any DKDM row and select Delete. A confirmation dialog appears: "Delete DKDM "[CPL URN]"? This action cannot be undone."


ResultMessage
Success"DKDM deleted"
Error"Failed to delete DKDM"
Deleting a DKDM removes the platform's ability to generate new KDMs for this content. Existing KDMs already delivered remain valid until their expiration.


Troubleshooting

"Manage DKDMs" not visible in the menu

You must have the Manager role on the project, and the asset must be an encrypted DCP (not a plain DCP or other media type).


Content not appearing in the KDM wizard

After uploading a DKDM, the corresponding CPL should appear in the KDM wizard's Content step. If it does not: verify the DKDM was uploaded successfully (check the dialog table); confirm the DKDM is not expired (the Valid To date should be in the future); the CPL list may take a moment to refresh.


"Please select a valid .xml file"

Only .xml files are accepted. Ensure your DKDM file has the correct extension.


Expired DKDM (red date)

An expired DKDM (Valid To date in the past, shown in red) can no longer be used to generate KDMs. Upload a new DKDM with valid dates from your content provider.


Glossary

TermDefinition
DKDMDistribution KDM — a master XML key that authorizes a platform to generate device-specific KDMs
DCPDigital Cinema Package — encrypted film content delivered to cinemas
CPLComposition Playlist — identifies a specific version of the content within a DCP
CPL URNUnique identifier for a CPL (e.g., urn:uuid:9ccb10e5-...)
KDMKey Delivery Message — device-specific decryption key generated from a DKDM

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article