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?
- Accessing the DKDM Dialog
- Uploading a DKDM
- Viewing DKDMs
- Downloading a DKDM
- Deleting a DKDM
- Troubleshooting
- Glossary
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:
- Open a Project from the Dashboard
- Go to the Works tab
- Select a Master (e.g., "Kiss And Test")
- Select a Version (e.g., "KDM-TEST-01")
- In the Media Pool, find the encrypted DCP row
- Click the ... menu on the DCP row
- 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
| Result | Message |
|---|---|
| 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.
| Column | Description |
|---|---|
| DKDM | CPL URN identifier (hover for full URN) |
| Valid From | Start date of the DKDM validity |
| Valid To | End date (shown in red if expired) |
| Uploaded | Date 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."
| Result | Message |
|---|---|
| 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
| Term | Definition |
|---|---|
| DKDM | Distribution KDM — a master XML key that authorizes a platform to generate device-specific KDMs |
| DCP | Digital Cinema Package — encrypted film content delivered to cinemas |
| CPL | Composition Playlist — identifies a specific version of the content within a DCP |
| CPL URN | Unique identifier for a CPL (e.g., urn:uuid:9ccb10e5-...) |
| KDM | Key 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
Feedback sent
We appreciate your effort and will try to fix the article